Capacitor-Capacitor-updaterとは
Capacitor-Capacitor-updaterは、ユーザーに即時でアプリの更新と改善を提供するための技術です。
特に、重要なバグ修正を行う場合に、App Storeのレビューを経ることなく即時で更新を提供できることが特に便利です。
これは、更新を即時で利用できるようにすることで、側面ロードの更新の「ウェブのような」迅速さを実現するのと同じです。
さらに、更新がアプリをクラッシュさせる場合でも、ロールバックが可能です。
Capacitor-__CAPGO_KEEP_0__-updaterはどのように動作するのか
Capgo keeps your app’s JavaScript bundle in sync with the Capgo server, and every time the user opens the app, it checks with the Capgo server if a new update is available to the bundle. And of course, it comes with tons of awesome configurations which can help you fine-tune your user’s experience.
I use Capgo in all my projects I build. That allows me to put less time in the App Store review process.
私はCapacitorをすべてのプロジェクトで使用しています。これにより、App Storeのレビュープロセスに時間を費やす必要がなくなります。 それについてはこちらを参照してください.
Capgoを理解する
Capgoは、セマンティックバージョニング（semver）を使用して、更新が適用されるタイミングと方法を決定します。このため、ユーザーは互換性のある更新のみを受け取り、自動的に展開される破壊的な変更が防止されます。
セマンティックバージョニングの形式は次のとおりです MAJOR.MINOR.PATCH:
- メジャーバージョン: 本番アプリのリリースが必要な破壊的な変更
- マイナーバージョン: バックワード互換性のある新機能
- パッチ: バックワード互換性のあるバグ修正
たとえば、バージョンが 1.0.0 であれば、バージョン 1.0.1 (パッチ)にアップデートしたい場合、Capgoは自動的にこのアップデートを適用します。ただし、バージョンからバージョンにアップデートしたい場合 1.0.0 に 2.0.0 (主なバージョン)の場合、破壊的な変更が含まれるため、ネイティブアプリストアのリリースが必要になります。
Capgoのチャンネル設定では、自動適用される更新の種類を設定できます。
- メジャー戦略: すべての更新を許可する (注意してください)
- マイナー戦略: マイナーとパッチの更新のみを許可する
- パッチ戦略: パッチの更新のみを許可する
- メタデータ戦略: 最小バージョン要件を満たすことを要求する
異なるバージョン combination の動作をテストするには、Capgoの更新ロジックを使用できます。 Semver テスター ツールこのツールは、チャンネル設定に基づいてアップデートが適用されるタイミングを理解するのに役立ちます。
制限事項はありますか?
この手法は素晴らしいようですが、注意すべき点がいくつかあります。 最初のことは、OTA アップデートがウェブ バンドルとしか機能しないことです。 ウェブ バンドル以外のアップデートは、OTA を使用して行うことができません。あなたは、Capacitor JS で、ほとんどの code を JS、CSS、HTML で書いていると思います。 しかし、実際にはネイティブ モジュールをアプリにインストールすることがあります。 ネイティブ モジュールがアプリの Android または iOS ディレクトリを変更した場合、OTA を使用してアプリをアップデートすることはできません。 これは、ネイティブ バイナリをコンパイルするために使用されるディレクトリの内容が OTA で更新できないためです。
しかし、CI/CD を設定して、この部分を自動化することができます。 その方法については、ここで紹介しています。 Auto __CAPGO_KEEP_0__ 設定.
アカウントを作成し、Capgo キーを取得して、最初のバージョンをアップロードする準備が整います。 まず、Capgo アカウントを作成してください。
It’s time to sign up, and get your API key to upload your first version! Begin by signing up for a Capgo account.
Once you’re logged into Capgo, You will have an onboarding page
最初のアプリを追加するには、オンボーディングページの手順に従ってください。
CLIのガイダンスに従ってください。
Capacitorのルートディレクトリに移動し、コマンドラインから次のコマンドを実行してください。
npx @capgo/cli@latest init
CapgoをCapacitorアプリにインストールするには、CLIはCapgoを使用してアプリの設定を手助けします。
手動で実行したい場合は、以下の手順に従ってください。
手動Capgo設定
プラグインをインストールします。
このcodeがアプリに追加されるはずです。
npm i @capgo/capacitor-updater && npx cap sync
Capacitorアプリにプラグインをインストールします。
次に、アプリにこのcodeを追加して、JSバンドルが正常であることをnativeプラグインに通知します (これを実行しないと、nativeプラグインは前のバージョンに戻ります)。
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()nativeプラグインにインストールが成功したことを通知します。
Then do a __CAPGO_KEEP_0__ npm run build && npx cap copy アプリを自動的に更新する。
Login to Capgo CLOUD
CapacitorUpdater CLI. all APIキー あなたのアカウントに保存されている情報でログインするには、CLIを使用してください。
npx @capgo/cli@latest login YOU_KEY
アプリを追加してください
Let’s get started by first creating an app in Capgo Cloud with the CLI.
npx @capgo/cli@latest app add
このコマンドは、指定されたCapacitorの設定ファイルに定義されているすべての変数を使用してアプリケーションを作成します。
アップロードする最初のバージョン
Capacitorアプリを無問題にアップデートするには、Capacitor Updaterを使用します。
Run the command to build your code and send it to Capgo with:
npx @capgo/cli@latest bundle upload
バージョン名は、デフォルトではあなたの package.json ファイル。
確認する。 Capgo ビルドが存在する場合。
あなたは私のモバイルサンドボックスアプリでテストすることもできます。 デフォルトのチャンネルを設定する。.
あなたのアプリを__CAPGO_KEEP_0__に送信した後、チャンネルをデフォルトに設定する必要があります。
After you have sent your app to Capgo, you need to make your channel default to let apps receive updates from Capgo.
npx @capgo/cli@latest channel set production -s default
アプリを開き、バックグラウンドに置き、再度アプリを開きます。ログに表示されるのは、アプリがアップデートを実行したことです。
デバイスでライブアップデートを受け取る
npx cap run [ios | android]デバイスでライブアップデートを受け取る
おめでとう！🎉あなたは最初のライブアップデートを成功的にデプロイしました。これはライブアップデートのすべてのことができるのはこれからです。ライブアップデートの詳細については ライブアップデートのドキュメント.
ローカルでアップデートを受信しないようにするにはこのコマンドを実行してください
npx @capgo/cli@latest channel set
CapacitorアプリをCapacitor-updaterを使用してスムーズにアップデートする
あなたが__CAPGO_KEEP_0__-updaterを使用している場合 CapacitorアプリをCapacitor-updaterを使用してスムーズにアップデートする __CAPGO_KEEP_0__ Enterprise Capgo Enterprise Capgo Enterprise __CAPGO_KEEP_0__アプリを__CAPGO_KEEP_1__-updaterを使用してスムーズにアップデートする __CAPGO_KEEP_0__ Enterprise Capgoアプリを__CAPGO_KEEP_1__-updaterを使用してスムーズにアップデートする Capgo の製品ワークフロー向け Capgo コンサルティング Capgo コンサルティング、そして Capgo プレミアムサポート Capgo プレミアムサポートの製品ワークフロー向け
