Domain Kustom

Gunakan hostname sendiri, seperti updates.example.com, untuk request Live Updates API aplikasi Anda, sementara Capgo tetap mengelola channel, bundle, dan rollout Anda.

Custom domain tersedia pada paket Enterprise. Admin organisasi dapat menambahkan hostname Live Updates API di Console, mempublikasikan DNS record yang diberikan, dan mengecek status aktivasinya.

1. Tambahkan custom domain Anda

1. Buka Console Capgo dan pilih organisasi Anda.
2. Buka Pengaturan → Organisasi → Umum dan cari Domain kustom. Anda butuh izin untuk mengubah pengaturan organisasi dan paket Enterprise aktif untuk menambah domain.
3. Masukkan hostname seperti updates.example.com, tanpa https://, path, atau wildcard.
4. Klik Tambah domain. Console akan menampilkan DNS record yang perlu dipublikasikan dan sebuah Menunggu verifikasi status.

Anda dapat mengonfigurasi satu hostname API Live Updates per organisasi. Anda harus memiliki akses untuk mengedit DNS record-nya.

Jika opsi Domain kustom tidak tersedia, hubungi kontak support Enterprise Anda atau kirim email ke support@capgo.app beserta detail organisasi, app ID, hostname yang diinginkan, dan provider DNS. Hubungi support juga sebelum setup jika Anda memerlukan region data residency tertentu atau custom hostname untuk download bundle.

Peringatan

DNS record saja tidak cukup untuk mengaktifkan custom domain. Routing dan HTTPS juga harus dikonfigurasi. Tunggu sampai Console menunjukkan Aktif, atau support mengonfirmasi aktivasi untuk setup berbantuan support, sebelum mengubah konfigurasi produksi.

2. Konfigurasi DNS dan verifikasi HTTPS

Di provider DNS Anda, tambahkan record yang tertera di Console atau yang diberikan oleh support. Salin tipe record, nama, dan value secara persis, termasuk CNAME dan record TXT untuk verifikasi kepemilikan atau sertifikat. Klik value di Console untuk menyalinnya. Jika Anda menggunakan Cloudflare DNS, biarkan CNAME DNS saja kecuali support mengonfirmasi pengaturan yang berbeda.

Gunakan target yang disediakan daripada berasumsi bahwa CNAME ke plugin.capgo.app sudah cukup. Biarkan record DNS tetap ada selama domain tersebut digunakan.

Setelah propagasi DNS selesai, klik Muat ulang status. Console menampilkan Aktif hanya jika hostname dan sertifikat HTTPS-nya sama-sama aktif; setelah itu menawarkan Salin konfigurasi updater. Untuk setup dengan bantuan support, minta support mengonfirmasi aktivasi. Anda juga bisa memeriksa DNS dan cek konektivitas TLS dengan:

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

Ganti updates.example.com dengan hostname yang telah disediakan. Perintah curl akan memeriksa konektivitas DNS, TLS, dan HTTP; permintaan GET ke /updates bukan merupakan pengecekan update yang valid dan mungkin menghasilkan error API. Verifikasi alur update yang sebenarnya menggunakan native test build pada langkah 4.

3. Konfigurasi updater

Setelah domain aktif, salin konfigurasi updater dari Console dan gabungkan ketiga URL tersebut ke dalam capacitor.config.ts. Untuk hostname dengan path standar Capgo API, gunakan:

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;

Ganti URL contoh dengan URL persis yang muncul di Console atau yang dikonfirmasi oleh support. Tetap gunakan pengaturan app dan opsi plugin lainnya.

Pengaturan	Tujuan
updateUrl	Mengecek ketersediaan bundle.
statsUrl	Melaporkan statistik update.
channelUrl	Menangani operasi channel perangkat.

Catatan

Pengaturan ini mengubah endpoint API. Download bundle menggunakan URL yang dikembalikan oleh server update, jadi mengubah pengaturan ini tidak secara otomatis memberikan custom domain pada download bundle. Pastikan persyaratan hostname download secara terpisah dengan tim support.

4. Sync, test, dan release

Sync konfigurasi ke dalam native project Anda:

npx cap sync

Build dan install versi native test, lalu:

1. Upload test bundle ke channel test menggunakan workflow Capgo Anda yang biasa.
2. Cek logs perangkat native untuk memverifikasi bahwa request update mencapai custom hostname Anda dan bundle berhasil di-download serta di-install.
3. Pastikan statistik update muncul di Console dan operasi test channel jika aplikasi Anda menggunakannya.
4. Rilis versi native app baru melalui proses distribusi store seperti biasa.

Peringatan

Perubahan pada capacitor.config.ts memerlukan native build. Mengunggah JavaScript bundle saja tidak akan menerapkan pengaturan ini ke instalasi iOS dan Android yang sudah ada. Pengguna baru akan menggunakan custom domain setelah menginstal versi native yang baru.

Instalasi native lama akan tetap menggunakan URL endpoint yang telah dikonfigurasi sampai pengguna menginstal versi native baru. Hostname default updater adalah plugin.capgo.app, yang dikelola oleh Capgo. Jika Anda bermigrasi dari custom hostname lain yang Anda kelola, pastikan DNS record dan servicenya tetap aktif sampai pengguna tersebut bermigrasi. Channels, bundle uploads, dan rollbacks akan tetap menggunakan Capgo Console dan workflow CLI Anda yang biasa.

Pemecahan Masalah

Untuk menghapus domain, gunakan Hapus domain → Konfirmasi penghapusan di Organization settings. Rilis versi native app menggunakan endpoint pengganti terlebih dahulu dan biarkan pengguna bermigrasi: instalasi lama akan kehilangan akses melalui hostname yang dihapus. Hapus domain sebelum menghapus organisasinya.

• DNS tidak ter-resolve: periksa kembali nama record dan target sesuai nilai dari support, serta cek propagasi pada provider DNS Anda.
• HTTPS gagal: minta support untuk mengecek aktivasi hostname dan provisioning sertifikat sebelum merilis native build.
• Request masih menggunakan plugin.capgo.app: konfirmasi ketiga URL tersebut, jalankan npx cap sync, rebuild, dan instal versi native yang baru.
• Download bundle menggunakan hostname lain: response update menyediakan URL download. Hubungi support untuk custom bundle delivery, atau lihat Penyimpanan Kustom jika Anda ingin mengelola penyimpanan bundle sendiri.
• Update gagal meski HTTPS sudah valid: bagikan app ID, channel, native version, request timestamp, dan native logs ke support Capgo.

Lihat Pengaturan Updater untuk referensi konfigurasi lengkap dan Lokasi Data untuk persyaratan endpoint regional.