Cara Menggunakan Dokumentasi Capgo untuk Perbarui Perangkat Lunak

Perlu perbarui aplikasi Anda lebih cepat Perbarui Aplikasi tanpa penundaan toko aplikasi? Capgo Memungkinkan Anda mengirimkan pembaruan Over-the-Air (OTA) yang aman secara instan kepada pengguna Anda. Lebihkan, lewati ulasan toko aplikasi dan pastikan aplikasi Anda tetap terupdate dengan mudah.

Kunci Pemahaman Utama:

• Apa itu Capgo? Platform terbuka untuk pembaruan hidup di Capacitor Aplikasi.
• Mengapa Pembaruan OTA? Simpan waktu, perbaiki pengalaman pengguna, dan perbaiki bug dengan cepat.
• Cara Memulai?
  • Instal Capgo plugin: npm install @capgo/capacitor-updater
  • Konfigurasi aplikasi Anda dengan kunci API.
  • Menggunakan saluran seperti “produksi” atau “beta” untuk peluncuran yang sasaran.
• Fitur Membangun: Enkripsi akhir-ke-akhir, pengelolaan kesalahan, dan integrasi CI/CD.

Capgo’s dokumentasi (capgo.app/docs) menyediakan instruksi langkah demi langkah untuk pengaturan, keamanan, dan troubleshooting. Dari instalasi hingga pengaturan lanjutan, itu adalah panduan Anda untuk pembaruan yang lancar.

Capgo__CAPGO_KEEP_0__

Memanfaatkan Dokumentasi Capgo

Mengemudi Dokumentasi dengan Efektif adalah Penting ketika bekerja dengan Update OTA. Dokumentasi Capgo menawarkan panduan yang rinci untuk mengintegrasikan update live ke dalam aplikasi Capacitor.

Di Mana Anda Bisa Menemukan Dokumentasi

Anda dapat mengakses Dokumentasi Capgo di capgo.app/docs [1]. Dokumentasi ini terorganisir berdasarkan tujuan tertentu:

Kata-kata penting dan konsep

Berikut beberapa istilah penting yang akan Anda temui:

• Salurancontext: Nama fitur saluran rilis Capgo. Halaman/area: Halaman pemasaran solusi Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman solusi/white-label.astro. Kunci pesan `solutions_white_label_visual_cell2_value` (Nilai Sel Visual Putih Label Solusi). [4].
• : Ini adalah aliran pembaruan yang digunakan untuk mengontrol distribusi versi. Misalnya, Anda mungkin mengatur "produksi", "beta", dan "staging" saluran untuk memenuhi kebutuhan kelompok pengguna yang berbedaKebijakan Pembaruan [1].
• : Ini menentukan bagaimana pembaruan disampaikan dan diterapkan. Pilihan termasuk download otomatis, waktu instalasi, dan permintaan penggunaPenggunaan Negara Aplikasi [4].
• : Komponen ini mengikuti apakah aplikasi berada di latar depan atau latar belakang: Packaged update files containing your app’s new version, including assets, code changes, and configuration updates [4].

: File pembaruan yang dikemas yang berisi versi aplikasi baru, termasuk aset, Code perubahan, dan update konfigurasi

Dokumentasi menyediakan contoh code untuk memudahkan integrasi. Berikut adalah contoh dasar menggunakan TypeScript/JavaScript:

import { CapacitorUpdater } from '@capgo/capacitor-updater'

// Initialize the updater
await CapacitorUpdater.notifyAppReady()

Untuk kasus penggunaan yang lebih maju, dokumen ini mencakup contoh nyata [2][3], seperti:

• Mengganti saluran untuk tes A/B
• Alur pembaruan kustom dengan permintaan pengguna
• Mengatasi kesalahan dan menerapkan ulang
• Mengintegrasikan pembaruan dengan alur CI/CD

Setiap tutorial juga menyoroti pertimbangan kinerja dan aspek keamanan, membantu Anda membuat keputusan yang tepat. Dokumen ini sering diperbarui untuk mencakup fitur terbaru dan praktik terbaik [1].

Untuk detail implementasi, cek panduan pengaturan berikutnya.

Mengatur Pembaruan OTA

Atur pembaruan OTA di Capgo untuk mempercepat proses pengiriman Anda. Ikuti langkah-langkah dan tips ini untuk pengaturan yang tanpa masalah.

Langkah-Langkah Pengaturan Dasar

Mulai dengan menginstal plugin Capgo di proyek Capacitor Anda:

npm install @capgo/capacitor-updater
npx cap sync

Selanjutnya, update file Anda dengan kunci __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ Anda: capacitor.config.json Lalu, inisialisasi pembaruan di file utama aplikasi Anda untuk mendeteksi pembaruan: Capgo API key:

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true,
      "apiKey": "YOUR_API_KEY_HERE"
    }
  }
}

Pengaturan Saluran Pembaruan

import { CapacitorUpdater } from '@capgo/capacitor-updater';
await CapacitorUpdater.notifyAppReady();

Organisir saluran pembaruan Anda untuk memenuhi kebutuhan pengiriman Anda:

Jenis Saluran Pembaruan

Tujuan context: Halaman/area: Situs web pemasaran Capgo. Peran: Label UI pendek atau item navigasi. Kunci pesan `subprocessors_table_purpose` (Tujuan Tabel Subproses) Pengaturan Saluran Pembaruan

Untuk mengunggah pembaruan ke saluran tertentu, gunakan Capgo CLI:

npx @capgo/cli upload -c production

Metode Perbarui

Capgo menyediakan dua cara utama untuk mengelola perbarui:

Perbarui Otomatis Aktifkan perbarui otomatis dengan mengatur autoUpdate: true dalam konfigurasi Anda. Hal ini memastikan perbarui diterapkan di latar belakang dengan tidak ada upaya tambahan dari pengembang.

Perbarui Tangan Untuk kontrol yang lebih baik, Anda dapat mengelola perbarui secara manual. Gunakan pola berikut untuk memeriksa dan menerapkan perbarui:

// Check for updates
const update = await CapacitorUpdater.download();

// Install when ready
if (update) {
  await CapacitorUpdater.set(update);
}

Untuk perbarui kritis, Anda dapat meminta pengguna sebelum melanjutkan:

if (update.version > currentVersion) {
  const userConsent = await showUpdatePrompt();
  if (userConsent) {
    await CapacitorUpdater.set(update);
  }
}

Anda juga dapat menargetkan kelompok pengguna tertentu dengan ID dan saluran yang disesuaikan:

await CapacitorUpdater.setCustomId('beta-tester-123');
await CapacitorUpdater.setChannel('beta');

Terakhir, pastikan untuk mencakup pengelolaan kesalahan dan opsi rollback:

try {
  await CapacitorUpdater.set(update);
} catch (error) {
  await CapacitorUpdater.reset(); // Revert to the last working version
  console.error('Update failed:', error);
}

Dengan langkah-langkah ini, sistem perbarui OTA Anda sudah siap. Eksplorasi pengaturan lanjutan untuk mengcustomisasi proses perbarui lebih lanjut.

sbb-itb-f9944d2

Konfigurasi Lanjutan

Perbaiki pengaturan Anda Capgo Perbarui OTA setup dengan tambahan keamanan dan konfigurasi pembaruan fleksibel. Opsi-opsi ini memastikan pengalaman pembaruan yang aman dan lancar sambil memenuhi pedoman toko aplikasi.

Fitur Keamanan

Capgo menyediakan protokol keamanan yang kuat untuk melindungi bundle pembaruan Anda dan mengirimkannya secara aman kepada pengguna. Platform ini menggunakan enkripsi akhir-ke-akhir dengan kriptografi kunci publik untuk semua pembaruan. [1]. Berikut adalah cara Anda dapat mengaktifkan fitur keamanan utama:

// Enable bundle verification
await CapacitorUpdater.setVerifyBundles(true);

// Configure encryption settings
await CapacitorUpdater.configure({
  encryption: {
    enabled: true,
    failOnError: true
  }
});

Komponen Utama Sistem Perlindungan Bundle termasuk:

Pengaturan perilaku update

Anda dapat menyesuaikan cara update disampaikan dan diinstal dengan menggunakan pemangku jawab dan opsi konfigurasi. Sesuaikan waktu dan interaksi pengguna untuk update dengan pengaturan ini:

// Listen for when an update is available
CapacitorUpdater.addListener('updateAvailable', async (info) => {
  if (info.version > currentVersion) {
    // Custom update logic based on app state
    const isAppInactive = await checkAppState();
    if (isAppInactive) {
      await CapacitorUpdater.download();
    }
  }
});

// Monitor download completion
CapacitorUpdater.addListener('downloadComplete', (info) => {
  console.log(`Update ${info.version} ready to install`);
  // Implement custom installation timing if desired
});

Untuk peluncuran fase, Anda dapat mengonfigurasi distribusi update secara langsung melalui dashboard atau dengan code:

// Set custom update conditions for a gradual rollout
await CapacitorUpdater.configure({
  rollout: {
    percentage: 25, // Start with 25% of users
    timeInterval: 24 // Increase rollout percentage every 24 hours
  }
});

Untuk mengelola perilaku versi tertentu:

// Handle version-specific update failures
CapacitorUpdater.addListener('updateFailed', async (info) => {
  if (info.error.code === 'VERSION_MISMATCH') {
    await CapacitorUpdater.reset(); // Revert to the last stable version
    // Optionally, handle error notification here
  }
});

Konfigurasi ini memastikan pembaruan dapat diandalkan sambil memungkinkan Anda menyesuaikan proses dengan kebutuhan aplikasi Anda. Selalu lakukan tes pembaruan secara menyeluruh di lingkungan pengujian Capgo sebelum mengimplementasikannya ke produksi. [2].

Pedoman Mengatasi Masalah

Capgo’s log kesalahan dan alat bawaan membantu menangani tantangan pembaruan OTA sambil memastikan aplikasi Anda sesuai dengan persyaratan toko.

Masalah Umum dan Solusi

Berikut beberapa masalah umum dan cara menanganinya:

• Gagal Download Gejala: Download terhenti atau gagal selesai. Solusi: Periksa koneksi jaringan, pastikan URL pembaruan valid, dan tambahkan mekanisme ulang untuk mengatasi gangguan.

• Konflik Versi Gejala : Pembaruan gagal terpasang atau menyebabkan ketidakstabilan aplikasi. Solusi : Gunakan nomor versi yang jelas untuk menghindari konflik dan implementasikan opsi rollback untuk keamanan.

• Masalah Pemasangan Gejala : Pembaruan gagal atau memicu rollbacks otomatis. Solusi : Pastikan Anda memanggil notifyAppReady() setelah pembaruan sukses untuk mencegah rollbacks.

Untuk pembaruan yang lebih besar dari 50MB, membaginya menjadi file yang lebih kecil dapat meningkatkan kinerja pada perangkat Android [5].

Penggunaan log kesalahan yang rinci untuk menangkap masalah-masalah sejak awal. Misalnya, implementasikan listener ini:

CapacitorUpdater.addListener('updateFailed', (error) => {
  console.log(`Update failed: ${error.code}`);
  logUpdateError({
    errorCode: error.code,
    deviceInfo: error.device,
    timestamp: new Date().toISOString()
  });
});

Dengan menggabungkan log kesalahan dengan pra-pemeriksaan, Anda dapat menangani masalah-masalah ini secara efektif sebelum fokus pada kinerja.

Aturan App Store

Perbaikan teknis saja tidak cukup - perbarui Anda juga perlu menyesuaikan dengan pedoman app store.

Persyaratan App Store Apple:

• Transparansi Pengguna: Jelaskan dengan jelas kepada pengguna tentang isi perbarui dan dapatkan persetujuan mereka.
• Fungsi Utama: Pastikan fitur utama aplikasi Anda tetap utuh seperti yang telah diverifikasi.
• Pengamanan: Gunakan metode yang aman untuk mengirimkan perbarui.

Penerapan Android:

await CapacitorUpdater.configure({
  updateNotification: {
    title: "Update Available",
    message: "A new version is available. Please update to access the latest features.",
    requireUserConsent: true
  }
});

Praktik Terbaik:

• Pengendalian Versi : Rilis pembaruan secara bertahap untuk mengurangi konflik.
• Update Notifications : Berikan peringatan pembaruan yang jelas dan ramah pengguna.
• Keamanancontext

Halaman/area: Halaman produk/harga bisnis. Peran: Label UI. Dilihat di: halaman enterprise.astro. Pesan kunci `enterprise_hero_security_label` (Label Keamanan Hero Bisnis).

: Verifikasi integritas bundle dan gunakan enkripsi untuk melindungi data.

Capgo’s documentation provides clear instructions for integrating OTA updates into Capacitor apps while staying compliant with app store regulations.

Using Capgo’s resources, developers can implement essential features like __CAPGO_KEEP_0__’s dokumentasi menyediakan instruksi yang jelas untuk mengintegrasikan pembaruan OTA ke dalam aplikasi __CAPGO_KEEP_1__ sambil tetap memenuhi regulasi toko aplikasi. Menggunakan __CAPGO_KEEP_0__’s sumber daya, pengembang dapat menerapkan fitur penting seperti enkripsi akhir-ke-akhir (end-to-end encryption) dan, contextMeliputi semua dari pengaturan awal hingga pengaturan lanjutan [1].

Area Implementasi Utama

Area-area ini membentuk tulang punggung sistem pengelolaan perbarui Capgo.

Capgo dan alat-alat analitik CLI memudahkan Pengelolaan Perbarui selama siklus hidup aplikasi Anda [1].

Dukungan lebih lanjut dapat Anda temukan di sumber daya tambahan seperti API dokumentasi, projek contoh, dan forum komunitas [2].

Teruslah dari Cara Menggunakan Capgo Dokumentasi untuk Perbarui OTA

Jika Anda menggunakan Cara Menggunakan Capgo Dokumentasi untuk Perbarui OTA untuk merencanakan keamanan dan kewenangan, hubungkannya dengan Enkripsi untuk detail implementasi di Enkripsi, Kewenangan untuk detail implementasi di Compliance, Capgo Scanner Keamanan untuk alur produk di Capgo Scanner Keamanan, Capgo Keamanan untuk alur produk di Capgo Keamanan, dan Capgo Pusat Kepercayaan untuk alur produk di Capgo Pusat Kepercayaan.