Beispielanwendungen und Tools für Gea Stack. Dieses Repo ist die App-Galerie, die vom Simulator, eingebetteten Targets, Gea OS, Apple-Targets, der VS Code/Cursor-Erweiterung und Marketing-Demos verwendet wird. Jedes Beispiel ist ein kleines Paket mit einem gea-Manifest in package.json.

Was hier ist: apps/* Gea-Apps. Die meisten sind TSX-Apps, die auf Web, ESP32 und/oder Gea OS abzielen. apps/*/package.json App-Manifest, Target-Kompatibilität, Skripte und Launcher-Metadaten. tools/dialer-browser Kleines browser-seitiges Hilfstool für Dialer-Workflows. package.json Workspace-Marker für die Beispielsammlung. docs Katalog und Beitragsrichtlinien.

Schnellstart: Führen Sie Checks für ein einzelnes Beispiel aus: cd apps/watch npm install npm run check npm run build. Einige Beispiele enthalten auch Tests, die hauptsächlich ein Layout oder ein Gerätesetup schützen, das sonst nichts abfangen würde -- npm test im App-Ordner führt sie aus. Die Web-Schleife wird vom Simulator gesteuert, der ein separates Repository ist: geastack/simulator. Seine Skripte lesen Apps aus einem App-Projektstammverzeichnis, das sie aus GEA_APPS_ROOT beziehen -- diesem Repo oder Ihrem eigenen. Es gibt keinen Standard, also setzen Sie es oder übergeben Sie --app-dir; nichts geht davon aus, dass die beiden Checkouts nebeneinander liegen. cd /path/to/simulator GEA_APPS_ROOT=/path/to/examples ./targets/web/dev-web.mjs watch # Entwicklungsschleife GEA_APPS_ROOT=/path/to/examples ./targets/web/build-web.sh watch # Build für Web ./targets/web/dev-web.mjs --app-dir /path/to/examples/apps/watch # oder benennen Sie eine App. Flashen Sie ein kompatibles Board über die Gea CLI: npx gea flash watch --board <alias> npx gea flash watch --board <alias> --monitor.

Dokumentation: docs/EXAMPLE-CATALOG.md: Beispielkategorien, Target-Kompatibilität und wie Manifeste verwendet werden. docs/DEVELOPMENT.md: wie man eine Beispiel-App hinzufügt, testet und wartet.

Grundlagen des App-Manifests: Jede baubare App sollte eine package.json mit einem gea-Feld haben: {"gea": {"id": "watch","name": "Watch","entry": "index.tsx","runtime": "gea","targets": {"web": true,"esp32": true,"geaos": true}}}. Das Manifest wird vom Simulator, eingebetteten Board-Skripten, Gea OS, Apple-Targets und der IDE-Erweiterung verwendet. Halten Sie es genau.

Wartungshinweise: Halten Sie Beispiele klein und fokussiert. Ein gutes Beispiel beweist ein Verhalten klar. Bevorzugen Sie gemeinsame Framework-APIs gegenüber target-spezifischen Hacks innerhalb von Beispielen. Fügen Sie Tests für Beispiele mit nicht-trivialer Logik, Physik oder Parsing hinzu. Aktualisieren Sie die Katalogdokumentation beim Hinzufügen, Umbenennen, Verstecken oder Ändern der Target-Kompatibilität einer App.

Lizenz: MIT (siehe LICENSE). Verwenden Sie es, ändern Sie es, liefern Sie Closed-Source-Produkte darauf aus, ohne Bedingungen. Der einzige Gea Stack-Code unter einer anderen Lizenz ist die eingebettete Board-Unterstützung (targets und @geastack/chips, GPL-3.0-only): Das Ausliefern von Closed-Source-Firmware über diese erfordert eine kommerzielle Lizenz. Kontaktieren Sie [email protected] für kommerzielle Bedingungen, Support und gehostete Builds.

Wichtige Entitäten: Unternehmen: Gea Stack, GeaOS, Apple, VS Code, Cursor