SDK rozszerzeń

Rozszerzenia drawtonomy to aplikacje webowe hostowane w iframe, które rozmawiają z edytorem przez postMessage. SDK daje ci typowanego klienta; dev-server daje ci lokalny edytor do rozwoju.

Ta strona to szybkie wprowadzenie. Pełny przewodnik — schemat manifestu, lista zdolności, protokół wiadomości — znajduje się w publicznym repo:

➡ Przewodnik Rozwoju Rozszerzeń (日本語)

Szybki start

# Edytor na :3000
pnpm add -g @drawtonomy/dev-server
drawtonomy-dev-server

# Twoje rozszerzenie na :3001
cd my-extension && pnpm dev --port 3001

open "http://localhost:3000/?ext=http://localhost:3001/manifest.json"

Minimalne rozszerzenie

my-extension/
  manifest.json
  index.html
  src/

manifest.json

{
  "id": "my-extension",
  "name": "My Extension",
  "version": "1.0.0",
  "entry": "./index.html",
  "capabilities": ["shapes:read", "shapes:write", "ui:panel"]
}

src/main.ts

import { ExtensionClient, createVehicle } from '@drawtonomy/sdk'

const client = new ExtensionClient()
await client.ready()

document.getElementById('add')!.addEventListener('click', async () => {
  await client.addShapes([createVehicle(0, 0, { templateId: 'sedan' })])
})

Rozszerzenia referencyjne

Wbudowane rozszerzenia są przykładami pełnej wierności:

• ai-scene-generator — generowanie scen w języku naturalnym i OpenSCENARIO.
• template-preview — podgląd szablonu kształtu.
• exporter-playground — testowanie eksportera względem żywego płótna.
• path-footprint-lab — eksperymentowanie ze Śladem Trasy.

Zobacz także

• Architektura rozszerzeń — dlaczego iframe, dlaczego postMessage.
• Przegląd @drawtonomy/sdk — pakiet i jego moduły.