カスタムドメイン

このプラグインのインストール手順と完全なMarkdownガイドを含むセットアッププロンプトをコピー

次のような独自のホスト名を updates.example.com、アプリの Live Updates API リクエストに使用できます。Capgo は引き続きチャンネル、bundle、ロールアウトを管理します。

カスタムドメインは Enterprise プランで利用できます。組織の管理者は、Console で Live Updates API ホスト名を追加し、指定された DNS レコードを公開して、有効化ステータスを確認できます。

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の検証

DNSプロバイダーで、Consoleに表示されている、またはサポートから提供されたレコードを追加してください。CNAMEや所有権・証明書検証用のTXTレコードを含め、レコードタイプ、名前、値を正確にコピーしてください。Console内の値をクリックするとコピーできます。Cloudflare DNSを使用している場合は、CNAMEを DNSのみ サポートから別の設定指示がない限り、

CNAMEを推測するのではなく、提供されたターゲットを使用してください。 plugin.capgo.app 設定はこれで十分です。ドメインの使用中は、DNSレコードをそのまま保持してください。

DNSの浸透後、 ステータスを更新をクリックしてください。Consoleには 稼働中 ホスト名とHTTPS証明書の両方が有効な場合にのみ、以下が提供されます： アップデーター設定をコピー. サポート支援でセットアップする場合は、サポートにアクティベーションの確認を依頼してください。DNSを確認し、TLS接続は次のコマンドでチェックできます：

dig updates.example.com
curl -v https://updates.example.com/updates

置き換え： updates.example.com をプロビジョニングされたホスト名に。 curl コマンドはDNS、TLS、HTTPの接続性をチェックします。なお、 /updates へのGETリクエストは有効なアップデート確認ではないため、API エラーが返される可能性があります。ステップ4のネイティブテストビルドで実際のアップデートフローを確認してください。

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. 同期、テスト、リリース

設定をネイティブプロジェクトに同期します：

npx cap sync

ネイティブのテスト版をビルドしてインストールし、次に以下を行います：

テスト用のbundleを test channelへ通常の Capgo ワークフローを使用してuploadします。
ネイティブデバイスのログを確認し、updateリクエストがカスタムホスト名に到達していること、およびbundleのdownloadとインストールが正常に完了していることを検証してください。
アプリで統計機能を使用している場合は、Consoleおよびtest channelの操作画面にupdateの統計が表示されることを確認してください。
通常のストア配信プロセスを通じて、新しいネイティブアプリのバージョンをリリースします。

古いネイティブインストールは、ユーザーが新しいネイティブバージョンをインストールするまで、設定済みのエンドポイントURLを使い続けます。アップデータのデフォルトホスト名は plugin.capgo.appです。これはCapgoが管理します。自身で管理している別のカスタムホスト名から移行する場合は、そのユーザーが移行を完了するまで、DNSレコードとサービスを有効に保ってください。Channel、bundleのアップロード、ロールバックは、通常どおりCapgo ConsoleとCLIワークフローで行えます。

トラブルシューティング

ドメインを削除するには、 ドメインを削除 → 削除を確認 をOrganization設定で使用してください。まず、代替エンドポイントを使ったネイティブアプリバージョンをリリースし、ユーザーが移行できるようにしてください。古いインストールは、削除されたホスト名経由でアクセスできなくなります。Organizationを削除する前に、ドメインを削除してください。

DNSが解決できません: レコード名とターゲットがサポートから提供された値と一致しているか確認し、DNSプロバイダーで伝播状況を確認してください。
HTTPSエラーが発生する場合: Native Buildをリリースする前に、サポートにホスト名の有効化と証明書の発行状況を確認するよう依頼してください。
リクエストが依然として以下を使用している場合: plugin.capgo.app: 3つのURLすべてを確認し、以下を実行してください: npx cap sync, 再ビルドを行い、新しいNative Buildをインストールしてください。
Bundleのダウンロードに別のホスト名が使用されている場合: アップデートのレスポンスにダウンロードURLが含まれています。カスタムBundle配信についてはサポートに問い合わせるか、以下を参照してください: カスタムストレージ Bundleのストレージを自身で管理したい場合。
HTTPSは有効ですが、アップデートに失敗する場合: App ID、channel、Native Buildのバージョン、リクエストのタイムスタンプ、およびNativeログを以下に共有してください: Capgo サポート.

詳細は Updaterの設定設定の完全なリファレンス、およびデータの保存場所リージョンごとのエンドポイント要件についてはこちら。