TypeScriptとCSSで書かれたネイティブアプリ

GeaStack Examples

GeaStackのためのサンプルアプリケーションとツール。

このリポジトリは、シミュレーター、組み込みターゲット、GeaOS、Appleターゲット、VS Code/Cursor拡張機能、およびマーケティングデモで使用されるアプリギャラリーです。各例は、package.jsonにgeaマニフェストを持つ小さなパッケージです。

ここにあるもの

| パス | 目的 |
| --- |
| apps/* | Geaアプリ。ほとんどはWeb、ESP32、および/またはGeaOSをターゲットとする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から取得したアプリプロジェクトルートからアプリを読み取ります。GEA_APPS_ROOTは、このリポジトリまたは独自のものです。デフォルトはないため、設定するか--app-dirを渡してください。2つのチェックアウトは隣接している必要はありません。

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   # または1つのアプリを指定

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
    }
  }
}

マニフェストは、シミュレーター、組み込みボードスクリプト、GeaOS、Appleターゲット、およびIDE拡張機能によって消費されます。正確に保ってください。

保守ノート

• 例は小さく、焦点を絞ってください。良い例は1つの動作を明確に証明します。
• 例内のターゲット固有のハックよりも、共有フレームワークAPIを優先してください。
• 非自明なロジック、物理学、または解析を含む例にはテストを追加してください。
• アプリを追加、名前変更、非表示、またはターゲット互換性を変更する際は、カタログドキュメントを更新してください。

ライセンス

MIT（LICENSEを参照）。これに基づいて構築されたクローズドソース製品を配布できます。異なるライセンスの下にある唯一のGeaStackコードは、組み込みボードサポート（targetsおよび@geastack/chips、GPL-3.0-only）です。これらのを通じてクローズドソースファームウェアを配布するには、商用ライセンスが必要です。商用条件、サポート、およびホストビルドについては、contact@geastack.comまでお問い合わせください。