Buku Panduan Manifest Privasi untuk Aplikasi Capacitor

Ingin meluncurkan aplikasi Anda di Capacitor Toko Aplikasi tanpa hambatan? 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?

Apa itu Dokumen Privasi?
File struktur yang menjelaskan praktik pengumpulan data aplikasi Anda, API penggunaan, dan domain pelacakan.
Mengapa penting:
- Mengikuti aturan App Store untuk menghindari penolakan atau penghapusan.
- Membangun kepercayaan dengan menjadi transparan tentang pengelolaan data pengguna.
Komponen kunci untuk diikutsertakan:
- API yang mengakses data pengguna (misalnya, lokasi, foto).
- Label privasi untuk jenis data yang dikumpulkan.
- Domain pelacakan yang digunakan untuk analitis atau iklan.
Cara membuatnya:
- Gunakan JSON untuk mendefinisikan detail pengumpulan data.
- Tempatkan file di direktori yang benar dari proyek Anda. PrivacyInfo.xcprivacy How to create one:
- Periksa dengan alat-alat seperti Xcode untuk menghindari kesalahan.
Alat-alat untuk memudahkan proses:
Gunakan platform seperti Capgo untuk validasi manifesto privasi otomatis, pembaruan waktu nyata, dan pelacakan kesalahan.

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

Dasar-Dasar Manifest Privasi

Definisi Manifest Privasi

A privacy manifest is a structured file that outlines your app’s data practices. It details elements like APIs accessing user data, tracking domains, data types collected, and third-party SDK integrations. This document not only helps establish trust but also ensures compliance with App Store guidelines. Let’s break down the key components your manifest should include.

Elemen Utama Manifest Privasi

Berikut adalah elemen utama yang harus Anda masukkan dalam manifesto privasi Anda untuk memenuhi persyaratan Apple:

Diperlukan Alasan API
Bagian ini menampilkan daftar API yang sensitif privasi yang digunakan oleh aplikasi Anda dan menjelaskan mengapa mereka diperlukan.

Di bawah ini adalah tabel yang menyajikan persyaratan umum API:

API Category	Penggunaan Umum	Dokumen yang Diperlukan
Jasa Lokasi	Navigasi Pengguna	Tujuan dan Deskripsi Penggunaan
Galeri Foto	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.

“Toko Aplikasi yang Kompatibel” - Capgo [1]

Menurut Capgo, 95% pengguna mematuhi pembaruan dalam waktu 24 jam. Dengan lebih dari 23,5 juta pembaruan yang disampaikan [1]Mengemban Dokumentasi Privasi yang Aktual untuk

Membangun Manifestasi Privasi untuk Capacitor Dokumentasi Framework

Capacitor Situs Web Dokumentasi

Persyaratan Pengaturan

Sebelum Anda memulai membangun manifest, pastikan Anda telah memiliki:

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

Langkah-Langkah Penciptaan

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 Pengawasan

{
    "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.
Gunakan Tipe-Tipe yang Sah API: Periksa Identifikasi API dengan Dokumentasi Resmi Apple.
Periksa Format JSON: Jalankan file Anda melalui linter JSON untuk menangkap kesalahan sintaks.
Berikan Alasan yang Lengkap: Pastikan setiap API akses termasuk alasan code yang sesuai.
Tetapkan Informasi Terupdate: 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 dalam proyek Capacitor Anda dengan mengikuti pedoman penempatan file.

Menambahkan Manifest Privasi ke Capacitor

Pedoman Penempatan File

Untuk mencakup manifest privasi dalam proyek Capacitor, tempatkan PrivacyInfo.xcprivacy file di direktori struktur berikut:

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

Untuk Capacitor plugin, gunakan struktur berikut:

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

Pengaturan Build

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 Build Settings .
Atur Privasi Manifest Pengembangan Wilayah ke en.
Atur Termasuk Privasi Manifest ke YES.

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

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 privasi manifest berfungsi sebagaimana mestinya, ikuti langkah-langkah berikut:

Verifikasi Pembangunan
- Pastikan tidak ada peringatan privasi selama pembangunan.
- Pastikan manifest dapat dikompilasi tanpa masalah.
- Verifikasi bahwa manifest privasi termasuk dalam produk pembangunan.
Validasi Runtime
- Dalam mode debug, tes untuk memastikan prompt privasi yang tepat dan perilaku API.
Validasi App Store Connect
- Unggah pembangunan Anda dan tinjau Laporan Privasi di App Store Connect.
- Periksa bahwa deklarasi API lengkap dan format domain pelacakan benar.

If you encounter a “Privacy Manifest validation failed” error, double-check your manifest to ensure it meets the latest App Store requirements. Pay special attention to API types and tracking domain configurations.

Validasi Manifest Privasi gagal

[Indonesian]

Menguji 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. Capgo API

dapat membantu. Alat ini memantau akses __CAPGO_KEEP_0__ dan mengidentifikasi masalah manifest sebelum mereka mempengaruhi pengguna. Setelah potensi masalah ditandai, Anda dapat memindahkan fokus ke validasi yang lebih menyeluruh.

Capgo __CAPGO_KEEP_0__

Capgo Live Update Dashboard Interface

Capgo Dashboard Pembaruan Hidup

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

__CAPGO_KEEP_0__ Fitur-Fiturnya dengan Lebih dari 23,5 juta pembaruan yang aman dan 82% tingkat kesuksesan global, Capgo memastikan bahwa 95% pengguna aktif menerima pembaruan dalam waktu 24 jam [1]Berikut ini adalah apa yang ditawarkan:

Enkripsi ujung ke ujung untuk menjaga pembaruan tetap aman
Sistem saluran untuk distribusi pembaruan yang dikendalikan
Pengenalan kesalahan untuk mengidentifikasi dan menangani masalah dengan cepat
Mengembalikan satu kali klik untuk langsung kembali ke versi sebelumnya

Alat-alat ini membuat menambahkan Capgo ke alur kerja Anda 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. 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 yang panas 🙂” – NASA’s OSIRIS-REx

Capgo juga termasuk analitis bawaan untuk memantau tingkat kesuksesan update dan partisipasi 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.
Pantauan waktu nyata : Mengikuti distribusi update dengan efektif.
Kemampuan rollback instanBerfungsi sebagai jaringan keamanan untuk perbaikan cepat.
Validasi OtomatisMenggunakan standar kompatibilitas untuk memastikan update Anda sesuai dengan standar.

Membangun sistem update yang dapat diandalkan membantu Anda untuk 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 Membuat Mulai

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

Atur lingkungan: Jalankan npx @capgo/cli init untuk memulai.
Aktifkan fitur privasi: Gunakan enkripsi akhir-ke-akhir untuk update yang aman.
Tetapkan alat monitoring: Pantau pembaruan dengan analitik.
Rencanakan untuk mengembalikan ke versi sebelumnya jika diperlukan.: Pastikan Anda dapat kembali ke versi sebelumnya dengan cepat jika diperlukan.

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

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

Pernyataan Privasi untuk Aplikasi Capacitor : Panduan