カスタムドメイン
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
次のような独自のホスト名を使用できます: updates.example.com、アプリの Live Updates API リクエスト向けに設定しつつ、Capgo は引き続きチャンネル、bundle、ロールアウトを管理します。
カスタムドメインは Enterprise プランで利用できます。組織の管理者は Console で Live Updates API ホスト名を追加し、指定された DNS レコードを公開して、有効化ステータスを確認できます。
1. カスタムドメインを追加する
セクション「1. カスタムドメインを追加」- 次を開きます: Capgo コンソール 組織を選択してください。
- 以下に移動します: 設定 → Organization → General から以下を探します: カスタムドメイン。組織の設定を変更する権限と、ドメインを追加するための有効なEnterpriseプランが必要です。
- 次のようなホスト名を入力してください:
updates.example.com(以下は含めないでください:https://、パス、またはワイルドカード) - クリック ドメインを追加。Consoleに公開が必要なDNSレコードと 検証待ち ステータス。
1つの組織につき、1つの Live Updates API ホスト名を設定できます。DNSレコードを編集できる必要があります。
もし カスタムドメイン オプションが利用できない場合は、Enterprise サポート担当者、または以下のメールアドレスまでご連絡ください: support@capgo.app その際、組織名、アプリID、希望するホスト名、DNSプロバイダーをお知らせください。また、特定の データレジデンシーリージョン や、bundle ダウンロード用のカスタムホスト名が必要な場合は、設定前にサポートへお問い合わせください。
2. DNSを設定してHTTPSを検証する
セクション「2. DNSの設定とHTTPSの検証」DNSプロバイダーで、Consoleに表示されたレコード、またはサポートから提供されたレコードを追加してください。CNAMEと、所有権や証明書の検証用TXTレコードも含め、レコードタイプ、名前、値を正確にコピーしてください。Console内の値をクリックするとコピーできます。Cloudflare DNSを使用している場合は、CNAMEを DNSのみ に設定したままにしてください(サポートから別の設定指示がある場合を除く)。
提供されたターゲットを使用し、CNAMEが plugin.capgo.app 十分だと決めつけないでください。ドメインの使用中は、DNSレコードをそのまま維持してください。
DNSが反映されたら、次をクリックしてください。 ステータスを更新。コンソールには、 提供中 ホスト名とHTTPS証明書の両方がアクティブな場合にのみ表示され、以下のオプションが表示されます: Updaterの設定をコピー。サポートによるセットアップが必要な場合は、サポートにアクティブ化の確認を依頼してください。また、以下のコマンドでDNSやTLSの接続性を確認することも可能です:
dig updates.example.comcurl -v https://updates.example.com/updates置換する updates.example.com プロビジョニングされたホスト名を使用して。 curl コマンドはDNS、TLS、およびHTTPの接続性をチェックします。 /updates へのGETリクエストは有効なアップデート確認とはみなされず、API エラーが返される場合があります。ステップ4のNative Buildを使用して、実際のアップデートフローを確認してください。
3. Updaterの設定
「3. アップデーターの設定」セクションドメインが有効になったら、Consoleからアップデーターの設定をコピーし、3つのURLをすべて統合してください capacitor.config.ts標準的な Capgo API パスでプロビジョニングされたホスト名の場合は、次を使用します:
import type { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = { appId: 'com.example.app', appName: 'My App', webDir: 'dist', plugins: { CapacitorUpdater: { autoUpdate: 'atBackground', updateUrl: 'https://updates.example.com/updates', statsUrl: 'https://updates.example.com/stats', channelUrl: 'https://updates.example.com/channel_self', }, },};
export default config;例示されているURLを、Consoleに表示されている正確なURL、またはサポートが確認したURLに置き換えてください。既存のアプリ設定やその他のプラグインオプションはそのまま維持してください。
| 設定 | 目的 |
|---|---|
updateUrl | 利用可能なbundleの有無を確認します。 |
statsUrl | アップデート統計をレポートします。 |
channelUrl | デバイスのchannel操作を処理します。 |
4. 同期、テスト、リリース
「4. 同期、テスト、リリース」というセクション設定をネイティブプロジェクトに同期します:
npx cap syncネイティブのテスト版をビルドしてインストールしたら、次を実行します:
- テスト用の Bundle を テストチャンネル へ、通常の Capgo ワークフローでアップロードします。
- ネイティブデバイスのログを確認し、アップデートリクエストがカスタムホスト名に届いていること、Bundle がダウンロードされてインストールされることを検証します。
- アプリで統計機能を使っている場合は、Console にアップデート統計が表示されること、および test channel の操作も確認してください。
- 通常のストア配信プロセスを通じて、新しいネイティブアプリのバージョンをリリースしてください。
古いネイティブ版は、ユーザーが新しいネイティブバージョンをインストールするまで、設定済みのエンドポイントURLを使用し続けます。アップデーターのデフォルトのホスト名は plugin.capgo.appであり、これは Capgo によって管理されます。自身で管理している別のカスタムホスト名から移行する場合は、対象のユーザーが移行を完了するまで、そのDNSレコードとサービスを有効に保ってください。Channels、bundleのアップロード、ロールバックは、引き続き通常の Capgo Consoleおよび CLI ワークフローで行えます。
トラブルシューティング
「トラブルシューティング」セクションドメインを削除するには、 ドメインを削除 → 削除を確認 をOrganization設定で使用してください。まず、代替エンドポイントを使用してネイティブアプリのバージョンをリリースし、ユーザーの移行を待ってください。古いインストール環境は、削除されたホスト名経由のアクセスができなくなります。Organizationを削除する前に、ドメインを削除してください。
- DNSが解決できない場合: レコード名とターゲットをサポートから提供された値と照合し、DNSプロバイダーで伝播を確認してください。
- HTTPS接続に失敗する場合: Native Buildをリリースする前に、ホスト名の有効化と証明書のプロビジョニングをサポートに確認するよう依頼してください。
- リクエストが依然として使用中:
plugin.capgo.app: 3つのURLをすべて確認し、npx cap syncを実行し、新しいネイティブバージョンを再ビルドしてインストールしてください。 - Bundleのダウンロードで別のホスト名が使用されている場合: アップデートレスポンスにダウンロードURLが含まれます。カスタムBundle配信についてはサポートに問い合わせるか、 カスタムストレージ Bundleストレージを自分で管理したい場合はこちらを参照してください。
- HTTPSが有効なのにアップデートに失敗する場合: app ID、channel、native version、リクエストのタイムスタンプ、native logsを共有してください: Capgo サポート.