Nativeアプリの作成
Capgo - Live Updates for Capacitor Apps Capgo - __CAPGO_KEEP_1__ アプリ向けリアルタイム更新

はじめに

Capgo Cloud Buildで始めて、iOSまたはAndroidのネイティブビルドを作成できます。

必要なもの

Section titled “必要なもの”

始める前に、以下を確認してください。

  • ローカルで正常にビルドされる Capacitor アプリ
  • Node.js 20 以上がインストールされている
  • Capgo アカウント (無料試用版でも十分)
  • Capgo へのアプリの既存登録 (run npx @capgo/cli@latest app add if not)
  • 手動で署名資格情報を準備する必要はありません — 次のステップで設定します。

署名資格情報の設定

Section titled “署名資格情報の設定”

Capgo はアプリをビルドおよび提出するために署名資格情報が必要ですが、手動で管理する必要はありません。回答するだけの質問があり、正しいコマンドを実行する場所を指示します:

最初のビルドを実行

初めてのビルドを実行する

Capgo に認証されている必要があります。まだしていない場合は:

ターミナル画面
npx @capgo/cli@latest login
# or, in CI, set the token directly:
export CAPGO_TOKEN=your_api_key

直前に実行した build initあなたはすでにセットアップされています — オンボードイングはビルドを開始するように求めますので、最初のビルドがすでに送信されている可能性があります。🎉

そうでない場合は、自分でビルドを開始してください。 build request — を設定します --platform ビルドするものに応じて

ターミナル画面
npx @capgo/cli@latest build request com.example.app --platform <android|ios> --build-mode debug

CLI は、準備されたネイティブプロジェクトをアップロードし、ターミナルでライブビルドログをストリームします。 Capgo ビルドは、適切なリリースフローを設定した場合に署名されたアーティファクトを返すか、App Store Connect または Google Play に提出します。

ビルドプロセスの理解

ビルドプロセスの理解

ビルドコマンドを実行すると、以下のことが行われます。

  1. CIで準備 - ウェブ層のビルド、プライベート依存関係の解決、完了アセットの同期を行います。
  2. アップロード - 準備されたネイティブプロジェクトは、安全なクラウドストレージにアップロードされます。
  3. ビルド実行 - Capgo は、専用インフラでネイティブプロジェクトをコンパイルおよび署名します。
  4. ログストリーミング - リアルタイムログは、サーバーセンターイベントを介してターミナルにストリーミングされます。
  5. クリーンアップ - ビルド環境と一時的なプロジェクトデータはビルド後にクリーンアップされます。出力の保持は選択したアーティファクトとストアデリバリーオプションに依存します。

Use Capgo ビルトリスまたは他のCIを使用

「Use Capgo ビルトリスまたは他のCIを使用」セクション

Capgo ビルトはあなたの既存のCIを置き換えません。ビルトリスまたは他のCIシステムで必要なプライベートアクセスを持つステップを保持してください: プライベートレジストリからインストール、プライベートCocoaPodsをSSH経由で解決、カスタムネイティブセットアップを実行、ウェブレイヤーをビルド、ウェブレイヤーを実行します。 npx cap sync.

Then call Capgo Build with the prepared native project. Capgo receives the ready ios/ または android/ ビルトリスまたは他のCIを使用してビルトを実行します。

ビルトはあなたの既存のCIを置き換えません。ビルトリスまたは他のCIシステムで必要なプライベートアクセスを持つステップを保持してください: プライベートレジストリからインストール、プライベートCocoaPodsをSSH経由で解決、カスタムネイティブセットアップを実行、ウェブレイヤーをビルド、ウェブレイヤーを実行します。

ビルトはあなたの既存のCIを置き換えません。ビルトリスまたは他のCIシステムで必要なプライベートアクセスを持つステップを保持してください: プライベートレジストリからインストール、プライベートCocoaPodsをSSH経由で解決、カスタムネイティブセットアップを実行、ウェブレイヤーをビルド、ウェブレイヤーを実行します。

Capgo Build receives the prepared native project required to compile your app. Your web source code, private dependency installation, and Capacitor sync remain in your CI.

ビルトはあなたの既存のCIを置き換えません。ビルトリスまたは他のCIシステムで必要なプライベートアクセスを持つステップを保持してください: プライベートレジストリからインストール、プライベートCocoaPodsをSSH経由で解決、カスタムネイティブセットアップを実行、ウェブレイヤーをビルド、ウェブレイヤーを実行します。

アップロードされるもののリスト
含まれる説明
ios/ または android/Capacitorライブアップデートの代替
package.json, package-lock.jsonCapacitorライブアップデートの代替
capacitor.config.*Capacitor configuration
resources/Capacitorライブアップデートの代替
Native plugin codeCapacitorライブアップデートの代替 ios/ Capacitorライブアップデートの代替 android/ subfolder of each Capacitor plugin

アップロードされていないもの

「アップロードされていないもの」のセクション
除外なぜ
node_modules/ (ほとんど)code のネイティブ プラグインのみが含まれており、JS の依存関係は含まれていません
src/code のウェブ ソースはローカルに残ります
dist/, www/, build/ (root level)バージョン管理の履歴 cap sync
.git/ビルド キャッシュと IDE の設定
.gradle/, .idea/, .swiftpm/, 秘密情報
.env, secretsアップロードされていない

あなたの責任

セクション「あなたの責任」

実行する前に npx @capgo/cli@latest build request:

  1. CIで準備する - Bitriseまたは既存のCIで、プライベートパッケージレジストリ、SSHベースのCocoaPods、デバイスSDK、拡張機能、およびカスタムネイティブの準備を解決する
  2. - Run - npm run build (またはあなたのフレームワークのビルドコマンド)
  3. Sync to native - Run npx cap sync を実行して、コンパイルされたWebアセットを用意されたネイティブプロジェクトにコピーします。
  4. Request the native build - 送信された用意された ios/ または android/ プロジェクトをCapgo Build.

What Capgo Build Handles

セクション「What Capgo Build Handles」
  • ネイティブiOSのコンパイル(Xcode, Fastlane)
  • ネイティブAndroidのコンパイル(Gradle)
  • Code の署名にあなたの資格情報を使用します。
  • App Store Connect または Google Play の提出は任意です。
  • サポートされているネイティブビルド構成と資格情報は環境変数として渡されます。

Capgo ビルドにはあなたのプライベート Nexus レジストリまたは SSH 資格情報へのアクセスが必要ありません。CI がネイティブプロジェクトを用意した後です。詳しくは ビルド構成 を参照してください。サポートされている環境変数とストアオプションについてもご覧ください。

MDM から配布されるキオスク用のアプリケーションを構成するには、Android プロジェクト/ビルドを APK を生成するように設定します。ビルドを要求する際には、Google Play をスキップし、署名済みの出力を取得するために両方のフラグを使用します。

ターミナルウィンドウ
npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload

--no-playstore-upload Play Store のアップロードを防止します。Play 資格情報が保存されている場合でも。 --output-upload 署名済みの出力への時限付きリンクを提供します。MDM からその APK を配布します。

次のステップ

Section titled “Next Steps”

最初のビルドを作成しました。

  • iOS ビルドの設定 - 証明書とプロファイルの設定
  • Android ビルドの設定 - キーストアとPlayストアの設定
  • トラブルシューティング コンテキスト: サポート / プレミアムサポートページまたはフッターのサポートセクション。役割: セクションまたはページヘッダー。見られる場所: サポートポリシーページ。メッセージキー `support_policy_troubleshooting_title` (サポートポリシー トラブルシューティング タイトル)。
  • CLI Reference __CAPGO_KEEP_0__ リファレンス

- 完全なコマンドドキュメント

お困ですか?