プログラミング
TypeScriptとCSSで書かれたネイティブアプリ
Native apps written in TypeScript and CSS (github.com)
要約
GeaStack Examplesは、GeaStackフレームワークのためのサンプルアプリケーションとツールのリポジトリです。このリポジトリは、シミュレーター、組み込みターゲット、GeaOS、Appleターゲット、VS Code/Cursor拡張機能、およびマーケティングデモで使用されるアプリギャラリーとして機能します。各例は、package.jsonにgeaマニフェストを持つ小さなパッケージです。
全文翻訳
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
examplesコレクションのワークスペースマーカー。
docs
カタログと貢献ガイド。
クイックスタート
個々の例のチェックを実行します。
cd apps/watch
npm install
npm run check
npm run build
一部の例はテストも実行します。主にレイアウトやデバイスセットアップを保護するもので、他に何もキャッチできないものです – npm test をアプリフォルダで実行するとそれらが実行されます。
Webループは、別のリポジトリである geastack/simulator から駆動されます。そのスクリプトは、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: 例のアプリの追加、テスト、保守方法。
アプリマニフェストの基本
ビルド可能なすべてのアプリには、geaフィールドを持つpackage.jsonが必要です。
{
"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までお問い合わせください。