メインコンテンツにジャンプ
チュートリアル

CapacitorアプリをCapacitor-アップデーターを使用してスムーズに更新する

こんにちはCapacitor Ionic Community、今日はCapacitor-アップデーターをアプリに設定する方法を紹介します。 したがって、スムーズなリリースを行うことができます。

記事のクレジット

マーティン・ドナディュー

ライター

ヴァレリア

レビュアー

ジョーダン

エディター

Update your Capacitor apps seamlessly using Capacitor-updater

What is Capacitor-updater?

Capacitor-アップデーター

特に、緊急のバグ修正を行う場合に、App Storeのレビューを経ることなく即時で配信することができます。

これは、更新が利用可能になったときに、サイドロードで更新を即時で適用できるようにする「ウェブのような」迅速性を提供するのと同じです。

さらに、更新がアプリをクラッシュさせる場合でも、ロールバックが可能です。

Capgoアップデートはどのように機能するか

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.

私はすべてのプロジェクトでCapgoを使用しています。 これにより、App Storeのレビュープロセスに時間を費やす必要がなくなります。

詳しくはこちらを参照してください ここ.

Understanding Semantic Versioning with Capgo

Capgoはセマンティック バージョニング(semver)を使用して、更新がどの時点でどのように適用されるかを決定します。このため、ユーザーは互換性のある更新のみを受け取り、自動的に展開される破壊的な変更が防止されます。

セマンティック バージョニングの形式は MAJOR.MINOR.PATCH:

  • メジャー: 本番用アプリのリリースが必要な破壊的な変更
  • マイナー: バックワード互換性のある新機能
  • パッチ: バックワード互換性のあるバグ修正

例えば、バージョンが 1.0.0 にあり、 1.0.1 (a patch), Capgo は自動的にこのアップデートを適用します。ただし、次のバージョンにアップデートしたい場合は 1.0.0 から 2.0.0 (メジャーバージョン)、この場合、破壊的な変更が含まれるため、ネイティブアプリストアのリリースが必要になります。

Capgo のチャンネル設定では、自動的に適用されるアップデートの種類を設定できます。

  • メジャー戦略:すべてのアップデートを許可する (注意: ご使用にご注意ください)
  • マイナー戦略:マイナーおよびパッチアップデートのみを許可する
  • パッチ戦略:パッチアップデートのみを許可する
  • メタデータ戦略:最低バージョン要件を満たすことを要求する

Capgoのアップデートロジックを使用して、Capgoのバージョン combinationをテストすることができます。 Semver Testerツールアップデートの適用時期を把握するのに役立つツールです。チャンネル設定に基づいてアップデートの時期を理解することができます。

制限はありますか?

実際には、OTAアップデートはWeb Bundleのみに対応しています。 あなたは、__CAPGO_KEEP_0__のJSで、ほとんどの__CAPGO_KEEP_1__をJS、CSS、HTMLで書いていると思います。. 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.

モジュールがAndroidまたはiOSディレクトリを変更すると、OTAアップデートはアプリを更新できません。 これは、Nativeバイナリをコンパイルするために使用されるディレクトリの内容が更新できないためです。.

オートマチック Capgo 設定

アップロードする最初のバージョンに必要な API キーを取得するために、まずサインアップしてください。 signing up for a Capgo account.

ログインした後、Capgo の導入ページが表示されます。

アプリケーション登録ページ

アプリを追加するには、オンボーディングページの手順に従ってください。

Follow the CLI guidance

コマンドラインから、Capacitorアプリのルートディレクトリに直接移動して、以下のコマンドを実行してください。

npx @capgo/cli@latest init To install the Capgo into your Capacitor app, the CLI will walk you through the process of setting up your app with Capgo.

手動で行う場合は、以下の手順に従ってください。

Manual Capgo セットアップ

プラグインをインストール

あなたのアプリにこの code が追加されるはずです。

npm i @capgo/capacitor-updater && npx cap sync Capacitor アプリを Capacitor にインストールします。

NativeプラグインにJSバンドルの正常性を通知するために、以下のcodeをアプリに追加してください (これを追加しないと、Nativeプラグインは前のバージョンに戻されます)。

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

このコマンドは、ネイティブプラグインにインストールの成功を通知します。

次に、 npm run build && npx cap copy を実行してアプリを更新してください。

ログインするには、Capgo CLOUDにアカウントに記載されている

APIキーを使用してください。 all apikey アカウントに保存されている情報でログインするには、CLIを使用してください。

npx @capgo/cli@latest login YOU_KEY

まず、__CAPGO_KEEP_0__ Cloudにアプリを作成し、__CAPGO_KEEP_1__を使用してください。

Let’s get started by first creating an app in Capgo Cloud with the CLI.

npx @capgo/cli@latest app add

このコマンドは、指定されたCapacitorの設定ファイルに定義されているすべての変数を使用してアプリケーションを作成します。

__CAPGO_KEEP_0__をビルドし、__CAPGO_KEEP_1__に送信するコマンドを実行してください。

コマンドを実行して、code をビルドし、Capgo に送信してください。 npx @capgo/cli@latest bundle upload

デフォルトでは、バージョン名はあなたの package.json ファイルになります。

確認する Capgo コミットが存在する場合。

あなたのモバイルサンドボックスアプリでテストすることもできます。 デフォルトのチャンネルを設定する.

あなたのアプリを__CAPGO_KEEP_0__に送った後、チャンネルをデフォルトの設定に変更する必要があります。チャンネルを変更することで、アプリが__CAPGO_KEEP_0__からアップデートを受け取ることができます。

Capgoを受信するデバイス default アプリがCapgoからアップデートを受け取るようにする。

npx @capgo/cli@latest channel set production -s default

Live Update

live update

npx cap run [ios | android]

アプリを開き、バックグラウンドに置き、再度アプリを開きます。ログに表示されるように、アプリがアップデートを実行したことを確認してください。

おめでとうございます! 🎉 Live Update を成功的にデプロイしました。これは、Live Updates の機能の始まりです。詳細については、Live Updates ドキュメントを参照してください。 Live Updates ドキュメント.

ローカルでアップデートを受信しないようにするには、このコマンドを実行してください。 npx @capgo/cli@latest channel set

Keep going from Update your Capacitor apps seamlessly using Capacitor-updater

Live Updates を使用して、__CAPGO_KEEP_0__ アプリをスムーズにアップデートする方法を学びましょう。 Update your Capacitor apps seamlessly using Capacitor-updater __CAPGO_KEEP_0__ Enterprise Capgo 企業版 Capgo Enterprise __CAPGO_KEEP_0__ Enterprise イオニック エンタープライズ プラグインの代替品 Capgo の代替 Capgo の製品ワークフロー Capgo のコンサルティング Capgo の製品ワークフロー Capgo のプレミアムサポート Capgo の製品ワークフロー

Capacitor アプリ用のリアルタイム更新

When a web-layer bug is live, ship the fix through Capgo instead of waiting days for app store approval. Users get the update in the background while native changes stay in the normal review path.

ウェブ層のバグが生じた場合、__CAPGO_KEEP_0__ を使用して修正を配信し、App Store の承認待ちの日数を待たずに修正を配信することができます。ユーザーはバックグラウンドで更新を受け取り、ネイティブの変更は通常のレビュー パスを通じて保持されます。

コンテキスト:Capgo マーケティング ウェブサイト。役割:サポートする説明文またはメタ ディスクリプション。見つける場所:コンポーネント GetStarted.astro。Capgo の製品/ブランド名と開発者用語をそのまま保存してください。メッセージ キー `instant_updates_for_capacitor_apps_description` (Capacitor アプリ用の即時更新の説明)。

マーティンから人間のサポートを受けます

Capgo gives you the best insights you need to create a truly professional mobile app.