Ingin meluncurkan aplikasi Capacitor anda di App Store tanpa hambatan? Mulai dengan membuat Manifest 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 Manifest Privasi?
-
Sebuah file yang terstruktur yang menjelaskan praktik pengumpulan data aplikasi, penggunaan __CAPGO_KEEP_0__ , dan domain pelacakan.
A structured file outlining your app’s data collection practices, API usage, and tracking domains. -
Mengikuti aturan App Store untuk menghindari penolakan atau penghapusan.
- What is a Privacy Manifest? is not present in the texts array so it is not translated
- Membangun kepercayaan dengan transparan tentang pengelolaan data pengguna.
-
Komponen kunci untuk termasuk:
- 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:
- Pakai JSON untuk mendefinisikan detail pengumpulan data.
- Tempatkan file di direktori yang benar dari proyek Anda.
PrivacyInfo.xcprivacyValidasi dengan alat seperti - Xcode untuk menghindari kesalahan. __CAPGO_KEEP_0__
-
Alat-alat untuk memudahkan proses:
Pakai platform seperti Capgo untuk validasi manifesto privasi otomatis, pembaruan waktu nyata, dan pengawasan kesalahan. Ketika manifesto Anda menyatakan SDK pelacakan atau analitik, @capgo/capacitor-app-tracking-transparency menangani prompt ATT iOS dan @capgo/capacitor-firebase-analytics mendokumentasikan pengumpulan data Firebase untuk tinjauan App Store.
Tetap kompatibel, lindungi privasi pengguna, dan hindari keterlambatan toko aplikasi dengan mengikuti panduan ini.
Dasar-Dasar Manifest Privasi
Pengertian Manifest Privasi
Manifest privasi adalah file yang terstruktur yang menjelaskan praktik 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 keterlambatan dengan pedoman toko aplikasi. Mari kita memecah komponen kunci yang harus Anda masukkan dalam manifesto Anda.
Elemen Privasi Utama Manifest
Berikut adalah elemen utama yang harus Anda masukkan dalam manifest privasi Anda untuk memenuhi persyaratan Apple:
-
API Alasan Wajib
Bagian ini menampilkan API yang sensitif privasi yang digunakan aplikasi Anda dan menjelaskan mengapa mereka diperlukan.Berikut adalah tabel yang menjelaskan persyaratan umum API:
API Kategori Penggunaan Umum Dokumentasi yang Diperlukan Lokasi Layanan Penggunaan Navigasi String Tujuan dan Deskripsi Penggunaan Libur Foto Foto Profil Level akses dan niat Kontak Sinkronisasi buku alamat Statement minimasi data -
Lambang 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
Daftar ini mencantumkan 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], menjaga dokumentasi privasi Anda tetap akurat sangat penting untuk mempertahankan kepercayaan pengguna.
Membangun Manifest Privasi untuk Capacitor
Persyaratan Pengaturan
Sebelum Anda memulai membuat manifest, pastikan Anda telah memiliki:
- Xcode 15 atau lebih baru terinstal
- Proyek Capacitor 8.0+ yang telah disetup
- Akses ke aplikasi Anda’s
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 project iOS Anda. File ini harus mengikuti pedoman format tertentu:
Tetapkan Informasi Dasar
{
"NSPrivacyTracking": false,
"NSPrivacyTrackingDomains": [],
"NSPrivacyCollectedDataTypes": []
}Tentukan Detail Pengumpulan Data
{
"NSPrivacyAccessedAPITypes": [
{
"NSPrivacyAccessedAPIType": "NSLocationWhenInUseUsageDescription",
"NSPrivacyAccessedAPITypeReasons": ["1.1"]
},
{
"NSPrivacyAccessedAPIType": "NSCameraUsageDescription",
"NSPrivacyAccessedAPITypeReasons": ["2.1"]
}
]
}Tambahkan Domain Pemantauan
{
"NSPrivacyTrackingDomains": [
"analytics.yourdomain.com",
"metrics.yourdomain.com"
]
}Menghindari Kesalahan Umum
Untuk mencegah masalah, perhatikan tips berikut:
- Termasuk Semua Bidang yang Diperlukan: Meskipun ada beberapa bidang yang kosong, mereka harus ada.
- Menggunakan Tipe API yang Valid: Periksa identifikasi API dengan dokumen resmi Apple.
- Pengecekan Format JSON: Jalankan file Anda melalui linter JSON untuk menangkap kesalahan sintaks.
- Mengapa __CAPGO_KEEP_0__ harus menyertakan alasan __CAPGO_KEEP_1__.: Make sure every API access includes a corresponding reason code.
- : Perbarui manifest setiap kali fitur baru ditambahkan.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 __CAPGO_KEEP_0__ Anda dengan mengikuti pedoman penempatan file.
Menggunakan Manifest Privasi di Capacitor
Adding Privacy Manifests to Capacitor
Menggunakan Pedoman Penempatan File
To termasukkan manifest privasi dalam proyek Capacitor Anda, tempatkan file tersebut di struktur direktori berikut: PrivacyInfo.xcprivacy Untuk struktur 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.xcodeprojPengaturan Pengaturan Pembangunan
Setelah file tersebut berada di tempat, update pengaturan pembangunan 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 Pembangunan .
- Set Konfigurasi Manifest Privasi Pengembangan Wilayah ke
en. - Set Termasuk Manifest Privasi ke
YES.
Jika proyek Anda menggunakan CocoaPods, termasuk kode berikut dalam Podfile ke 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
To pastikan privasi manifest berfungsi sebagaimana yang diharapkan, ikuti langkah-langkah berikut:
-
Verifikasi Pembangunan
- Pastikan tidak ada peringatan privasi terkait selama proses pembangunan.
- Pastikan manifest dapat dikompilasi tanpa masalah.
- Verifikasi bahwa manifest privasi termasuk dalam produk pembangunan.
-
Validasi Runtime
- Pada mode debug, tes untuk memastikan prompt privasi yang tepat dan perilaku API.
-
Validasi App Store Connect
- Unggah build Anda dan tinjau Laporan Privasi di App Store Connect.
- Periksa apakah deklarasi API lengkap dan format domain pelacakan benar.
Jika Anda mengalami kesalahan 'Validasi Manifest Privasi gagal', periksa kembali manifest Anda untuk memastikan bahwa sudah memenuhi persyaratan App Store terbaru. Berhati-hatilah terutama pada jenis API dan konfigurasi domain pelacakan.
Pengubahan Manifest Privasi Apple
Uji Coba 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 Anda. Hal ini membantu menghubungkan upaya pengembangan dengan persyaratan kompatibilitas.
Alat seperti Capgo bisa membantu. Alat ini memantau akses API dan mengidentifikasi masalah manifest sebelum mereka mempengaruhi pengguna. Setelah potensi masalah ditandai, Anda dapat memindahkan fokus ke validasi yang teliti.
Setelah membuat perubahan, uji manifest 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 memudahkan mengelola manifest privasi dan update aplikasi, memastikan standar privasi Anda tetap utuh tanpa mengganggu peluncuran.
Capgo Fitur
Lebih dari 23,5 juta pembaruan yang terlindungi dan sukses global sebesar 82%, Capgo memastikan bahwa 95% pengguna aktif menerima pembaruan dalam waktu 24 jam [1]. Berikut ini yang ditawarkan:
- Enkripsi akhir-ke-akhir untuk menjaga pembaruan tetap aman
- Sistem saluran untuk distribusi pembaruan yang terkendali
- Pengenalan kesalahan Mengidentifikasi dan menangani masalah dengan cepat
- Rollback satu-klik Mengembalikan 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 Actions, , atau__CAPGO_KEEP_0__ Jenkins. Apakah Anda memilih opsi 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 update secara terus-menerus kepada pengguna!” – Rodrigo Mantica
“Capgo adalah cara pintar untuk membuat push code panas 🙂” – NASA’s OSIRIS-REx
Capgo juga termasuk analitis bawaan untuk memantau tingkat kesuksesan update dan interaksi pengguna secara real-time. Ini memastikan update privasi mencapai basis pengguna Anda sambil tetap memenuhi pedoman Apple.
Kesimpulan
Poin Utama
Saat mengelola manifest privasi, mempertahankan kepatuhan dan keamanan yang kuat sangat penting. Berikut yang paling penting:
- Enkripsi Akhir ke Akhir: Membuat update aman dari awal hingga akhir.
- Pengawasan Real-time: Mengikuti distribusi update dengan efektif.
- Kemampuan rollback instan: Berfungsi sebagai jaring pengaman untuk perbaikan cepat.
- Validasi Otomatis: Menjamin bahwa perbaruan Anda memenuhi standar komplian.
Membangun sistem perbaruan yang dapat diandalkan membantu Anda tetap kompatibel dengan kebutuhan privasi Apple dan Google yang terus berkembang. Pendekatan ini telah terbukti meningkatkan tingkat persetujuan toko aplikasi dan memperkuat kepercayaan pengguna [1].
Cara Mulai
Anda dapat memulai menerapkan prinsip-prinsip ini dengan mengikuti langkah-langkah berikut:
- Sesuaikan Lingkungan: Jalankan
npx @capgo/cli inituntuk memulai. - Aktifkan Fitur Privasi: Gunakan enkripsi akhir-ke-akhir untuk perbaruan yang aman.
- Deploy alat monitoring: Ikuti pembaruan dengan analitik.
- Rencanakan untuk mengembalikan ke versi sebelumnya: Pastikan Anda dapat kembali dengan cepat ke versi sebelumnya jika diperlukan.
“Capgo adalah alat yang wajib dimiliki oleh para pengembang yang ingin meningkatkan produktivitas. Menghindari keterlambatan 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 Dokumen Manifest Privasi untuk Aplikasi Capacitor: Panduan
Jika Anda menggunakan Dokumen Manifest Privasi untuk Aplikasi Capacitor: Panduan untuk merencanakan keamanan dan kompatibilitas, hubungkannya dengan Enkripsi untuk detail implementasi di Enkripsi, Kepatuhan untuk detail implementasi di Kepatuhan, 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.
