メインコンテンツにジャンプ

npm Scripts for Capacitor OTA Updates Explained

Learn how to automate OTA updates for your Capacitor app using npm scripts, enhancing deployment efficiency and user experience.

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

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

コンテンツマーケター

npm Scripts for Capacitor OTA Updates Explained

__CAPGO_KEEP_0__ アプリを更新することは、以前以上に簡単になりました。 Capacitor アプリのアップデートを自動化することで、時間を節約し、ユーザーが最新バージョンを手軽に利用できるようにすることができます。 By combining Over-The-Air (OTA) updates with npm scripts, you can automate deployments, save time, and ensure your users always have the latest version - without waiting for app store approvals.

ここでは、次のことを学びます:

  • npmのOTA更新用スクリプトを設定する方法を学びます。
  • CI/CDパイプラインに更新を統合する方法を学びます。
  • アプリのバージョン、セキュリティ、テスト更新を管理する方法を学びます。
  • なぜ Capgo はOTA更新の管理に信頼できるプラットフォームであるかを学びます。

主な利点:

  • 1つのコマンドで更新を自動化します。
  • 暗号化を使用して安全に更新を展開します。
  • __CAPGO_KEEP_0__ Actions GitHub Actions.
  • 時間を節約するツールとして、Capgoが500ms未満で更新を提供する。

Quick Setup Example:

  1. ツールのインストール: npm install @capgo/cli --save-dev
  2. 更新の設定は capacitor.config.json.
  3. npmスクリプトを追加して deploy:production デプロイメントをスムーズにする。

迅速な更新 (24時間で95%のユーザー採用率) と安価な価格を提供するプラットフォームとしてCapgoが、OTA更新の管理を効率的に行うことができるようになりました。

npmスクリプトのセットアップ

ここでは、npmスクリプトを使用して Capacitor OTA更新を効果的に管理する方法を説明します。このプロセスには、必要なパッケージのインストール、設定の設定、およびデプロイメントスクリプトの作成が含まれます。 必要なパッケージのインストール

targetLanguage

最初に、必要なパッケージをインストールしてください。 Capgo CLI このプロセスを簡素化するために、組み込みコマンドを使用します:

npm install @capgo/cli --save-dev
npm install @capacitor/cli --save-dev

次に、次のコマンドを使用してOTAの設定を初期化してください:

npx @capgo/cli init

OTAの設定

OTAの更新を準備するために、以下の設定を capacitor.config.json ファイルに追加してください。

{
  "appId": "com.your.app",
  "appName": "Your App",
  "plugins": {
    "CapacitorUpdates": {
      "autoUpdate": true,
      "updateUrl": "https://api.capgo.app/updates",
      "statsUrl": "https://api.capgo.app/stats"
    }
  }
}

この設定により、自動的に更新を取得し、統計情報を報告できるようにします。

デプロイメントスクリプトの作成

以下のnpmスクリプトを package.json ファイルに追加して、ビルドとデプロイメントのプロセスを簡素化してください:

{
  "scripts": {
    "build:web": "npm run build",
    "build:update": "npx @capgo/cli build",
    "deploy:update": "npx @capgo/cli upload",
    "deploy:production": "npm run build:web && npm run build:update && npm run deploy:update"
  }
}
  • build:web: Webアセットをビルドし、通常は開発とデプロイメントの際に使用されます。
  • build:update: OTAアップデート用のパッケージを準備します。
  • deploy:update: Capgoにアップロードします。
  • deploy:production: 完全なビルドとデプロイワークフローをハンドルします。生産用リリースに適しています。

環境変数の設定

設定を完了するには、次の環境変数を定義してください。

CAPGO_TOKEN=your_api_token
CAPGO_APP_ID=your_app_id

互換性と信頼性

Capgo CLIは、Capacitor 8をサポートしており、最新のバージョンとともに信頼性の高いアップデート機能を保証しています。

スクリプトコマンド目的使用するタイミング
build:webウェブアセットをビルドします開発と展開の段階で
build:update__CAPGO_KEEP_0__のアップデートパッケージを準備します各OTAアップデートの前
deploy:updateCapgoにアップデートをアップロードしますアップデートをプッシュする準備ができた時
deploy:production__CAPGO_KEEP_0__のフルワークフローを取り扱います製品リリース用

npmスクリプトをCI/CDに追加する

npmスクリプトをCI/CDパイプラインに統合すると、Capacitorアプリのオーバー・ザー・アイア (OTA) アップデートプロセスが簡素化されます。ここでは、自動化された展開を効率的に設定するためのガイドを紹介します。

CI/CD ビルド設定

CI/CD 環境を設定するには、必要な変数とステップを指定してください。

environment:
  CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
  CAPGO_APP_ID: ${{ secrets.CAPGO_APP_ID }}
  NODE_ENV: production

最適なパフォーマンスを実現するには、ビルドプロセスにキャッシュを含めてください。

cache:
  paths:
    - node_modules/
    - .npm/
    - dist/

GitHub Actions セットアップガイド

GitHub Actions

自動デプロイワークフローを自動化するには、次の構成ファイルを作成してください。 .github/workflows/ota-deploy.yml このセットアップでは、変更がブランチにプッシュされたときにアプリが自動的にデプロイされるようにします。

name: Deploy OTA Update
on:
  push:
    branches: [ main ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: '24'

      - name: Install dependencies
        run: npm ci

      - name: Run deployment
        run: npm run deploy:production
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          CAPGO_APP_ID: ${{ secrets.CAPGO_APP_ID }}

更新回復と修正 main 潜在的な更新エラーを処理するには、CI/CD パイプラインに回復機構を含めてください。これらの機能は、アプリの安定性を維持するのに役立ちます。

Update Recovery and Fixes

To handle potential update failures, include recovery mechanisms in your CI/CD pipeline. These features can help maintain app stability:

__CAPGO_KEEP_0____CAPGO_KEEP_1____CAPGO_KEEP_2__
__CAPGO_KEEP_3__npm run revert:update__CAPGO_KEEP_4__
__CAPGO_KEEP_5__npm run verify:update__CAPGO_KEEP_6__
__CAPGO_KEEP_7__ in __CAPGO_KEEP_8__maxRetries: 3 __CAPGO_KEEP_9__ attempts the update multiple times__CAPGO_KEEP_10__ can enhance your deployment script to manage errors automatically. For example:

__CAPGO_KEEP_11__ ensures that if a deployment fails, the system will revert to the previous stable version. Additionally, your CI/CD pipeline can send status reports and trigger notifications through your preferred platform.

npm run deploy:production || npm run revert:update

__CAPGO_KEEP_12__

OTA更新管理のヒント

OTA更新を効果的に管理するには、バージョン管理、徹底的なテスト、強固なセキュリティプロトコルを維持する必要があります。npm スクリプトを使用してアップデートを簡素化する方法については、以下のとおりです。

バージョン管理

シームレスなバージョン管理は、簡単な方法でアプリのアップデートを管理することができます。以下の例の設定を参照してください。

{
  "version": "2.5.0",
  "scripts": {
    "update:major": "npm version major && npm run deploy:update",
    "update:minor": "npm version minor && npm run deploy:update",
    "update:patch": "npm version patch && npm run deploy:update"
  }
}

分散チャンネルの使用

プロダクション、ベータ、アルファ、ホットフィックスなどの分散チャンネルの使用により、ターゲット化されたロールアウトが可能になります。これらの戦略により、更新テストとスムーズなデプロイメントを容易にします。

Automated testing is essential for catching issues early. Use npm scripts to simplify the process:

npm run test:update -- --channel=beta
npm run verify:deployment
npm run monitor:metrics

自動テストは、問題を早期に発見するために不可欠です。__CAPGO_KEEP_0__ スクリプトを使用して、プロセスを簡素化します。

ステージごとのテスト

アップデートをステージごとにテストすることで、問題をすべてのユーザーに到達する前に発見できます。自動ロールバック手順は、アプリの安定性を維持するための安全なネットワークです。

アップデートのセキュリティ対策OTA更新のセキュリティは非常に重要です。以下の対策を実施してください。目的
端末間の暗号化Capgoによって提供されるデータ漏洩に対する保護
更新署名パッケージの検証更新が本物であることを確認
アクセス制御ロールベースの権限チームのアクセスを制限

「本物の端末間暗号化を実現する唯一の解決策は、他のものは更新の署名のみ」 - Capgo [1]

更新が安全であることを確認するには、npm スクリプトを設定して、すべてのものをデプロイ前に検証するようにしてください。

{
  "scripts": {
    "predeploy": "npm run security:check",
    "deploy": "capgo upload --encrypt",
    "security:check": "npm audit && npm run validate:bundle"
  }
}

さらに、チャネル固有のセキュリティポリシーを強制し、ロールベースのパーミッションを使用して、更新を配布できるユーザーを制御することができます。この追加の保護層は、デプロイプロセスに安全性を追加します。

OTA更新プラットフォームの選択

正しいOTA更新プラットフォームを選択することは、npm スクリプトをワークフローに統合するために効果的に実行するために不可欠です。パフォーマンス、セキュリティ、および既存のツールと互換性のある要素を優先してください。ここでは、Capgo と他の市場オプションの詳細を提供し、情報に基づいた決定を下すのに役立ちます。

Capgo 機能

Capgo Live Update ダッシュボード インターフェイス

Capgo は、Capacitor OTA 更新用に設計されており、平均的な更新速度は 434 ミリ秒、ユーザー更新率は 95% を達成しています。 [1] また、npm スクリプトとのシームレスな統合を提供し、以下の例を参照してください。

{
  "scripts": {
    "deploy:production": "capgo upload --channel production",
    "deploy:beta": "capgo upload --channel beta --encrypt",
    "rollback": "capgo revert --channel production"
  }
}

Capgo は、エンドツーエンド暗号化を使用して安全な更新を提供し、チャネルシステムを使用して戦略的なデプロイを許可します。750 の生産アプリケーションを通じて 23.5 百万の更新を実行したことで、スケーラビリティと信頼性を証明しています。 [1].

プラットフォームの比較

npm スクリプトを使用する場合、暗号化、速度、および CI/CD統合に基づいてプラットフォームを評価することが不可欠です。ここでは、機能の比較を提供します。

機能実装詳細アップデート成功率
端末間暗号化完全な暗号化サポート82%の世界中 [1]
アップデート速度5 MBのバンドルに対して114 msグローバルCDN配信
CI/CD統合GitHub アクション、GitLab CIカスタムワークフロー

「私たちはアジャイル開発を実践しており、@Capgo はユーザーに継続的に提供するmission-criticalなツールです!」
– Rodrigo Mantica [1]

The OTA update market has shifted significantly, especially after Microsoft Code Push shut down in 2024, with Appflow set to follow in 2026. Simon Flack shared his perspective on these changes:

“We are currently giving a try to @Capgo since Appcenter stopped live updates support on hybrid apps and @AppFlow is way too expensive.” [1]

コストはチームにとって重要な考慮事項です。Capgo プランは、1 か月あたり 12 ドルで、OTA 更新プログラムと約 15 個のネイティブ ビルドを含み、追加のビルド分数は分単位でクレジットで請求されます。 これは、エンタープライズ レベルのお金の代わりに、$6,000 年間の料金が多くあります。 [1].

npm を実装するスクリプトをデプロイワークフローに組み込む際には、次の要素を考慮してください:

  • API の反応性 スムーズなスクリプト実行のために
  • チャンネル管理 目標の更新用
  • CI/CD パイプライン統合 順序のあるプロセス
  • 強力なセキュリティ対策 規制の遵守を確実にする
  • 安価 予算を超えることなく拡大

Capgoの複雑なnpmスクリプト設定を処理できる能力と高性能を維持する能力により、CapgoはOTAの強力な候補となります。 更新管理.

結論

主なポイントのレビュー

npmスクリプトを使用すると、Capacitor OTA更新の管理プロセスが簡素化されます。CI/CD パイプラインに統合された場合、これらのスクリプトは自動展開を実現しながら、セキュリティとパフォーマンスのレベルを維持します。

ここでは、主な対象領域を紹介します。

  • 自動デプロイ: バージョン管理とデプロイを手動介入なしで行う。
  • セキュリティ対策: 更新が安全に配布され、端末間の暗号化が行われる。
  • パフォーマンス監視: 更新配信の速度と成功率を追跡する。

Capgoの特徴

Capgoの利点

2024年にMicrosoft CodePushが終了することが発表され、OTA更新の状況が変化しました。Capgoは、750の実稼動アプリケーションを通じて、23.5万の更新を成功させました。 [1].

「私たちはアジャイル開発を実践しており、@Capgoはユーザーに継続的に提供するmission-criticalなツールです!」 – Rodrigo Mantica [1]

Capgoのパフォーマンス指標は自ら語ります。

パフォーマンス指標実績
平均 API レスポンス世界中で 434 ms
バンドルダウンロード速度5 MB の場合、114 ms
アップデート成功率世界中で 82%

月額 $12 から始まる、OTA 更新と約 15 つのネイティブ ビルド/月が含まれる - さらにビルド分数は、分単位でクレジットを通じて請求されます - Capgo は、セキュア、信頼できる、かつコスト効率の高いオプションを提供し、OTA 更新とネイティブ ビルドの自動化を管理する [1].

npm スクリプトから続けて、Capacitor OTA 更新の解説

__CAPGO_KEEP_0__ スクリプトから続けて、__CAPGO_KEEP_1__ OTA 更新の解説を使用している場合 npm スクリプトから続けて、Capacitor OTA 更新の解説を使用している場合 セキュリティとコンプライアンスの計画に役立つため、 暗号化 __CAPGO_KEEP_0__ セキュリティ スキャナの実装詳細における コンプライアンス __CAPGO_KEEP_0__ セキュリティ スキャナの製品ワークフローにおける Capgo セキュリティ Capgo セキュリティの製品ワークフローにおける Capgo トラスト センター Capgo トラスト センターの製品ワークフローにおける Capgo Trust Center for the product workflow in Capgo Trust Center.

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

ウェブ層のバグが生じた場合、Capgoを通じて修正を配信するのではなく、数日間待ってアプリストアの承認を待つのではなく、ユーザーはバックグラウンドで更新を受け取り、ネイティブの変更は通常のレビュー経路で残る。

今すぐ始める

ブログの最新記事

Capgoは、プロフェッショナルなモバイルアプリを作成するために必要な最良の洞察を提供します。