Vuoi lanciare la tua Capacitor applicazione app sul Store dell'App Start by creating a Privacy Manifest. Apple now requires developers to include this document to ensure apps meet strict privacy standards. Here’s what you need to know:
-
Cosa è un Manifesto di Privacy?
Un file strutturato che descrive le pratiche di raccolta dei dati dell'app, l'utilizzo API e i domini di tracciamento. -
Perché conta:
- Rispetta le regole della Store App per evitare rifiuti o rimozioni.
- Rispetta le regole dello Store dell'App per evitare rifiuti o rimozioni.
-
Componenti chiave da includere:
- APIs che accedono ai dati utente (ad esempio, posizione, foto).
- Etichette di privacy per i tipi di dati raccolti.
- Tracking domains used for analytics or ads.
-
Come crearne uno:
- Use JSON to define data collection details.
- Collocare il
PrivacyInfo.xcprivacyfile nella directory corretta del tuo progetto. - Validarlo con strumenti come Xcode per evitare errori.
-
Il strumenti per semplificare il processo:
Utilizza piattaforme come Capgo for automated privacy manifest validation, real-time updates, and error tracking. When your manifest declares tracking or analytics SDKs, @capgo/capacitor-trasparenza-tracciamento-app gestisce le richieste di ATT di iOS e @capgo/capacitor-analisi Firebase documenta la raccolta dei dati Firebase per la revisione dell'App Store.
Rimani conforme, proteggi la privacy degli utenti e evita i ritardi negli store di app seguendo questa guida.
Elementi base del manifesto di privacy
Definizione del manifesto di privacy
Un manifesto di privacy è un file strutturato che descrive le pratiche di dati dell'app. Dettaglia elementi come API che accedono ai dati degli utenti, domini di tracciamento, tipi di dati raccolti e integrazioni di terze parti SDK. Questo documento non solo aiuta a stabilire la fiducia, ma anche a garantire la conformità con le linee guida dell'App Store. Cerchiamo di smontare i componenti chiave che il tuo manifesto dovrebbe includere.
Elementi principali del manifesto di privacy
Ecco gli elementi principali da includere nel tuo manifesto sulla privacy per allinearti con le richieste di Apple:
-
API di ragione richieste
Questa sezione elenca le API sensibili alla privacy che il tuo app utilizza e spiega perché sono necessarie.Ecco una tabella che riassume le richieste comuni API:
API Categoria Utilizzo comune Documentazione richiesta Servizi di localizzazione Navigazione dell'utente Stringa di scopo e descrizione dell'utilizzo Libreria di foto Profili di foto Livello di accesso e intento Contatti Sincronizzazione rubrica Dichiarazione di minimizzazione dei dati -
Etichette sulla privacy
Ecco le etichette che forniscono trasparenza specificando:- Tipi di dati raccolti
- Motivi della raccolta dei dati
- Se i dati sono collegati all'identità dell'utente
- How the data is used for tracking
-
Domini di tracciamento
Questa sezione elenca tutti i domini coinvolti nel tracciamento, come quelli utilizzati per l'analisi, la pubblicità o il trattamento dei dati di terze parti.
“Compatibile con l'App Store” - Capgo [1]
Secondo Capgo, il 95% degli utenti si aggiorna entro 24 ore. Con oltre 23,5 milioni di aggiornamenti consegnati [1], mantenere aggiornata la documentazione sulla privacy è essenziale per mantenere la fiducia degli utenti.
Aiutaci a costruire manifesti di privacy per Capacitor
Requisiti di configurazione
Prima di iniziare a costruire il manifesto, assicurati di avere:
- Xcode 15 o versione successiva installato
- Un progetto Capacitor 8.0+ configurato
- Accesso al file della tua app
Info.plistfile - A una comprensione di base della struttura JSON
- Documentazione che descrive le pratiche di raccolta dati dell'app
Passaggi di creazione
Inizia creando un PrivacyInfo.xcprivacy file nel tuo directory del progetto iOS. Questo file deve seguire specifiche linee guida di formattazione:
Configurazione delle informazioni di base
{
"NSPrivacyTracking": false,
"NSPrivacyTrackingDomains": [],
"NSPrivacyCollectedDataTypes": []
}Definisci i dettagli della raccolta dati
{
"NSPrivacyAccessedAPITypes": [
{
"NSPrivacyAccessedAPIType": "NSLocationWhenInUseUsageDescription",
"NSPrivacyAccessedAPITypeReasons": ["1.1"]
},
{
"NSPrivacyAccessedAPIType": "NSCameraUsageDescription",
"NSPrivacyAccessedAPITypeReasons": ["2.1"]
}
]
}Aggiungi i domini di tracciamento
{
"NSPrivacyTrackingDomains": [
"analytics.yourdomain.com",
"metrics.yourdomain.com"
]
}Evitare errori comuni
Per evitare problemi, tieni presente:
- Includi tutti i campi richiesti: anche se alcuni campi sono vuoti, devono essere presenti.
- Usa Tipi di Dati Validi API: Verifica gli identificatori API con la documentazione ufficiale di Apple.
- Controlla la Formattazione JSONEsegui un linter JSON sul tuo file per individuare gli errori di sintassi.
- Fornisci Motivi Completi: Assicurati che ogni accesso API includa un motivo corrispondente code.
- Mantieni le Informazioni Aggiornate: Update the manifest whenever new features are added.
Inoltre, assicurati che il file manifesto rimanga sotto 512KB per evitare errori di build. Valuta regolarmente il file durante il processo di build di Xcode per catturare gli errori in anticipo. Una volta pronto il tuo manifesto, integralo nel tuo progetto Capacitor seguendo le linee guida per la posizione dei file.
Aggiungere Manifesti di Privacy a Capacitor
Guida al Posizionamento dei File
Per includere un manifesto di privacy nel tuo progetto Capacitor, posiziona il PrivacyInfo.xcprivacy file nella seguente struttura di directory:
your-app/
├── ios/
│ ├── App/
│ │ ├── PrivacyInfo.xcprivacy
│ │ └── Info.plist
│ └── App.xcworkspacePer i plugin Capacitor, utilizzare questa struttura:
your-plugin/
├── ios/
│ ├── Plugin/
│ │ └── PrivacyInfo.xcprivacy
│ └── Plugin.xcodeprojImpostazione delle impostazioni di compilazione
Once the file is in place, update your Xcode build settings to ensure it integrates properly:
- Apre il tuo progetto in Xcode.
- Sotto TARGETS, seleziona il tuo app o plugin target.
- Vai alla Impostazioni di compilazione tab.
- Imposta Manifesto di privacy Sviluppo regionale to
en. - Configura Sviluppa un manifesto di privacy to
YES.
Includi manifesto di privacy CocoaPodsincludere il seguente snippet nel tuo Podfile abilitare il manifesto di privacy:
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
endAfter making these changes, proceed with implementation checks to verify everything is set up correctly.
Controllo di implementazione
Per assicurarti che il manifesto di privacy funzioni come previsto, segui questi passaggi:
-
Verifica della costruzione
- Assicurati che non ci siano avvisi relativi alla privacy durante la costruzione.
- Assicurati che il manifesto si compili senza problemi.
- Verifica che il manifesto di privacy sia incluso nei prodotti di costruzione.
-
Validazione in esecuzione
- In modalità debug, testa il comportamento di accesso e le API sollecitazioni di privacy.
-
Validazione di App Store Connect
- Carica la tua costruzione e revisiona il Rapporto sulla Privacy in App Store Connect.
- Check that API declarations are complete and tracking domain formats are correct.
Se incontri un errore 'Validazione del manifesto di privacy fallita', controlla nuovamente il manifesto per assicurarti che soddisfi le ultime richieste di App Store. Presta particolare attenzione ai tipi API e alle configurazioni dei domini di tracciamento.
Modifiche al manifesto di privacy di Apple
Test e correzioni
Creare un manifesto di privacy che soddisfi le linee guida di Apple è fondamentale. Per rimanere sul binario giusto, integra un sistema di tracciamento degli errori affidabile nel tuo processo di sviluppo. Ciò aiuta a collegare gli sforzi di sviluppo alle richieste di conformità.
Un strumento come Capgo can help. It monitors API access and identifies manifest issues before they affect users. Once potential problems are flagged, you can shift your focus to thorough validation.
After making updates, test your manifest in a development environment. Use insights from error tracking to guide your review. This approach helps ensure your app stays aligned with Apple’s privacy standards.
Capgo __CAPGO_KEEP_0__
Capgo simplifies managing privacy manifests and app updates, ensuring your privacy standards stay intact without delaying deployments.
Capgo Features
__CAPGO_KEEP_0__ Interfaccia di dashboard __CAPGO_KEEP_1__ 23,5 milioni di aggiornamenti sicuri e un 82% di successo globale, Capgo garantisce che 95% degli utenti attivi ricevano gli aggiornamenti entro 24 ore [1]. Ecco cosa offre:
- Criptazione end-to-end per mantenere aggiornamenti sicuri
- per mantenere gli aggiornamenti sicuri for controlled update distribution
- Raccolta errori to identify and address issues quickly
- Ritorno automatico a un precedente stato di versione
Questi strumenti rendono l'aggiunta di Capgo al tuo workflow facile e efficiente.
Utilizzo di Capgo
Per iniziare, installa il plugin Capgo con il seguente comando:
npx @capgo/cli initCapgo integra in modo trasparente con i pipeline CI/CD, automatizzando la validazione del manifesto di privacy attraverso piattaforme come GitHub Actions, GitLab CI, o Jenkins. Scegliete opzioni cloud o self-hosted, Capgo supporta 750 app di produzione mentre assicura che ogni aggiornamento rispetti i requisiti di privacy.
“Pratichiamo lo sviluppo agile e @Capgo è essenziale per consegnare aggiornamenti continuativi ai nostri utenti!” – Rodrigo Mantica
“Capgo è un modo intelligente per eseguire push caldi code 🙂” – NASA's OSIRIS-REx
Capgo include anche analisi integrate per monitorare i tassi di successo degli aggiornamenti e l'engagement degli utenti in tempo reale. Ciò assicura che gli aggiornamenti di privacy raggiungano l'intera base di utenti mentre rimangono conformi alle linee guida di Apple.
Conclusioni
Presempio chiave
Quando si tratta di gestire manifesti di privacy, è fondamentale mantenere la conformità e misure di sicurezza solide. Ecco cosa conta di più:
- Chiaro fine a fineMantiene aggiornamenti sicuri da inizio a fine.
- Monitoraggio in tempo realeRacchiude i dati sulla distribuzione degli aggiornamenti.
- Capacità di rollback istantaneo: Acts as a safety net for quick fixes.
- Valutazione automatica: Ensures your updates meet compliance standards.
Building a reliable update system helps you keep up with Apple and Google’s evolving privacy requirements. This approach has been shown to improve app store approval rates and strengthen user confidence [1].
Come iniziare
Puoi iniziare a implementare questi principi seguendo questi passaggi:
- Configura il tuo ambiente: Esegui
npx @capgo/cli initper iniziare. - Abilita le funzionalità di privacyUsa la crittografia end-to-end per aggiornamenti sicuri.
- Deploy strumenti di monitoraggio: Tracciare gli aggiornamenti con l'analisi.
- Preparare il piano di ripristino.: Assicurati di poter tornare rapidamente alle versioni precedenti se necessario.
“Capgo è un'utile strumento per i developer che vogliono aumentare la produttività. Evitare i ritardi di revisione per i bug fix è un vero cambiamento di gioco.” - Bessie Cooper
Regular updates and proper tools are key to staying compliant and improving over time.
Continua da Privacy Manifest per gli App Capacitor: Guide
Se stai utilizzando Privacy Manifest per gli App Capacitor: Guide per pianificare la sicurezza e la conformità, collega La crittografia per il dettaglio di implementazione in La crittografia, La conformità per i dettagli di implementazione in Compliance, Capgo Scansionatore di Sicurezza per il workflow del prodotto in Capgo Scanner di Sicurezza, Capgo Sicurezza per il flusso di lavoro del prodotto in Capgo Sicurezza, e Capgo Centro di Trust for the product workflow in Capgo Trust Center.
