Guida Manifest Privasi untuk Aplikasi Capacitor

Ingin meluncurkan Capacitor Aplikasi di App Store tanpa gangguan? Mulai dengan membuat Dokumen Privasi. Apple sekarang memerlukan pengembang untuk menyertakan dokumen ini untuk memastikan aplikasi memenuhi standar privasi yang ketat. Berikut ini yang perlu Anda ketahui:

Apa itu Dokumen Privasi?
Dokumen yang terstruktur yang menjelaskan praktik pengumpulan data aplikasi, API penggunaan, dan domain pelacakan.
Mengapa penting:
- Memenuhi aturan App Store untuk menghindari penolakan atau penghapusan.
- Membangun kepercayaan dengan menjadi transparan tentang pengelolaan data pengguna.
Komponen utama untuk disertakan:
- API yang mengakses data pengguna (misalnya, lokasi, foto).
- Label privasi untuk jenis data yang dikumpulkan.
- Mengikuti domain yang digunakan untuk analisis atau iklan.
Bagaimana cara membuat satu:
- Menggunakan JSON untuk mendefinisikan detail pengumpulan data.
- Tempatkan file di direktori yang benar dari proyek Anda. PrivacyInfo.xcprivacy Validasikan dengan alat seperti
- Xcode untuk menghindari kesalahan. Alat untuk memudahkan proses:
Menggunakan platform seperti
__CAPGO_KEEP_0__ Capgo __CAPGO_KEEP_1__ @capgo/capacitor-app-tracking-transparency menangani prompt iOS ATT dan @capgo/capacitor-firebase-analytics mendokumentasikan kumpulan data Firebase untuk tinjauan App Store.

Tetaplah patuh, lindungi privasi pengguna, dan hindari keterlambatan toko aplikasi dengan mengikuti panduan ini.

Dasar-Dasar Manifest Privasi

Definisi Manifest Privasi

Manifest privasi adalah file yang terstruktur yang menjelaskan praktik pengumpulan data aplikasi Anda. Ini menjelaskan elemen seperti API yang mengakses data pengguna, domain pelacakan, jenis data yang dikumpulkan, dan integrasi SDK pihak ketiga. Dokumen ini tidak hanya membantu membangun kepercayaan, tetapi juga memastikan keterpatuhan dengan pedoman App Store. Mari kita memecah komponen utama yang harus Anda inklusif dalam manifest Anda.

Elemen Utama Manifest Privasi

Berikut adalah elemen utama yang harus Anda inklusif dalam manifest privasi Anda untuk menyesuaikan dengan persyaratan Apple:

API Alasan Wajib
Bagian ini menyebutkan API yang sensitif privasi aplikasi Anda dan menjelaskan mengapa mereka diperlukan.

Berikut adalah tabel yang menyajikan persyaratan umum API:

API Kategori	Penggunaan umum	Dokumentasi yang diperlukan
Lokasi Layanan	Penggunaan navigasi	Deskripsi string dan penggunaan tujuan
Fotografi Perpustakaan	Foto profil	Level akses dan niat
Kontak	Sinkronisasi buku alamat	Pernyataan minimasi data

Label Privasi
Label-label ini menyediakan transparansi dengan menyebutkan:
- Jenis data yang dikumpulkan
- Alasan pengumpulan data
- Apakah data terkait dengan identitas pengguna
- Bagaimana data digunakan untuk pelacakan
Domain Pelacakan
Bagian ini menampilkan semua domain yang terlibat dalam pelacakan, seperti yang digunakan untuk analisis, iklan, atau pengolahan data pihak ketiga

“Kompatibel dengan App Store” - Capgo [1]

Menurut Capgo, 95% pengguna mematuhi pembaruan dalam waktu 24 jam. Dengan lebih dari 23,5 juta pembaruan yang disampaikan, menjaga dokumen privasi Anda tetap akurat sangat penting untuk mempertahankan kepercayaan pengguna. [1]Dengan lebih dari 23,5 juta pembaruan yang disampaikan, menjaga dokumen privasi Anda tetap akurat sangat penting untuk mempertahankan kepercayaan pengguna.

Membangun Manifest Privasi untuk Capacitor

Capacitor Dokumentasi Framework Website

Persyaratan Pengaturan

Sebelum Anda memulai membangun manifest, pastikan Anda telah:

Xcode 15 atau lebih baru terinstal
Proyek Capacitor 8.0+ yang telah disetel
Akses ke file aplikasi Anda Info.plist Arah file
Pemahaman dasar struktur JSON
Dokumentasi yang menjelaskan praktik pengumpulan data aplikasi Anda

Langkah Pembuatan

Mulai dengan membuat sebuah PrivacyInfo.xcprivacy file di direktori project iOS Anda. File ini harus mengikuti pedoman format yang spesifik:

Mengatur Informasi Dasar

{
    "NSPrivacyTracking": false,
    "NSPrivacyTrackingDomains": [],
    "NSPrivacyCollectedDataTypes": []
}

Mengatur Detail Pengumpulan Data

{
    "NSPrivacyAccessedAPITypes": [
        {
            "NSPrivacyAccessedAPIType": "NSLocationWhenInUseUsageDescription",
            "NSPrivacyAccessedAPITypeReasons": ["1.1"]
        },
        {
            "NSPrivacyAccessedAPIType": "NSCameraUsageDescription",
            "NSPrivacyAccessedAPITypeReasons": ["2.1"]
        }
    ]
}

Mengambahkan Domain Pelacakan

{
    "NSPrivacyTrackingDomains": [
        "analytics.yourdomain.com",
        "metrics.yourdomain.com"
    ]
}

Menghindari Kesalahan Umum

Untuk mencegah masalah, perhatikan tips berikut:

Termasuk Semua Bidang yang Diperlukan: Bahkan jika beberapa bidang kosong, mereka harus ada.
Menggunakan Tipe API yang Sah: Periksa identifikasi API dengan dokumen resmi Apple.
Mengecek Format JSON: Jalankan file Anda melalui JSON linter untuk menangkap kesalahan sintaks.
Berikan Alasan Lengkap: Pastikan setiap akses API termasuk alasan yang sesuai code.
Jaga Informasi Tetap Aktual: Pastikan manifest diperbarui setiap kali fitur baru ditambahkan.

Juga, pastikan file manifest tetap di bawah 512KB untuk menghindari kesalahan saat build. Validasi file secara teratur selama proses build Xcode untuk menangkap kesalahan sejak awal. Setelah manifest Anda siap, integrasikan ke dalam proyek Capacitor Anda dengan mengikuti pedoman penempatan file.

Menambahkan Manifest Privasi ke Capacitor

Pedoman Penempatan File

Untuk menambahkan manifest privasi ke proyek Capacitor, tempatkan file di struktur direktori berikut: PrivacyInfo.xcprivacy Untuk plugin __CAPGO_KEEP_0__, gunakan struktur berikut:

your-app/
├── ios/
│   ├── App/
│   │   ├── PrivacyInfo.xcprivacy
│   │   └── Info.plist
│   └── App.xcworkspace

For Capacitor plugins, use this structure:

your-plugin/
├── ios/
│   ├── Plugin/
│   │   └── PrivacyInfo.xcprivacy
│   └── Plugin.xcodeproj

__CAPGO_KEEP_0__

Setelah file tersebut berada di tempat, update pengaturan build Xcode Anda untuk memastikan integrasi yang tepat:

Buka proyek Anda di Xcode.
Di bawah TARGETS, pilih target aplikasi atau plugin Anda.
Pergi ke tab Pengaturan Build .
Set Wilayah Pengembangan Manifest Privasi ke en.
Set Termasuk Manifest Privasi ke YES.

Jika proyek Anda menggunakan CocoaPods, masukkan kode berikut ke dalam Podfile untuk mengaktifkan manifest privasi:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['INCLUDE_PRIVACY_MANIFEST'] = 'YES'
    end
  end
end

Setelah melakukan perubahan-perubahan ini, lanjutkan dengan pengecekan implementasi untuk memastikan semuanya sudah terkonfigurasi dengan benar.

Pengecekan Implementasi

Untuk memastikan manifest privasi berfungsi sebagaimana mestinya, ikuti langkah-langkah berikut:

Pengecekan Pembangunan
- Pastikan tidak ada peringatan privasi terkait selama proses pembangunan.
- Pastikan manifest dapat dikompilasi tanpa masalah.
- Pastikan manifesto privasi termasuk dalam produk pembangunan.
Validasi Waktu Eksekusi
- Pada mode debug, lakukan pengujian untuk prompt privasi yang tepat dan perilaku akses API.
Validasi Koneksi App Store
- Unggah pembangunan Anda dan tinjau Laporan Privasi di App Store Connect.
- Pastikan deklarasi API lengkap dan format domain pelacakan benar.

Jika Anda mengalami kesalahan “Validasi Manifest Privasi gagal”, periksa kembali manifesto Anda untuk memastikan bahwa itu memenuhi persyaratan App Store terbaru. Berikan perhatian khusus pada jenis API dan pengaturan domain pelacakan.

Perubahan Manifest Privasi Apple

Pengujian dan Perbaikan

Membuat Manifest Privasi yang memenuhi pedoman Apple sangat penting. Untuk tetap pada jalur, integrasikan pengawasan kesalahan yang dapat diandalkan ke dalam proses pengembangan Anda. Ini membantu menghubungkan upaya pengembangan dengan persyaratan kompatibilitas.

Alat seperti Capgo dapat membantu. Ini memantau akses API dan mengidentifikasi masalah manifest sebelum mereka mempengaruhi pengguna. Setelah masalah potensial ditandai, Anda dapat memindahkan fokus ke validasi yang lebih mendalam.

Setelah membuat perubahan, tes manifest Anda di lingkungan pengembangan. Gunakan wawasan dari pelacakan kesalahan untuk mengarahkan ulasan Anda. Pendekatan ini membantu memastikan aplikasi Anda tetap sejalan dengan standar privasi Apple.

Capgo Alat Privasi

Capgo Dashboard Interface Pembaruan Hidup

Capgo memudahkan mengelola manifest privasi dan pembaruan aplikasi, memastikan standar privasi Anda tetap utuh tanpa menunda peluncuran.

Capgo Fitur

Dengan lebih dari 23,5 juta pembaruan yang terlindungi dan sukses global 82%Menggunakan Capgo memastikan bahwa 95% pengguna aktif menerima pembaruan dalam waktu 24 jam [1]. Berikut ini adalah apa yang ditawarkan:

Enkripsi akhir ke akhir untuk menjaga pembaruan tetap aman
Sistem saluran untuk distribusi pembaruan yang terkendali
Pengenalan kesalahan untuk mengidentifikasi dan menangani masalah dengan cepat
Rollback satu-klik untuk langsung kembali ke versi sebelumnya

Alat-alat ini membuat menambahkan Capgo ke alur kerja Anda menjadi hal yang halus dan efisien.

Menggunakan Capgo

Untuk memulai, instal plugin Capgo dengan perintah ini:

npx @capgo/cli init

Capgo secara otomatis mengintegrasikan dengan pipeline CI/CD, mengotomatisasi validasi manifesto privasi melalui platform seperti GitHub Actions, GitLab CI, atau Jenkins. Apapun pilihan Anda antara cloud atau self-hosted, Capgo mendukung 750 aplikasi produksi sambil memastikan setiap update memenuhi standar privasi.

“Kami menerapkan pengembangan agile dan @Capgo sangat kritis dalam menyampaikan kontinuously kepada pengguna kami!” – Rodrigo Mantica

“Capgo adalah cara pintar untuk membuat push code yang cepat 🙂” – NASA’s OSIRIS-REx

Capgo juga termasuk analitis bawaan untuk memantau tingkat kesuksesan pembaruan dan partisipasi pengguna secara real-time. Hal ini memastikan pembaruan privasi mencapai basis pengguna Anda secara keseluruhan sambil tetap memenuhi pedoman Apple.

Kesimpulan

Poin Utama

Ketika mengelola manifest privasi, memastikan kinerja yang baik dan menjaga keamanan yang kuat sangat penting. Berikut adalah hal yang paling penting:

Enkripsi Akhir ke Akhir: Membuat pembaruan tetap aman dari awal hingga akhir.
Pengawasan Real-time: Membantu mengikuti distribusi pembaruan dengan efektif.
Fungsi Rollback Instan: Berfungsi sebagai jaringan keselamatan untuk perbaikan cepat.
Validasi Otomatis: Memastikan pembaruan Anda memenuhi standar komplian.

Membangun sistem pembaruan yang dapat diandalkan membantu Anda tetap memenuhi persyaratan privasi yang terus berkembang dari Apple dan Google. Pendekatan ini telah terbukti meningkatkan tingkat persetujuan toko aplikasi dan memperkuat kepercayaan pengguna [1].

Bagaimana Membuat Awalan

Anda dapat memulai menerapkan prinsip-prinsip ini dengan mengikuti langkah-langkah berikut:

Konfigurasi lingkungan Anda: Jalankan npx @capgo/cli init untuk memulai.
Aktifkan fitur privasi: Gunakan enkripsi akhir-ke-akhir untuk pembaruan yang aman.
Deploy alat monitoring: Ikuti pembaruan dengan analitik.
Rencanakan rollback: Pastikan Anda dapat kembali ke versi sebelumnya jika diperlukan.

“Capgo adalah alat yang wajib dimiliki oleh para pengembang yang ingin meningkatkan produktivitas. Menghindari penundaan ulasan untuk memperbaiki bug adalah perubahan permainan.” - Bessie Cooper

Pembaruan reguler dan alat yang tepat adalah kunci untuk tetap kompatibel dan meningkatkan waktu.

Teruskan dari Manifest Privasi untuk Aplikasi Capacitor: Panduan

Jika Anda menggunakan Manifest Privasi untuk Aplikasi Capacitor: Panduan untuk merencanakan keamanan dan kompatibilitas, hubungkannya dengan Enkripsi untuk detail implementasi di Enkripsi, Kompatibilitas untuk detail implementasi di Kompatibilitas, Scanner Keamanan Capgo untuk alur kerja produk di Scanner Keamanan Capgo, Keamanan Capgo untuk alur kerja produk di Keamanan Capgo dan Tengah Kepercayaan Capgo untuk alur kerja produk di Tengah Kepercayaan Capgo.