Gea Stack 的示例应用与工具。此仓库是模拟器、嵌入式目标、Gea OS、Apple 目标、VS Code/Cursor 扩展和营销演示所使用的应用画廊。每个示例都是一个带有 gea 清单的小型包，位于 package.json 中。

这里有什么：apps/* Gea 应用。大多数是面向 web、ESP32 和/或 Gea OS 的 TSX 应用。apps/*/package.json 应用清单、目标兼容性、脚本和启动器元数据。tools/dialer-browser 用于拨号器工作流的小型浏览器端辅助工具。package.json 示例集合的工作区标记。docs 目录和贡献指南。

快速开始：为单个示例运行检查：cd apps/watch npm install npm run check npm run build。一些示例还带有测试，主要用于守护布局或设备设置，这些是其他方式无法捕获的——在应用文件夹中运行 npm test 即可执行它们。Web 循环由模拟器驱动，模拟器是一个单独的仓库：geastack/simulator。其脚本从应用项目根目录读取应用，该根目录取自 GEA_APPS_ROOT——即此仓库，或你自己的仓库。没有默认值，因此请设置它或传递 --app-dir；没有任何假设认为两个检出位于彼此旁边。cd /path/to/simulator GEA_APPS_ROOT=/path/to/examples ./targets/web/dev-web.mjs watch # 开发循环 GEA_APPS_ROOT=/path/to/examples ./targets/web/build-web.sh watch # 为 web 构建 ./targets/web/dev-web.mjs --app-dir /path/to/examples/apps/watch # 或指定一个应用。通过 Gea CLI 烧录兼容的开发板：npx gea flash watch --board <alias> npx gea flash watch --board <alias> --monitor。

文档：docs/EXAMPLE-CATALOG.md：示例类别、目标兼容性以及清单的使用方式。docs/DEVELOPMENT.md：如何添加、测试和维护示例应用。

应用清单基础：每个可构建的应用都应有一个带有 gea 字段的 package.json：{"gea": {"id": "watch","name": "Watch","entry": "index.tsx","runtime": "gea","targets": {"web": true,"esp32": true,"geaos": true}}}。该清单由模拟器、嵌入式开发板脚本、Gea OS、Apple 目标和 IDE 扩展使用。请保持其准确。

维护说明：保持示例小巧且专注。一个好的示例能清晰地证明一种行为。在示例中优先使用共享框架 API，而非特定于目标的技巧。为具有非平凡逻辑、物理或解析的示例添加测试。在添加、重命名、隐藏或更改应用的目标兼容性时，更新目录文档。

许可证：MIT（见 LICENSE）。使用它、修改它、在其上发布闭源产品，没有任何附加条件。唯一采用不同许可证的 Gea Stack 代码是嵌入式开发板支持（targets 和 @geastack/chips，GPL-3.0-only）：通过它们发布闭源固件需要商业许可证。联系 [email protected] 获取商业条款、支持和托管构建。

关键实体：公司：Gea Stack、GeaOS、Apple、VS Code、Cursor

常见问题：geastack/examples 仓库的目的是什么？

geastack/examples 仓库是 Gea Stack 的应用画廊，提供模拟器、嵌入式目标、Gea OS、Apple 目标、VS Code/Cursor 扩展和营销演示所使用的示例应用与工具。

常见问题 Q：geastack/examples 仓库的目的是什么？

常见问题 A：geastack/examples 仓库是 Gea Stack 的应用画廊，提供模拟器、嵌入式目标、Gea OS、Apple 目标、VS Code/Cursor 扩展和营销演示所使用的示例应用与工具。