概要

このクイックスタートチュートリアルでは、Capgo の主要なコンセプトを順を追って解説します。以下のような内容を扱います：

1. Capgo アカウントにアプリを追加する

2. CI/CD に Capgo を統合する

3. コミットをプッシュして Capgo で bundle upload をトリガーする

4. Capgo の bundle 公開を設定・カスタマイズする

5. Capgo を通じたライブアップデートを有効にするようアプリを設定する

6. Capgo からアプリへライブアップデートをデプロイする

ガイドをステップバイステップで進めるか、興味のあるコンポーネントのドキュメントに直接移動してください。

チュートリアルを開始

クイックスタートチュートリアルに従い、すぐに Capgo を使い始めましょう！

CLI オンボーディングガイド

インタラクティブな CLI オンボーディングのステップバイステップ完全ガイド。

アップデートを配信

Capgo ダッシュボードからアプリへアップデートを配信しましょう。

アップデートの自動化

Capgo を CI/CD と連携させ、コミットをプッシュするだけで Capgo への bundle アップロードをトリガーできます。

トラブルシューティング

よくある問題とその解決策。

まとめ

チュートリアルを締めくくり、学んだ内容をざっと振り返ります。

ヒント

Over-the-Air (OTA) アップデート機能は、HTML、CSS、JavaScript ファイルへの変更にのみ適用されます。

Capacitor プラグインの更新など、ネイティブの code に変更を加えた場合は、必ずアプリストアへ再申請して承認を得る必要があります。

Bundle の機密性

Capgo 暗号化を有効にしない限り、Capgo にアップロードされたすべての bundle は公開 Web アセットとして扱われます。Private channel はアップデートを受け取れるデバイスを制御しますが、アップロードされた bundle 自体を機密化するものではありません。暗号化は配信経路を保護し、第三者による有効な暗号化アップデートの作成を防ぎますが、公開鍵はバイナリに含まれているため、十分な労力をかければアプリから出荷済みの Web アセットをリバースエンジニアリングすることは可能です。詳細は Live Updateの暗号化.

Discord コミュニティに参加

Capgo の Discord サーバーに参加しましょう！

メンテナンス性

プラグインのバージョン	Capacitor の互換性	メンテナンス済み
v7.*.* (≥7.25.0)	v7.*.*	✅ 完全対応
v6.*.* (≥6.25.0)	v6.*.*	✅ 完全対応
v5.*.* (≥5.10.0)	v5.*.*	✅ 完全対応
v5.*.* (<5.10.0)	v5.*.*	⚠️ 非推奨
v4.*.*	v4.*.*	❌ サポート終了
v3.*.*	v3.*.*	❌ サポート終了
>= 8	v4.*.*	⚠️ CIプロセスのバージョン管理の問題により非推奨

ストアガイドラインの遵守

AndroidのGoogle PlayおよびiOSのApp Storeには、アプリケーションに Capacitor-updater ソリューションを導入する前に確認しておくべきガイドラインとルールがあります。

Google Play

の第3段落 デバイスおよびネットワークの不正使用 Google Playの更新メカニズム以外の方法でソースcodeを更新することは制限されている、とこのトピックでは説明しています。ただし、この制限はJavaScript bundleの更新には適用されません。

この制限は、仮想マシン内で動作し、Android APIへのアクセスが制限されているcode（WebViewやブラウザ内のJavaScriptなど）には適用されません。

これにより、Capacitor-updaterはJS bundleのみを更新し、ネイティブのcodeは更新しないため、完全に許可されます。

App Store

段落 3.3.2、2015年当時から Apple Developer Program ライセンス契約 JavaScriptとアセットのOTAアップデートを完全に許可しており、最新バージョン（20170605）では こちらからダウンロード可能 この裁定はさらに広範に及びます：

解釈されたcodeはアプリケーションにダウンロードできますが、そのcodeが次の条件を満たす場合に限ります：(a) App Storeに提出した時点のアプリケーションの意図および宣伝された目的と矛盾する機能を提供して、アプリケーションの主要な目的を変更しないこと、(b) 他のcodeやアプリケーション向けのストアまたはストアフロントを作成しないこと、(c) OSの署名、サンドボックス、その他のセキュリティ機能をバイパスしないこと。

Capacitor Updaterを使えば、プッシュするアップデートがApp Storeで承認された本来の意図から製品を大きく逸脱させない限り、これらのルールを完全に遵守できます。

Appleのガイドラインをさらに遵守するため、App Storeで配信されるアプリでは、以下を有効にしないことを推奨します： Force update シナリオです。というのも、～では App Storeの審査ガイドライン 次のように規定されています：

アプリは、機能やコンテンツへのアクセス、またはアプリの利用のために、ユーザーにアプリの評価、レビュー、他のアプリのダウンロード、その他同様の操作を強制してはなりません。

バックグラウンドアップデートのデフォルトの動作では、次にユーザーがアプリを閉じるまで新しいバージョンの適用を強制しないため、これは問題ありません。ただし、それを表示する場合は、少なくともこのルールを意識しておく必要があります。

オープンソース

このプラグインはLGPL-3.0ライセンスの下で提供されており、バックエンドはAGPL-3.0ライセンスです。

💡 LGPL-3.0 は、誰かがプラグインの code を改変した場合、同じライセンスでオープンソースとして公開することが義務付けられる、という意味です。code を改変せずに使う場合、あなたには関係ありません。詳細は以下の issue とリンクを確認してください 👇

ライセンスについて

ドキュメントを読む代わりに、GPTS Capgo に助けを求めてみてください

心配せずにアプリに組み込めます

最後に

セルフホストしていてこのツールが役に立つと思うなら、ぜひ私の活動の支援を検討してください： GitHub スポンサーになる.

私は、ここで構築したすべての code をペイウォールで制限するのではなく、オープンソース化するという賭けに出ました。隠したり争ったりするのではなく、オープンにすることで、世界をより良くできると信じています。

これを実現するためには、あなたを含め、私たち全員が役割を果たす必要があります 🥹。もし Capgo cloud がニーズに合わない場合は、 GitHub Sponsors で個人開発者を支援することも可能です 自分の条件で。

簡単な計算

ベーシックプランの料金: $14*12 = 年間$168。 一方、平均的な開発者1時間あたりのコストは$60。 つまり、セルフホストに3時間浪費すれば1年分の料金を払うことになる。3時間を超えて費やしたなら、むしろ損をしている ^^

Overviewから続ける

使用している場合 概要 CI/CD自動化を計画するには、次と連携してください Capgo での CI/CD 設定 Capgo CI/CDでのプロダクトワークフローについては、 Capgo Native Build Capgo Native Buildsでのプロダクトワークフローについては、 Capgo インテグレーション Capgo インテグレーションでのプロダクトワークフロー向けに、 CI/CD 連携 CI/CD Integrationの実装詳細については、 GitHub Actions 連携 GitHub Actions Integrationの実装詳細については。