Halaman App

Apa yang ditampilkan di halaman app?

Pertama, mari kita lihat halaman utama aplikasi:

Di Capgo, app mewakili aplikasi mobile Anda yang terintegrasi dengan sistem live update milik Capgo. Anda bisa mengelola update, channel, dan device dengan lancar.

Mari kita lihat lebih detail. Halaman utama app terbagi menjadi beberapa area utama:

1. Bilah Navigasi Atas: Memberikan akses ke tampilan manajemen app utama. Screenshot ini hanya ilustrasi; console saat ini mencakup:

   • Dashboard: Metrik dan ringkasan untuk app tersebut.
   • Observe (beta): Sinyal Native launch, WebView, issue, dan release-health.
   • Informasi: Pengaturan inti dan detail app (lihat Informasi Aplikasi).
   • Bundle: Versi dan rilis.
   • Channel: Channel update dan kontrol rollout bertahap.
   • Perangkat: Perangkat terdaftar dan override.
   • Logs: Wawasan Log dan raw logs.
   • Builds: Manajemen Native Build.

2. Tampilan statistik: Memvisualisasikan metrik penting untuk periode penagihan terakhir (data mencerminkan penggunaan sejak hari penagihan Anda, bukan tanggal 1 setiap bulan):

   • Pengguna Aktif Bulanan (8): Melacak jumlah pengguna aktif unik dari waktu ke waktu.
   • Penyimpanan (9): Menampilkan konsumsi storage saat ini.
   • Bandwidth (10): Menampilkan penggunaan bandwidth.
   • Bundle Aktif (11): Menampilkan distribusi perangkat aktif di berbagai app bundle.

3. Kartu Ringkasan: Memberikan ringkasan cepat untuk angka-angka kunci:

   • Upload Bundle (12): Total bundle aplikasi yang di-upload.
   • Statistik update (13): Jumlah total update yang dilakukan, termasuk request, instalasi, dan kegagalan.
   • Statistik deployment (14): Jumlah total deployment.

4. Opsi tampilan (15-18): Kontrol untuk memfilter dan melihat statistik:

   • Harian (15): Lihat statistik per hari.
   • Kumulatif (16): Lihat statistik kumulatif seiring waktu.
   • Periode penagihan (17): Lihat statistik untuk periode penagihan saat ini.
   • Rentang tanggal (18): Pilih rentang tanggal kustom (misalnya, 30 hari terakhir).

Informasi Aplikasi

Bagian ini sesuai dengan tab “Information” (1) di bilah navigasi atas. Di sini Anda dapat melihat dan mengelola detail serta pengaturan penting aplikasi Anda.

Halaman App Information

Tangkapan layar ini lebih lama dari konsol saat ini dan tidak menampilkan semua pengaturan terbaru. Gunakan deskripsi field di bawah sebagai acuan utama.

Berikut adalah rincian field dan aksi yang tersedia:

• Ikon Aplikasi (2): Menampilkan ikon aplikasi Anda. Anda bisa klik tombol “Change” untuk upload ikon baru.
• ID Aplikasi (3): ID unik untuk aplikasi Anda di dalam Capgo. ID ini tidak dapat diubah.
• Nama Aplikasi (4): Nama tampilan untuk aplikasi Anda. Anda dapat mengubahnya sesuai kebutuhan.
• Channel Upload Default (5): Menentukan channel default untuk upload bundle baru. Klik ikon edit untuk memilih channel default lain.
• Channel Download Default (6): Menentukan channel default tempat perangkat akan download update. Klik ikon edit untuk memilih channel default lain. Halaman channel menunjukkan apakah sebuah channel adalah default, tapi Anda mengubahnya di sini, bukan dengan toggle di channel. Buka channel dan klik Kelola di pengaturan aplikasi untuk langsung menuju field ini. Lihat bagian Konfigurasi Channel Default di bawah untuk informasi detail.
• Hapus Otomatis Bundle yang Tidak Digunakan (setelah x detik) (7): Pengaturan ini memungkinkan Anda menghapus otomatis bundle lama yang tidak digunakan selama durasi tertentu (dalam detik). Atur ke 0 untuk menonaktifkan penghapusan otomatis. Ini membantu mengelola penyimpanan dan menjaga daftar bundle tetap rapi.
• Tampilkan Metadata Bundle ke Plugin (8): Jika diaktifkan, field link dan komentar bundle akan dikirim ke plugin Capacitor Updater. Fitur ini memerlukan versi plugin 7.35.0 atau lebih tinggi.
• Blokir Permintaan Infrastruktur Provider: Jika diaktifkan, Capgo akan menolak permintaan update, statistik, dan channel-self dari rentang IP datacenter Google dan Apple yang dikenal. Biarkan aktif untuk lalu lintas produksi normal. Nonaktifkan sementara hanya jika Anda sengaja menguji dari infrastruktur provider. Aplikasi baru mengaktifkan perlindungan ini secara default; aplikasi yang sudah ada mempertahankan pengaturan nonaktif sebelumnya sampai Anda mengubahnya.
• Transfer Kepemilikan Aplikasi (9): Bagian ini menyediakan opsi untuk memindahkan aplikasi Anda ke organisasi lain yang Anda ikuti.
• Tombol Hapus Aplikasi: Menghapus aplikasi Anda secara permanen dari Capgo. Tindakan ini tidak dapat dibatalkan dan akan menghapus semua data, bundle, channel, dan perangkat terkait.
• Tombol Update: Menyimpan semua perubahan yang Anda buat pada field yang bisa diedit di halaman ini (misalnya, Nama Aplikasi, Channel Upload Default, pengaturan Hapus Bundle Otomatis).

Konfigurasi Channel Default

Panduan Channel Download Default adalah salah satu pengaturan terpenting untuk aplikasi Anda. Ini menentukan channel mana yang akan digunakan perangkat baru untuk menerima update saat pertama kali terhubung ke Capgo.

Cara Kerja Channel Default

Saat perangkat meminta update dari Capgo, sistem akan menentukan channel yang digunakan berdasarkan urutan prioritas berikut (prioritas tertinggi lebih dulu):

1. Pemetaan device paksa: Jika device ID secara eksplisit dipaksa ke channel tertentu di pengaturan channel, channel itulah yang selalu menang.
2. Override cloud: Jika perangkat telah ditugaskan ke channel tertentu dari dashboard atau Public API, override tersebut yang akan digunakan.
3. Plugin setChannel(): Pada versi plugin saat ini, ini adalah penugasan lokal, bukan override dashboard. Lihat Cara perangkat memilih channel.
4. Konfigurasi Capacitor defaultChannel: Jika diatur di capacitor.config.* file Anda, ini digunakan untuk build test/beta.
5. Channel Download Default: Pengaturan yang dikonfigurasi di sini. Ini yang akan digunakan sekitar 99% pengguna produksi Anda.

Channel Default Spesifik Platform

Anda dapat mengonfigurasi channel default spesifik platform—misalnya satu untuk iOS, satu untuk Android, dan satu untuk Electron. Ini berguna ketika:

• Anda ingin merilis update ke satu platform sebelum platform lainnya
• Anda membutuhkan strategi update yang berbeda untuk setiap platform
• Anda sedang menguji versi baru di satu platform sambil menjaga platform lainnya tetap stabil

Untuk mengatur default spesifik platform:

1. Buat channel terpisah untuk setiap platform (misalnya production-ios, production-android, dan production-electron)
2. Di pengaturan masing-masing channel, aktifkan hanya platform yang relevan (toggle iOS, Android, atau Electron)
3. Di Informasi Aplikasi, atur masing-masing channel tersebut sebagai Default Download Channel untuk platformnya. Capgo memungkinkan lebih dari satu default jika channel menargetkan platform yang berbeda.

Saat perangkat meminta update:

• Perangkat iOS akan menerima update dari channel default yang diaktifkan untuk iOS
• Perangkat Android akan menerima update dari channel default yang mendukung Android

Satu Channel Default (Direkomendasikan untuk Sebagian Besar Aplikasi)

Untuk sebagian besar aplikasi, satu channel default yang mendukung ketiga platform inti adalah pendekatan paling sederhana:

1. Buat satu channel (misalnya, production)
2. Pastikan toggle iOS, Android, dan Electron sudah aktif
3. Atur sebagai Default Download Channel pada Informasi Aplikasi

Ini memastikan perilaku konsisten di semua platform dan menyederhanakan workflow rilis Anda.

Mengubah Default Channel

Saat Anda mengubah channel default:

• Perangkat baru akan langsung mulai menerima update dari default baru
• Perangkat yang sudah ada yang sudah memiliki penugasan channel (via override atau force) TIDAK akan beralih secara otomatis
• Untuk memindahkan perangkat yang sudah ada, Anda perlu:
  • Gunakan setChannel() (atau unsetChannel()) dari aplikasi. Menghapus record perangkat di backend tidak akan menghapus setChannel() penugasan lokal.
  • Paksa mereka ke channel baru di dashboard (console/API override; kedaluwarsa setelah 90 hari)
  • Hapus override console/API mereka agar mengikuti prioritas. Perangkat yang hanya memiliki default cloud kemudian akan mengambil default baru.

Tips: Selalu uji channel default baru Anda dengan sekelompok kecil perangkat yang di-force sebelum menjadikannya default untuk semua user.

Lanjutkan dari App Page

Jika Anda menggunakan Halaman App untuk merencanakan operasi dashboard dan API, hubungkan dengan Ringkasan API untuk detail implementasi di API Overview, Pendahuluan untuk detail implementasi di Introduction, Kunci API untuk detail implementasi di API Keys, Perangkat untuk detail implementasi di Devices, dan Bundle untuk detail implementasi di Bundles.