Ingin meluncurkan Capacitor aplikasi Anda di Toko Aplikasi Apakah tanpa gangguan? Mulai dengan membuat Dokumen Privasi. Apple sekarang memerlukan pengembang untuk mencantumkan dokumen ini untuk memastikan aplikasi memenuhi standar privasi yang ketat. Berikut ini yang perlu Anda ketahui:
-
Apa itu Dokumen Privasi?
File yang terstruktur yang menjelaskan praktik pengumpulan data aplikasi, penggunaan API, dan domain pelacakan. -
Mengapa penting:
- Mengikuti aturan App Store untuk menghindari penolakan atau penghapusan.
- Membangun kepercayaan dengan menjadi transparan tentang pengelolaan data pengguna.
-
Komponen utama untuk dicantumkan:
- API yang mengakses data pengguna (misalnya, lokasi, foto).
- Label privasi untuk jenis data yang dikumpulkan.
- Domain pelacakan yang digunakan untuk analisis atau iklan.
-
Cara membuat satu:
- Gunakan JSON untuk mendefinisikan detail pengumpulan data.
- Tempatkan
PrivacyInfo.xcprivacyfile di direktori yang benar dari proyek Anda. - Validasikan dengan alat seperti Xcode untuk menghindari kesalahan.
-
Alat untuk memudahkan proses:
Pakai platform seperti Capgo untuk validasi manifesto privasi otomatis, pembaruan waktu nyata, dan pengawasan kesalahan.
Tetaplah kompatibel, lindungi privasi pengguna, dan hindari penundaan toko aplikasi dengan mengikuti panduan ini.
Dasar-Dasar Manifest Privasi
Definisi Manifest Privasi
Manifest privasi adalah sebuah file yang terstruktur yang menjelaskan praktik data aplikasi Anda. Hal ini menjelaskan elemen-elemen seperti API yang mengakses data pengguna, domain pelacakan, jenis data yang dikumpulkan, dan integrasi ketiga pihak SDK.
Dokumen ini tidak hanya membantu membangun kepercayaan, tetapi juga memastikan kesesuaian dengan pedoman App Store.
Mari kita analisis komponen utama yang harus ada dalam manifest Anda.
-
Elemen Utama Manifest Privasi
Berikut adalah elemen utama yang harus ada dalam manifest privasi Anda untuk sesuai dengan persyaratan Apple:Below is a table summarizing common API requirements:
API Category Tabel di bawah ini menjelaskan persyaratan __CAPGO_KEEP_0__ yang umum: __CAPGO_KEEP_0__ Kategori Penggunaan Umum Dokumentasi yang Diperlukan Deskripsi string dan penggunaan Fotografi Perpustakaan Foto Profil Level akses dan niat Kontak Sinkronisasi buku alamat Pernyataan minimasi data -
Label Privasi
Label-label ini memberikan transparansi dengan menyebutkan:- Jenis data yang dikumpulkan
- Alasan pengumpulan data
- Apakah data terkait dengan identitas pengguna
- How data ini digunakan untuk pelacakan
-
Pelacakan Domain
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 [1]mengembanikan dokumen privasi Anda tetap akurat sangat penting untuk menjaga kepercayaan pengguna.
Membangun Manifest Privasi untuk Capacitor
Persyaratan Pengaturan
Sebelum Anda memulai membangun manifest, pastikan Anda telah:
- Xcode 15 atau lebih baru terinstal
- Proyek Capacitor yang berbasis 8.0+ telah diatur
- Akses ke aplikasi Anda
Info.plistfile - Pemahaman dasar tentang struktur JSON
- Dokumentasi yang menjelaskan praktik pengumpulan data aplikasi Anda
Langkah-Langkah Pembuatan
Mulai dengan membuat sebuah PrivacyInfo.xcprivacy file di direktori proyek iOS Anda. File ini harus mengikuti pedoman format yang spesifik:
Konfigurasi Informasi Dasar
{
"NSPrivacyTracking": false,
"NSPrivacyTrackingDomains": [],
"NSPrivacyCollectedDataTypes": []
}Tentukan Detail Pengumpulan Data
{
"NSPrivacyAccessedAPITypes": [
{
"NSPrivacyAccessedAPIType": "NSLocationWhenInUseUsageDescription",
"NSPrivacyAccessedAPITypeReasons": ["1.1"]
},
{
"NSPrivacyAccessedAPIType": "NSCameraUsageDescription",
"NSPrivacyAccessedAPITypeReasons": ["2.1"]
}
]
}Tambahkan Domain Pelacakan
{
"NSPrivacyTrackingDomains": [
"analytics.yourdomain.com",
"metrics.yourdomain.com"
]
}Menghindari Kesalahan Umum
To prevent issues, keep these tips in mind:
- Termasuk Semua Bidang Wajib: Bahkan jika beberapa bidang kosong, mereka harus ada.
- Gunakan Tipe API yang Sah: Periksa kembali identifikasi API dengan dokumen resmi Apple.
- Periksa Format JSON: Jalankan file Anda melalui linter JSON untuk menangkap kesalahan sintaks.
- Berikan Alasan yang Lengkap: Pastikan setiap akses API termasuk alasan code yang sesuai.
- Jaga Informasi Tetap Aktual: Perbarui manifest setiap kali fitur baru ditambahkan.
Selain itu, pastikan file manifest tetap di bawah 512KB untuk menghindari kesalahan saat build. Validasi file secara teratur selama proses build Xcode untuk menangkap kesalahan awal. Setelah manifest Anda siap, integrasikan ke proyek Capacitor Anda dengan mengikuti pedoman penempatan file.
Menambahkan Manifest Privasi ke Capacitor
Panduan Penempatan File
Untuk mencakup manifest privasi dalam proyek Capacitor Anda, 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.xcworkspaceFor Capacitor plugins, use this structure:
your-plugin/
├── ios/
│ ├── Plugin/
│ │ └── PrivacyInfo.xcprivacy
│ └── Plugin.xcodeprojSaat file sudah berada di tempat, update pengaturan pengembangan Xcode Anda untuk memastikan integrasi yang tepat:
Buka proyek Anda di Xcode.
- Di bawah
- TARGETS , pilih target aplikasi atau plugin Anda.Pergi ke
- Build Settings Pengaturan Pembangunan tab.
- Atur Manifest Privasi Pengembangan Wilayah ke
en. - Atur Termasuk Manifest Privasi ke
YES.
Jika proyek Anda menggunakan CocoaPods, termasuk kode berikut 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
endSetelah 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:
-
Verifikasi Pembangunan
- Pastikan tidak ada peringatan privasi terkait selama proses pembangunan.
- Pastikan manifest tidak mengalami masalah saat kompilasi.
- Verifikasi bahwa manifest privasi sudah termasuk dalam produk pembangunan.
-
Validasi Waktu Jalannya
- Dalam mode debug, lakukan tes untuk memastikan prompt privasi yang tepat dan perilaku akses API.
-
Validasi App Store Connect
- Unggah build Anda dan tinjau Laporan Privasi di App Store Connect.
- Periksa bahwa deklarasi API sudah lengkap dan format domain pelacakan sudah benar.
If Anda mengalami kesalahan 'Privacy Manifest validation failed', pastikan manifesto Anda memenuhi persyaratan App Store terbaru. Perhatikan khususnya jenis API dan pengaturan domain pelacakan.
Perubahan Manifest Privasi Apple
Pengujian dan Perbaikan
Membuat Manifest Privasi yang memenuhi pedoman Apple sangat penting. Untuk tetap berada di jalur yang benar, integrasikan pengawasan kesalahan yang dapat diandalkan ke dalam proses pengembangan. Hal ini membantu menghubungkan upaya pengembangan dengan persyaratan kompatibilitas.
Alat seperti Capgo dapat membantu. Alat ini memantau akses API dan mengidentifikasi masalah manifesto sebelum mereka mempengaruhi pengguna. Setelah potensi masalah ditandai, Anda dapat memindahkan fokus ke validasi yang lebih menyeluruh.
Setelah membuat perubahan, uji manifesto Anda di lingkungan pengembangan. Gunakan wawasan dari pengawasan kesalahan untuk mengarahkan ulasan Anda. Pendekatan ini membantu memastikan aplikasi Anda tetap sejalan dengan standar privasi Apple.
Capgo Alat Privasi
Capgo memperluas pengelolaan manifesto privasi dan pembaruan aplikasi, sehingga standar privasi Anda tetap utuh tanpa mengganggu proses peluncuran.
Capgo Fitur
Dengan lebih dari 23,5 juta pembaruan yang aman dan sukses global sebesar 82%, 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 dikendalikan
- Pengawasan Error untuk mengidentifikasi dan menangani masalah dengan cepat
- Rollback satu-klik untuk kembali ke versi sebelumnya secara instan
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 initCapgo secara otomatis mengintegrasikan dengan pipeline CI/CD, mengotomatisasi validasi manifesto privasi melalui platform seperti Capgo Actions GitHub, GitLab CI, atau Jenkins. Whether you choose cloud or self-hosted options, Capgo supports 750 production apps while ensuring every update complies with privacy standards.
“We practice agile development and @Capgo is mission-critical in delivering continuously to our users!” – Rodrigo Mantica
“Capgo is a smart way to make hot code pushes 🙂” – NASA’s OSIRIS-REx
Capgo also includes built-in analytics to monitor update success rates and user engagement in real time. This ensures privacy updates reach your entire user base while staying compliant with Apple’s guidelines.
Kesimpulan
Poin Utama
Ketika mengelola manifest privasi, memastikan kinerja yang kuat dan mematuhi standar keamanan sangat penting. Berikut yang paling penting:
- Enkripsi akhir-ke-akhir: Membuat update aman dari awal hingga akhir.
- Pemantauan waktu nyata: Mengikuti distribusi perbaruan secara efektif.
- Kemampuan rollback instan: Berfungsi sebagai jaring pengaman untuk perbaikan cepat.
- Validasi otomatis: Menjamin perbaruan Anda memenuhi standar kompatibilitas.
Membangun sistem perbaruan yang dapat diandalkan membantu Anda tetap kompatibel dengan persyaratan privasi Apple dan Google yang terus berkembang. Pendekatan ini telah terbukti meningkatkan tingkat persetujuan toko aplikasi dan memperkuat kepercayaan pengguna [1].
Cara Memulai
Anda dapat memulai menerapkan prinsip-prinsip ini dengan mengikuti langkah-langkah berikut:
- Konfigurasi lingkungan Anda: Jalankan
npx @capgo/cli inituntuk memulai. - aktifkan fitur privasi: Gunakan enkripsi akhir-ke-akhir untuk pembaruan yang aman.
- Jalankan alat pemantauan: Ikuti pembaruan dengan analitis.
- Rencanakan untuk mengembalikan: Pastikan Anda dapat dengan cepat kembali ke versi sebelumnya jika diperlukan.
“Capgo adalah alat yang wajib dimiliki oleh para pengembang yang ingin meningkatkan produktivitas. Menghindari keterlambatan ulasan untuk perbaikan bug adalah perubahan permainan.” - Bessie Cooper
Pembaruan reguler dan alat yang tepat adalah kunci untuk tetap kompatibel dan meningkatkan waktu.
Teruskan dari Dokumen Manifestasi Privasi untuk Aplikasi Capacitor: Panduan
Jika Anda menggunakan Dokumen Manifestasi Privasi untuk Aplikasi Capacitor: Panduan untuk merencanakan keamanan dan kompatibilitas, hubungkannya dengan Enkripsi untuk detail implementasi di Enkripsi, Kemampuan Kompatibilitas untuk detail implementasi di Kemampuan Kompatibilitas, Capgo Scanner Keamanan untuk alur kerja produk di Capgo Scanner Keamanan, Capgo Keamanan untuk alur kerja produk di Capgo Keamanan, dan Capgo Pusat Kepercayaan untuk alur kerja produk di Capgo Pusat Kepercayaan.
