meteor-native

Meteor ネイティブアプリ

既存の Meteor アプリケーションを再現可能な Cordova ビルドにし、要求されたデバイスまたは配布の動作を検証します。Meteor は Web バンドル、Cordova プロジェクト、プラットフォームのバージョンを管理します。Android Studio と Xcode は、ネイティブのデバッグ、署名、配布に使用するツールを提供します。

ワークフローを選択する

1. .meteor/release、.meteor/platforms、.meteor/cordova-plugins、 .meteor/versions、package.json、および存在する場合は mobile-config.js を読みます。 ホスト OS、対象デバイス／プラットフォーム、インストール済みネイティブバイナリのバージョン、 およびタスクで開発実行、Web アップデート、新しいバイナリのどれが必要かを記録します。
2. 前提条件を、選択した Meteor リリースと解決された Cordova プラットフォームに合わせます。Meteor 3.5.2 は [email protected]、 [email protected]、[email protected] を使用します。それ以前のリリースでは 異なるバージョンが固定されています。利用可能だからという理由だけで、 最新の単体 Cordova プラットフォームを選択しないでください。
3. 以下の該当するリファレンスを選択します。永続的な変更は、アプリの プラットフォーム／プラグイン宣言、設定、アセットに加えます。生成されたネイティブ出力を調べ、 Meteor が実際に生成した内容を確認します。
4. ネイティブプラグイン、プラットフォームのバージョン、権限、ネイティブ設定を変更した場合は、 再ビルドして再インストールします。HCP で互換性のある Web コードやアセットを更新できますが、 不足しているネイティブコードを追加したり、インストール済みバイナリのメタデータを変更したりすることはできません。
5. 対象のエミュレーター／デバイスで検証するか、要求された成果物を調べます。 コマンド、バージョン、エンドポイント、確認できた結果を記録します。Web ビルドが成功しただけでは、 ネイティブアプリや署名済みのストア用成果物の検証にはなりません。

タスク	参照先
Android／iOS のセットアップ、プラットフォームの追加／削除、デバイスでの実行、WebView 互換性の選択	ツールチェーンと開発
アプリのメタデータ／アセット、ネイティブ設定、アクセスルール、プラグイン、権限、ビルドオーバーライドの変更	設定とプラグイン
Android 成果物または iOS プロジェクトのビルド、署名の設定、配布の準備	ビルドと配布
モバイルアップデートの配信、互換性による拒否、ダウンロード、再読み込みの動作を修正	ホットコードプッシュ

永続状態とランタイムの境界

• .meteor/local/cordova-build/ はデフォルトで生成されます。 METEOR_LOCAL_DIR が設定されている場合は、その cordova-build 子ディレクトリを開いたり 消去したりする前に、実際のローカルディレクトリを特定します。Cordova キャッシュの修復に、 ローカル状態全体やローカル Mongo データベースを消去しないでください。
• mobile-config.js はビルド時の設定ファイルであり、アプリケーションのモジュールではありません。 App.configurePlugin はインストール変数を指定しますが、プラグインをインストールしたり、 その JavaScript API を実行したりするものではありません。
• ネイティブプラグインの API は、Meteor.isCordova でガードされたクライアントコードから、 Meteor.startup 内または同等のデバイス準備完了後に呼び出します。Meteor の Cordova 起動処理は deviceready を待機します。ブラウザー／サーバーのコードには、 適切なフォールバックを用意してください。起動しても OS 権限が自動的に付与されるわけではありません。
• 物理デバイスにおける localhost は、そのデバイスを指します。開発時は --mobile-server、配布時は meteor build --server を使用し、到達可能なエンドポイントを指定します。 埋め込み WebView のローカルコンテンツサーバーは、Meteor バックエンドおよび DDP 接続とは別のものです。

隣接するワークフロー

リクエスト	担当
原因が不明なクラッシュ、データの停滞、またはネイティブの動作が原因だとまだ特定されていない障害	meteor-debugging。その後、確認済みのネイティブ境界を添えて戻ってください
バックエンドのホスティング、Galaxy/Docker の設定、サーバーの変更のデプロイ、HCP クライアントバンドルの保持	meteor-deployment
Rspack/SWC/モジュールグラフ、または sharp のようなネイティブ npm アドオン	meteor-modern-build-stack または migrate-to-rspack
OAuth プロバイダー／ログインの動作	meteor-accounts。必要な Cordova プラグインまたはネイティブ設定には、このスキルを使用してください
React Native/Expo または Capacitor を明示的に使用するアプリ	選択したスタックを維持してください。このスキルでは、これらの統合は実装しません

受け入れ

評価ケースを使用して、ネイティブに関する判断、以前のリリースでの動作、隣接スキルへの振り分けを確認してください。