Примеры приложений и инструментов для Gea Stack. Этот репозиторий — галерея приложений, используемая симулятором, встраиваемыми целями, Gea OS, целями Apple, расширением VS Code/Cursor и маркетинговыми демо. Каждый пример — это небольшой пакет с манифестом gea в package.json.

Что здесь есть: apps/* Приложения Gea. Большинство — это приложения TSX, нацеленные на web, ESP32 и/или Gea OS. apps/*/package.json Манифест приложения, совместимость с целями, скрипты и метаданные лаунчера. tools/dialer-browser Небольшой вспомогательный инструмент на стороне браузера для рабочих процессов набора номера. package.json Маркер рабочего пространства для коллекции примеров. docs Каталог и руководство по участию.

Быстрый старт: Запустите проверки для отдельного примера: cd apps/watch npm install npm run check npm run build. Некоторые примеры также содержат тесты, в основном защищающие макет или настройку устройства, которые больше ничто не поймает -- npm test в папке приложения запускает их. Веб-цикл управляется из симулятора, который является отдельным репозиторием: 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: как добавлять, тестировать и поддерживать пример приложения.

Основы манифеста приложения: Каждое собираемое приложение должно иметь package.json с полем gea: {"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 и маркетинговыми демо.

Вопрос