アップデートを簡素化したい アプリケーションアップデート CapgoのSemantic Versioning (SemVer)とは? CapgoのSemantic Versioning (SemVer) Capgoの CapgoCapgoのOver-The-Air (OTA)更新機能は、 Capacitor Capgoのアプリを管理するのが簡単で速くなります。ここではその方法を紹介します。
-
CapgoのSemantic Versioningの基本 バージョンは次の形式を使用します。
MAJOR.MINOR.PATCH:- メジャーバージョン メジャーバージョンでは、重大な変更が行われます。
- マイナーバージョン バックワード互換性のある新機能の場合。
- PATCH: バグ修正の場合。
-
Capgoで使う理由
- __CAPGO_KEEP_0__の更新情報について明確なコミュニケーション。
- __CAPGO_KEEP_0__のバージョン管理の知能化。
- 依存性の競合を回避。
- リリース計画の整理。
-
Capgoのセットアップ 手順:
- Capgoのアップデート プラグインをインストール。
- __CAPGO_KEEP_0__のアップデート プラグインをインストールして、アプリのバージョンを
capacitor.config.jsonその他のファイルも含めます。 - APIで初期化してください。
- 使用 Capgo CLIを使用してアップデートをバンドルしてアップロードしてください。 バージョンとチャンネルの管理
-
別々のチャンネルを使用してください（例：「ベータ」はテスト用、「プロダクション」は安定版のリリース用）。:
- アップデートポリシーを制御してください（パッチの自動アップデート、メジャーチェンジの手動承認）。
- アップデートのロールバックオプション（失敗したアップデートの場合）。
- デプロイプロセス：
-
SemVerルールに従ってバージョン番号を更新してください。
- テストを徹底してからデプロイしてください。
- Deployment Process:__CAPGO_KEEP_2__
- Use CLI commands to upload and distribute updates.
Capgo ensures updates reach users quickly and reliably, with tools to handle disruptions and maintain stability. Perfect for teams using CI/CD workflows to automate updates.
Quick Tip: 常にアップデートをテストし、チャンネルを使用してステージドロールアウトを効果的に管理することをお勧めします。
セマンティックバージョニング | Level Up
Capgo セットアップガイド
Here’s how to set up Capgo for managing OTA updates and version control with ease.
初期設定手順
まず、 Capgo updater plugin:
npm install @capgo/capacitor-updater
npx cap syncCapgoを使用するには、 capacitor.config.json __CAPGO_KEEP_0__
{
"appId": "com.example.app",
"appName": "My App",
"version": "1.0.0"
}バージョン番号がシーケンス形式であることを確認してください:
package.json古いプロジェクトの場合、次の場所でバージョン情報を更新してください:version(バージョン番号の)android/app/build.gradleフィールド)versionName)ios/App/App.xcodeproj/project.pbxproj(バージョン番号の)CURRENT_PROJECT_VERSION)
Once configured, initialize Capgo with your API key:
npx @capgo/cli@latest init YOUR_API_KEY設定が完了したら、__CAPGO_KEEP_0__に__CAPGO_KEEP_1__キーを初期化してください:
| クイックリファレンス表: | 設定フェーズ | 検証ステップ |
|---|---|---|
| インストール | プラグインのインストールと同期 | 確認 package.json |
| 設定 | バージョン番号の設定 | すべてのファイルを確認 |
| 初期化 | API キーと接続 | 接続状態のテスト |
| ビルド | 初期バンドルの作成 | アップロードの成功を確認 |
バージョン管理の統合
CapgoはCI/CDプラットフォームとよく組み合わされ、 自動更新 自動更新
CircleCI
{
"plugins": {
"CapacitorUpdater": {
"autoUpdate": false
}
}
}This ensures Capgo won’t overwrite your local changes. Once your setup is ready, upload your first version:
npx @capgo/cli@latest bundle upload
npx @capgo/cli@latest channel set production -s default最後に、CapgoのOTAアップデート用のバンドルの健康状態をアプリのメインファイルでnativeプラグインに通知してください:
import { CapacitorUpdater } from '@capgo/capacitor-updater';
CapacitorUpdater.notifyAppReady();この設定では、アプリがSmooth OTAデプロイメントとバージョン管理に適切に準備されています。
CapgoのOTAアップデート用のCapgo
バージョン番号管理
Capgoは、SemVerを使用してアプリのバージョンを管理し、MAJOR.MINOR.PATCHという形式でフォーマットします。 ここでは、どのように機能するかを説明します。メジャーバージョン(X.0.0)
- :互換性が破壊される変更のためにメジャーナンバーを増やす。マイナーバージョン(1.X.0)
- :互換性が維持される新機能のためにマイナーナンバーを増やす。パッチバージョン(1.0.X)
- Patch Version (1.0.X): バグ修正で互換性に影響しない場合、PATCH番号を増やす。
| バージョンタイプ | インクリメントするタイミング | 自動更新の動作 |
|---|---|---|
| メジャー (X.0.0) | 破壊的なAPI変更の場合 | 手動承認が必要 |
| マイナー (1.X.0) | 新機能の追加 | Capgoで構成可能 |
| パッチ (1.0.X) | バグ修正 | 通常自動 |
SemVer規則に従うことで、バージョン管理を簡素化し、展開チャンネル間での更新をスムーズにすることができます。
バージョン管理ガイドライン
Capgoは、Capgoの設定を通じて、異なるワークフローの段階ごとに異なるチャンネルを設定することで、展開を効果的に管理することができます。
-
チャンネルベースのバージョン管理:展開プロセスを組織化するために、テストとプロダクション用に別々のチャンネルを作成します。
- :新機能をテストするために、「ベータ」チャンネル（例：1.2.0-beta）を使用します。
- :安定したリリース用に「プロダクション」チャンネル（例：1.2.0）を使用します。
- :プラットフォーム固有の問題に対処するために、プラットフォーム固有のチャンネル（例：「ios-hotfix」バージョン1.2.1）を追加します。
-
更新ポリシー設定:Capgoの設定オプションを使用して、更新の適用方法を制御します。
{ "plugins": { "CapacitorUpdater": { "disableAutoUpdate": "minor" } } }:この設定により、ユーザーは自動的にパッチ更新を受け取りますが、マイナーやメジャー更新には手動の承認が必要になります。
-
バージョンロールバック戦略: プレリリース識別子を使用して、明確なロールバックオプションを維持します。このアプローチにより、問題が発生した場合に前のバージョンに戻ることができ、すべてのチャネルでバージョニングを一貫して維持できます。
これらのベストプラクティスにより、更新を管理し、新機能をテストし、アプリのデプロイプロセスの安定性を維持することが容易になります。
sbb-itb-f9944d2
OTA更新の展開
バージョン管理設定が完了したら、次の手順に従ってOTA更新を効果的に展開してください。
更新準備
まず、バージョンを package.json と capacitor.config.json__CAPGO_KEEP_0__.config.json
- バグ修正: PATCH番号を増やす (例: 1.0.1 → 1.0.2)
- 新機能: MINOR番号を増やす (例: 1.0.0 → 1.1.0)
- 重大な変更: MAJOR番号を増やす (例: 1.0.0 → 2.0.0)
ビルドを徹底的にテストし、サーバーとアプリケーションが正常に通信していることを確認する notifyAppReady.
次に、 アップデート戦略を決定する。選択肢は次のとおりです。
- 自動アップデート: 最小バージョン要件を自動的に強制する
- Manual Control: __CAPGO_KEEP_0__のバージョンを厳密に指定してアップデートを実行します。
- Channel-Based: チャンネルを使用してテストとステージングされたロールアウトを実行します。
Capgo CLI Update Commands
Use Capgo’s CLI to deploy your update with ease. Here’s how:
# Initialize Capgo in your project
npx @capgo/cli@latest init [apikey]
# Upload your update bundle
npx @capgo/cli bundle upload [appId]
# Add a new distribution channel
npx @capgo/cli channel add [channelName] [appId]Capgoは、エンドツーエンド暗号化と安全なキー管理を使用して、安全なデプロイを保証します。
“@Capgoは、@AppFlowのような金銭的コストを考慮せずにホットcodeプッシュを実行する賢い方法です 🙂”
アップデートがデプロイされた後は、Capgoのダッシュボードを使用してアップデートを監視できます。アップデートは、ユーザーがアプリを開く直後から数分以内にユーザーに到達します。プロセスは以下のとおりです:
- アプリはアップデートをチェックします。
- バックグラウンドでアップデートをダウンロードします。
- ユーザーがアプリを終了したときに、新しいバージョンを有効にします。
- 起動時にアップデートを適用します。
エンタープライズ向けのデプロイメントでは、CI/CDの自動化を統合したいと思われるかもしれません。
「Capgoは、継続的にユーザーに提供するmission-criticalなものです。Agile開発を実践しているので、Capgoは大切です!」
問題解決とヒント
バージョン管理に関する問題
Capgoでシナティックバージョニングを管理する場合、更新のデプロイが複雑になることがあります。開発作業を上書きしないようにするには、以下の設定を行ってください。 capacitor.config.json ファイル:
{
"plugins": {
"CapacitorUpdater": {
"autoUpdate": false
}
}
}アップデートが失敗した場合にどうすればいいか?
- __CAPGO_KEEP_0__
autoUpdate開発中のときfalseアプリをアンインストールします。 - __CAPGO_KEEP_0__
- 再インストールして、正しいバージョンを使用してください。
- すべてのステージが安定したら、自動更新を再度有効にします。
メジャーバージョンアップデートの場合、次の旗を使用して、更新を適切に処理するためにイベントを待ちます: disableAutoUpdateBreaking バージョンを適切に処理するためにイベントを待つには、次の旗とイベントを使用します: majorAvailable これらの設定をチームの良好な慣行と組み合わせると、バージョン一貫性を維持し、エラーを減らすことができます。
CapacitorUpdater.addListener('majorAvailable', (info) => {
console.log(`Major update available: ${info.version}`);
// Add your update prompt logic here
});チーム バージョン管理
個々の更新が管理されたら、チームは強力なバージョン管理慣行を確立する必要があります。
Once individual updates are managed, it’s crucial for teams to establish strong version control practices.
“Testing each change before merging it with the main repository will reinforce stability and avoid costly errors” [4]
各変更をメインのリポジトリとマージする前にテストすることで、安定性を強化し、費用のかかるエラーを回避できます。
- 一貫性を確保するための方法は次のとおりです。 メインのリポジトリとして一つのブランチを定義します。 Capgoを真の情報源として機能させる。
- 開発環境と生産環境用に別々のCapgoチャンネルを使用する。
- CI/CD Pipelinesを使用してバージョンアップロードを自動化する。
- 明確で詳細なコミットメッセージですべてのcodeの変更を記録する。
大規模なチームの場合、以下のバージョン管理マトリックスが更新を整理するのに役立ちます。
| 環境 | チャンネル | 自動更新 | バージョンパターン |
|---|---|---|---|
| 開発 | dev | 無効 | 0.x.x |
| プレリリース環境 | ベータ | 有効 | x.x.x-ベータ |
| 本番環境 | 安定 | 有効 | x.x.x |
アップデートの復旧手順
十分な注意を払ったとしても、更新が失敗することがあります。 その場合、以下の復旧手順に従ってください。
- 前の安定バンドルに戻す
- バージョン番号を修正する場合、修正のバージョン番号を増分する (注: 削除されたバージョン番号は再利用できません) [2].
- アプリ起動時にアップデートを検証して、期待どおりに動作することを確認します。
Capgoのアップデートツールは、障害を処理するように設計されています。たとえば、サーバーがアクセスできない場合やアップデートが削除された場合、アプリは通常の動作を続行します。 [3]さらに、失敗したネットワーク要求は、次のアプリ起動時に自動的に再試行されます。 [3]この組み込みの耐性は、ダウンタイムを最小限に抑え、スムーズな運用を保証します。
概要
セマンティック バージョニングとCapgoの組み合わせにより、CapacitorアプリのOTAアップデートが効率化されました。947.6百万のアップデートが配信され、1,400の生産アプリがこのシステムを使用しているため、デプロイプロセスは81%効率化されました。 [1]この設定により、開発者はアップデートを迅速かつ制御された方法で配信できるため、アプリストアの遅延を回避できます。 [1]開発者が言っていることはこちらです:
「__CAPGO_KEEP_0__ OTAアップデートをロールアウトしました」
__CAPGO_KEEP_0__ Capgo OTA updates Capgoのユーザーベース5000人以上で、生産性が高い。 OTAがCapgoにデプロイされた後、ほぼすべてのユーザーが数分以内に最新の状態になります。 - colenso [1]
MAJOR.MINOR.PATCHのバージョニングシステムは、破壊的な変更、新機能、バグ修正を簡単に伝えることができます。 [5]Capgoのプラットフォームを通じて、週に何度もリリースを管理するチームにとって、特に便利です。
Capgo 暗号化されたソリューションCI/CDツールと統合されているため、予算に優しい - 5年間で$26,100を節約できます。 [1]__CAPGO_KEEP_0__のカスタマイズ可能なチャネルは、正しいユーザーに正しい時点で更新を届けることを保証します。
「私たちはアジャイル開発を実践しており、Capgoはユーザーに継続的に提供するmission-criticalなものです！」 - Rodrigo Mantica [1]
「CapgoのOTAアップデートとセマンティックバージョニングを使用して、ロールバックとバージョン管理を計画する方法を学びましょう」
「__CAPGO_KEEP_0__のOTAアップデートとセマンティックバージョニングを使用して、ロールバックとバージョン管理を計画する方法を学びましょう」 「CapgoのOTAアップデートとセマンティックバージョニングを使用して、ロールバックとバージョン管理を計画する方法を学びましょう」 「__CAPGO_KEEP_0__のOTAアップデートとセマンティックバージョニングを使用して、ロールバックとバージョン管理を計画する方法を学びましょう」 ロールバック ロールバックの実装詳細 バージョン対象 バージョン対象 更新動作 更新動作の実装詳細 バンドル バンドルの実装詳細 Capgo ライブアップデート Capgo ライブアップデートの製品ワークフロー
