概要

このクイックスタート・チュートリアルでは、Capgo の主要なコンセプトについて解説します。学習内容は以下の通りです。

1. Capgo アカウントへのアプリ追加

2. CI/CD への Capgo の統合

3. コミットプッシュによる Capgo への bundle upload の実行

4. Capgo の bundle 公開設定とカスタマイズ

5. Capgo による Live Update を有効にするアプリ設定

6. Capgo からアプリへ Live Update をデプロイ

ガイドに沿って進めるか、興味のあるコンポーネントのドキュメントへ直接移動してください。

チュートリアルを開始

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

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

インタラクティブな CLI の onboarding プロセス用ステップバイステップガイド。

アップデートをリリース

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

アップデートの自動化

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

トラブルシューティング

よくある問題とその解決策について。

まとめ

チュートリアルのまとめと、学習内容のクイックレビューを行います。

ヒント

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

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

Bundleの機密性について

Capgo による暗号化を有効にしない限り、Capgo にアップロードされたすべての bundle は公開された Web アセットとして扱われます。プライベートチャネルは、どのデバイスがアップデートを受け取れるかを制御しますが、アップロードされた 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 を修正せずに使用する場合は、この制限は適用されません。詳細については、以下のリンクを確認してください 👇

ライセンスについて

ドキュメントを読む代わりに、GPTS Capgo でヘルプを試してみてください

アプリに安心して組み込むことができます

最後に

もしセルフホストしてこのツールが役に立つと感じたら、ぜひ以下の方法で活動を支援してください GitHub スポンサーになる.

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

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

簡単な計算

ベーシックプランの料金: 年間 $168 ($14*12)。 エンジニアの平均時給を $60 とすると、 セルフホストに3時間以上費やすなら、Capgoを1年分使うより高くつきます。3時間を超えたら、損をしていることになります ^^

Overviewから続ける

以下を使用している場合： 概要 CI/CD 自動化を計画するには、次と接続します： Capgo による CI/CD Capgo CI/CD のプロダクトワークフロー向けに、 Capgo Native Build Capgo Native Builds のプロダクトワークフロー向けに、 Capgo 連携一覧 Capgo Integrations のプロダクトワークフロー向けに、 CI/CD 連携 CI/CD Integration の実装詳細向け、および GitHub Actions 連携 GitHub Actions Integration の実装詳細については。