概要

Capgoの基本概念を学ぶためのクイックスタートガイドです。以下の概念が紹介されます。

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

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

3. Capgoでコミットをプッシュするとバンドルアップロードをトリガーする

4. Capgoバンドルパブリッシングの設定とカスタマイズ

5. Capgoを使用してアプリをリアルタイムに更新するように設定する

6. Capgoを使用してアプリにリアルタイムの更新をデプロイする

ステップごとにガイドを進めます。興味のあるコンポーネントのドキュメントに直接移動することもできます。

チュートリアルを開始する

Capgoのクイックスタートチュートリアルに従って、Capgoをすぐに始めることができます!

CLIの導入ガイド

CLIのインタラクティブな導入プロセスに関するステップバイステップのガイド

アップデートを配信する

Capgoのダッシュボードから、アプリにアップデートを配信する

アップデートを自動化する

CapgoをCI/CDと統合し、Capgoにコミットをプッシュすることで、バンドルアップロードをトリガーする

トラブルシューティング

一般的な問題と解決策

まとめ

チュートリアルを終了し、学んだことを簡単に確認する

Tips

オーバー・ザ・エア（OTA）アップデート機能は、HTML、CSS、JavaScriptファイルのみの変更に対してのみ適用されます。

アプリケーションに変更を加えた場合、またはcodeプラグインの更新など、Capacitorの変更が必要な場合は、再度アプリケーションをアプリストアに提出する必要があります。

バンドル非公開

Capgoにアップロードされたすべてのバンドルを、Capgoの暗号化を有効にしない限り、パブリックなウェブアセットとして扱ってください。プライベートチャンネルは、更新を受け取るデバイスを制御しますが、バンドルを非公開にすることはありません。暗号化は、更新の配信経路を保護し、第三者が有効な暗号化された更新を生成するのを防ぎますが、公開鍵がアプリ内に分散しているため、十分な努力を払えば、実行可能なアプリからウェブアセットを逆アセンブルすることができます。詳しくは ライブアップデート暗号化.

Discordコミュニティに参加

Join the Capgo Discord Server!

メンテナンス

プラグインバージョン	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

「デバイスとネットワークの乱用」 更新元の __CAPGO_KEEP_0__ を、Google Play の更新メカニズム以外の方法で更新することは制限されています。ただし、この制限は、JavaScript バンドルを更新する場合には適用されません。 code が、仮想マシン上で実行され、Android API にアクセスできるのは制限されたものの場合、この制限は適用されません。

code-updater は、JavaScript バンドルを更新し、ネイティブ __CAPGO_KEEP_1__ を更新しないため、完全に許可されます。

That fully allows Capacitor-updater as it updates just the JS bundles and won’t update native code.

「App Store」

Paragraph 3.3.2, 2015 年の Apple Developer Program License Agreement JavaScript とアセットのオーバー・ザ・エア更新を完全に許可している ここでダウンロードできます この規定はさらに広く適用されます:

Interpreted code may be downloaded to an Application but only so long as such code: (a) does not change the primary purpose of the Application by providing features or functionality that are inconsistent with the intended and advertised purpose of the Application as submitted to the App Store, (b) does not create a store or storefront for other code or applications, and (c) does not bypass signing, sandbox, or other security features of the OS.

Capacitor Updater は、(a) アップデートがアプリケーションのオリジナルの App Store 承認された意図から大きく逸脱しない限り、上記の規則を完全に遵守することができます。

Apple のガイドラインに従って、App Store から配布されるアプリケーションでは、 Force update シナリオを有効にすることを避けることをお勧めします。 App Store Review Guidelines と記載されています:

アプリはユーザーにアプリを評価する、レビューする、他のアプリをダウンロードする、または他の類似のアクションを強制してはなりません。そうしない限り、アプリの機能、コンテンツ、またはアプリの使用を利用できません。

デフォルトのバックグラウンド更新の動作では、この問題はありません。なぜなら、ユーザーに新しいバージョンを適用するように強制することは、次にアプリを閉じるまで待つからです。ただし、表示する場合には、その役割を理解することが必要です。

オープンソース

プラグインはLGPL-3.0ライセンス、バックエンドはAGPL-3.0ライセンスで提供されています。

💡 LGPL-3.0ライセンスの場合、プラグインのcodeを変更した場合、変更内容を公開することが義務付けられます。変更せずにcodeを使用する場合は、関連することはありません。詳細は下記のissueを参照してください。

ライセンスについて

GPTS Capgoを使用して、ドキュメントを読むのではなく、ヘルプを取得してみましょう。

アプリに組み込むことができます。

最終的なメモ

自社でホストしている場合、このツールが役に立つと感じた場合は、私の仕事を支援するために寄付をしてください。 GitHub のスポンサー.

ここで作ったすべての code をオープンソース化することに賭けました。金銭的報酬を求めずに、オープン化することで、世界をより良い場所に変えることができるのではないかと信じています。

このことが可能になるためには、みんなが自分の役割を果たす必要があります。 Capgo クラウドがあなたのニーズを満たさない場合は、独自のメーカーを支援することを検討してください。 ここ あなたの条件で。

シンプルな数学

基本プランの価格: $14*12 = $168 年間。 平均開発者/時間 = $60. 3 時間の開発時間を浪費すると、1 年分の費用を支払うことができます。3 時間以上を費やした場合は、損失が生じます ^^

続けてオーバービューから進みます。

あなたが使用している場合 オーバービュー CI/CD自動化の計画に役立つように Capgo CI/CD Capgo CI/CDの製品ワークフロー Capgo ネイティブビルド Capgo ネイティブビルドの製品ワークフロー Capgo インテグレーション Capgo インテグレーションの製品ワークフロー CI/CD統合 __CAPGO_KEEP_0__ アクションズ統合 GitHub アクションズ統合の実装詳細 for the implementation detail in GitHub Actions Integration.