Capacitor-updaterは何ですか？
Capacitor-updaterは、ユーザーに即座にアプリの更新と改善を提供するための技術です。
特に、緊急のバグ修正を行う場合に、App Storeのレビュー手順を経ることなく即座に配信したい場合は、非常に便利です。
これは、更新が利用可能になったときに即座に側载することができる「ウェブのような」迅速性を提供するのと同じです。
さらに、新しい更新がアプリをクラッシュさせる場合でも、ロールバックが提供されます。
どのように機能するか？
Capgoは、CapgoサーバーとアプリのJavaScriptバンドルを同期し、ユーザーがアプリを開いたときに、Capgoサーバーと連携して、バンドルの新しい更新が利用可能かどうかを確認します。
I use Capgo in all my projects I build. That allows me to put less time in the App Store review process.
私は__CAPGO_KEEP_0__をすべてのプロジェクトで使用しています。これにより、App Storeのレビュー手順に時間を費やす必要がなくなります。 詳しくはこちらを参照してください。.
Capgoのセマンティックバージョニングの理解
Capgoは、セマンティックバージョニング（semver）を使用して、更新が適用されるタイミングと方法を決定します。このため、ユーザーが互換性のある更新を受け取り、自動的に展開される破壊的な変更を防ぎます。
バージョニングは、次の形式を取る MAJOR.MINOR.PATCH:
- MAJOR: 本質的な変更点が必要なネイティブアプリストアのリリース
- MINOR: バックワード互換性のある新機能
- PATCH: バックワード互換性のあるバグ修正
例えば、v1.2.3というバージョンのアプリをv1.2.4（パッチ）にアップデートしたい場合、__CAPGO_KEEP_0__は自動的にこのアップデートを適用します。ただし、v1.2.3からv2.0.0（メジャーバージョン）にアップデートしたい場合、このアップデートはネイティブアプリストアのリリースが必要です。なぜなら、破壊的な変更点が含まれているからです。 1.0.0 For example, if your app is at version 1.0.1 (a patch), Capgo will automatically apply this update. However, if you want to update from 1.0.0 (a patch), __CAPGO_KEEP_0__ will automatically apply this update. However, if you want to update from 2.0.0 to","(a major version), this would require a native app store release since it indicates breaking changes.
Capgoのチャンネル設定では、自動適用される更新の種類を設定できます。
- 大規模戦略：すべての更新を許可する（注意：使用に際しては十分な注意を払ってください）
- 小規模戦略：小規模およびパッチ更新のみを許可する
- パッチ戦略：パッチ更新のみを許可する
- メタデータ戦略：最低バージョン要件を満たすことを要求する
Capgoの更新ロジックを使用して、異なるバージョン combinationの動作をテストできます。 Semver Tester tool。このツールは、チャンネル設定に基づいて、更新が適用される時刻を理解するのに役立ちます。
制限はありますか?
実際には、OTA更新は、Webバンドルでのみ機能します。 あなたは、__CAPGO_KEEP_0__ JS では、ほとんどの __CAPGO_KEEP_1__ を JS、CSS、HTML で書くことができるため、実際には大きな制限ではないと考えられます。 しかし、実際には、Nativeモジュールをアプリにインストールすることがあります。 モジュールが Android または iOS ディレクトリを変更した場合、OTA を使用してアプリを更新することはできません。 これは、Native バイナリをコンパイルするために使用されるディレクトリの内容が OTA で更新できないためです。 Native アプリでも、この部分を更新することはできません。 しかし、CI/CD を設定して、この部分を管理することができます。 私は、IOS の設定方法についてのチュートリアルを作成しました。 ここで、チュートリアルを参照してください。 OTA更新は、Webバンドルでのみ機能します。. You may think that this isn’t really a big limitation because, in Capacitor JS, we write almost all code in JS CSS and HTML. While this may be true, there still are native modules that we install to our app. If a module changes your android or iOS directories, you can’t use OTA to update your app. That’s because these directories’ contents are used to compile Native binaries, which OTA can’t update. Even native app cannot update this part.
アカウントを作成し、__CAPGO_KEEP_0__ キーを取得して、最初のバージョンをアップロードする準備ができました。 最初に、__CAPGO_KEEP_0__ アカウントに登録してください。 __CAPGO_KEEP_0__ にログインすると、オンボーディングページが表示されます。.
Auto Capgo Configuration
It’s time to sign up, and get your API key to upload your first version! Begin by signing up for a Capgo account.
実際には、OTA更新は、Webバンドルでのみ機能します。 あなたは、Capgo JS では、ほとんどの __CAPGO_KEEP_1__ を JS、CSS、HTML で書くことができるため、実際には大きな制限ではないと考えられます。 しかし、実際には、Nativeモジュールをアプリにインストールすることがあります。 モジュールが Android または iOS ディレクトリを変更した場合、OTA を使用してアプリを更新することはできません。 これは、Native バイナリをコンパイルするために使用されるディレクトリの内容が OTA で更新できないためです。 Native アプリでも、この部分を更新することはできません。 しかし、CI/CD を設定して、この部分を管理することができます。 私は、IOS の設定方法についてのチュートリアルを作成しました。 ここで、チュートリアルを参照してください。
アカウントを作成し、__CAPGO_KEEP_0__ キーを取得して、最初のバージョンをアップロードする準備ができました。 最初に、__CAPGO_KEEP_0__ アカウントに登録してください。 __CAPGO_KEEP_0__ にログインすると、オンボーディングページが表示されます。 オンボーディングページの指示に従って、最初のアプリを追加してください。
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プラグインにインストールの成功を通知します。
次に、"を実行してアプリを更新します。 npm run build && npx cap copy __CAPGO_KEEP_0__の
ログインするには Capgo CLOUD にアクセスしてください
最初に、 all APIキー CLI でのアカウントに含まれる API キーを使用して、CLI でログインしてください
npx @capgo/cli@latest login YOU_KEY
最初のアプリを追加する
Capgo Cloud に CLI を使用して最初のアプリを作成しましょう
npx @capgo/cli@latest app add
Capacitor config ファイルに定義されているすべての変数を使用してアプリを作成するコマンドはこちらです
最初のバージョンをアップロードする
code をビルドし、Capgo に送信するコマンドを実行してください
npx @capgo/cli@latest bundle upload
デフォルトでは、バージョン名はファイル内のものになります package.json チェックインする
ファイル Capgo ビルドが存在する場合。
You can even test it with my モバイルサンドボックスアプリ.
チャンネルをデフォルトに設定
After you have sent your app to Capgo, you need to make your channel default を設定して、アプリがCapgoからアップデートを受け取るようにします。
npx @capgo/cli@latest channel set production -s default
デバイスでライブアップデートを受信
For your application to receive a live update from Deploy, you’ll need to run the app on a device or an emulator. The easiest way to do this is simply to use the following command to launch your local app in an emulator or a device connected to your computer.
npx cap run [ios | android]アプリを開き、バックグラウンドに置き、再度アプリを開きます。ログに表示されるように、アプリがアップデートを実行したことを確認してください。
おめでとうございます！ 🎉 ご自身の最初のライブアップデートを成功させました。これは、ライブアップデートの機能のすべてを活用するための最初のステップです。ライブアップデートの詳細なドキュメントをご覧ください。 ライブアップデートのドキュメント.
ローカルで更新を受信しないようにするにはこのコマンドを実行してください
npx @capgo/cli@latest channel set
Capacitorアプリを無制限にアップデートすることができます。Capacitor-updaterを使用して
__CAPGO_KEEP_0__を使用している場合 Capacitorアプリを無制限にアップデートすることができます。Capacitor-updaterを使用して 企業のマイグレーションとオペレーションを計画するには、__CAPGO_KEEP_0__ Enterpriseと接続してください Capgo Enterpriseの製品ワークフロー for the product workflow in Capgo Enterprise, __CAPGO_KEEP_0__ Alternativesの製品ワークフロー __CAPGO_KEEP_0__ Alternativesの製品ワークフロー Capgoコンサルティング Capgoアプリを無制限にアップデートすることができます。__CAPGO_KEEP_1__-updaterを使用して Capgoアプリを無制限にアップデートすることができます。__CAPGO_KEEP_1__-updaterを使用して 製品ワークフローについてはCapgoコンサルティングで Capgoプレミアムサポート 製品ワークフローについてはCapgoプレミアムサポートで
