Guida per il manifesto di privacy delle app Capacitor

Vuoi lanciare il tuo Capacitor app sul App Store senza ritardi? Inizia creando un manifesto sulla privacy. Apple richiede ora ai sviluppatori di includere questo documento per garantire che le app soddisfino gli standard di privacy rigorosi. Ecco cosa devi sapere:

Cosa è un manifesto sulla privacy?
Un file strutturato che descrive le pratiche di raccolta dei dati dell'app, l'uso di API e i domini di tracciamento.
Perché è importante:
- Soddisfa le regole dell'App Store per evitare le rifiutazioni o la rimozione.
- Costruisce la fiducia essendo trasparente sul trattamento dei dati degli utenti.
Componenti chiave da includere:
- API che accedono ai dati degli utenti (ad esempio, posizione, foto).
- Etichette sulla privacy per i tipi di dati raccolti.
- Raccolta di domini utilizzati per l'analisi o gli annunci pubblicitari.
Come crearne uno:
- Usa JSON per definire i dettagli della raccolta dei dati.
- Colloca il PrivacyInfo.xcprivacy file nella directory corretta del tuo progetto.
- Validalo con strumenti come Xcode per evitare errori.
Strumenti per semplificare il processo:
Usa piattaforme come Capgo per la validazione automatica del manifesto sulla privacy, aggiornamenti in tempo reale e tracciamento degli errori.

Rimani conforme alle norme, proteggi la privacy degli utenti e evita i ritardi negli store di app seguiendo questa guida.

Elementi base del manifesto sulla privacy

Definizione del manifesto sulla privacy

Il manifesto sulla privacy è un file strutturato che descrive le pratiche di dati dell'app. Dettaglia elementi come le API che accedono ai dati degli utenti, i domini di tracciamento, i tipi di dati raccolti e le integrazioni di terze parti SDK. Questo documento non solo aiuta a stabilire la fiducia ma anche a garantire la conformità alle linee guida degli store di app. Cerchiamo di smontare i componenti chiave che il tuo manifesto dovrebbe includere.

Elementi principali del manifesto sulla privacy

Ecco gli elementi principali da includere nel tuo manifesto sulla privacy per aderire alle 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 un riepilogo dei requisiti comuni API:

Categoria API	Utilizzo comune	Documentazione richiesta
Servizi di localizzazione	Navigazione dell'utente	Descrizione della stringa e dell'utilizzo
Libreria delle foto	Foto del profilo	Livello di accesso e intento
Contatti	Sincronizzazione del libro degli indirizzi	Dichiarazione di minimizzazione dei dati

Etichette sulla privacy
Queste etichette forniscono trasparenza specificando:
- Tipi di dati raccolti
- Motivi della raccolta dei dati
- Se i dati sono collegati all'identità dell'utente
- Come i dati sono utilizzati per il tracciamento
Dominio 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 aderisce alle aggiornamenti 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.

Creazione dei manifesti di privacy per Capacitor

Capacitor Documentazione del Framework sul sito web

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.plist Un file
Una buona comprensione della struttura JSON
Documentazione che descrive le pratiche di raccolta dati dell'app

Passaggi di Creazione

Inizia creando un PrivacyInfo.xcprivacy file nel directory del tuo progetto iOS. Questo file deve seguire specifiche linee guida di formattazione:

Configura le Informazioni di Base

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

Definisci i Dettagli di Raccolta Dati

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

Aggiungi Domini di Tracciamento

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

Evitare Errori Comuni

Per prevenire problemi, tenere presente queste indicazioni:

Includere Tutti i Campi Richiesti: Anche se alcuni campi sono vuoti, devono essere presenti.
Utilizzare Tipi di API Validi: Verificare gli identificatori di API con la documentazione ufficiale di Apple.
Verificare la Formattazione JSON: Eseguire il file attraverso un linter JSON per catturare gli errori di sintassi.
Fornire Motivi Completi: Assicurarsi che ogni accesso a API includa una ragione corrispondente code.
Mantieni le Informazioni Aggiornate: Aggiorna il manifesto ogni volta che vengono aggiunte nuove funzionalità.

Inoltre, assicurati che il file manifesto rimanga sotto 512KB per evitare errori di compilazione. Verifica regolarmente il file durante il processo di compilazione di Xcode per individuare 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 per la posizione 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.xcworkspace

Per plugin Capacitor, utilizza questa struttura:

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

Configurazione delle impostazioni di compilazione

Una volta posizionato il file, aggiorna le impostazioni di compilazione di Xcode per assicurarti che si integri correttamente:

Apri il tuo progetto in Xcode.
Sotto IMPOSTAZIONI DEL TARGETScegli il tuo app o plugin di destinazione.
Vai al Impostazioni di costruzione tab.
Imposta Regione di sviluppo del manifesto di privacy a en.
Imposta Includi manifesto di privacy Se il tuo progetto utilizza YES.

CocoaPods If your project usesincludere il seguente snippet nel tuo Podfile per 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
end

Dopo aver effettuato questi cambiamenti, procedere con i controlli di implementazione per verificare che tutto sia configurato correttamente.

Controllo di Implementazione

Per assicurarsi che il manifesto di privacy funzioni come previsto, seguire questi passaggi:

Verifica di Costruzione
- Confermare l'assenza di avvisi relativi alla privacy durante la costruzione.
- Assicurarsi che il manifesto si compili senza problemi.
- Verificare che il manifesto di privacy sia incluso nei prodotti di costruzione.
Validazione in Esecuzione
- In modalità debug, testare il comportamento delle richieste di privacy e l'accesso a API.
Validazione di App Store Connect
- Carica il tuo build e verifica il Rapporto sulla Privacy in App Store Connect.
- Assicurati che le dichiarazioni API siano complete e che i formati dei domini di tracciamento siano corretti.

Se incontri un errore di validazione della dichiarazione di Privacy 'Non riuscito', controlla nuovamente la tua dichiarazione per assicurarti che soddisfi le ultime richieste dell'App Store. Focalizzati in particolare sui tipi API e sulle configurazioni dei domini di tracciamento.

Modifiche alla Dichiarazione di Privacy di Apple

Test e Correzioni

Creare una dichiarazione di Privacy che soddisfi le linee guida di Apple è fondamentale. Per rimanere su rotta, 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 può aiutarti. Monitora l'accesso API e identifica le problematiche della dichiarazione prima che possano influire sugli utenti. Una volta che i potenziali problemi sono stati segnalati, puoi concentrarti sulla validazione approfondita.

Dopo aver apportato le modifiche, testa la tua dichiarazione in un ambiente di sviluppo. Utilizza le informazioni provenienti dal tracciamento degli errori per guidare la tua revisione. Questo approccio aiuta a garantire che l'app rimanga allineata con le norme sulla privacy di Apple.

Capgo Strumenti per la privacy

Capgo Dashboard di aggiornamento in tempo reale dell'interfaccia

Capgo semplifica la gestione dei manifesti di privacy e degli aggiornamenti dell'applicazione, garantendo che i propri standard di privacy rimangano integri senza ritardare le distribuzioni.

Capgo Caratteristiche

Con più di 23,5 milioni di aggiornamenti sicuri e un tasso di successo globale del, Capgo ensures that __CAPGO_KEEP_0__ garantisce che [1]il 95% degli utenti attivi riceva gli aggiornamenti entro 24 ore

. Ecco cosa offre: la crittografia end-to-end per mantenere aggiornate le informazioni in modo sicuro
Sistema dei canali per la distribuzione degli aggiornamenti controllata
Raccolta degli errori per identificare e risolvere velocemente le problematiche
Ripristino automatico per tornare immediatamente a una versione precedente

Queste funzionalità rendono l'aggiunta di Capgo al tuo workflow facile e efficiente.

Utilizzare Capgo

Per iniziare, installa il plugin Capgo con questo comando:

npx @capgo/cli init

Capgo integra in modo trasparente con i flussi di lavoro CI/CD, automatizzando la validazione del manifesto di privacy attraverso piattaforme come GitHub Actions, GitLab CI, o Jenkins. Scegliendo tra opzioni cloud o auto-hosted, Capgo supporta 750 applicazioni in produzione, garantendo che ogni aggiornamento sia conforme alle norme sulla privacy.

“Pratichiamo lo sviluppo agile e @Capgo è essenziale per consegnare continuamente ai nostri utenti!” – Rodrigo Mantica

“Capgo è un modo intelligente per effettuare push caldi di 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ò garantisce che gli aggiornamenti sulla privacy raggiungano l'intera base di utenti mentre rimangono conformi alle linee guida di Apple.

Conclusioni

Vantaggi chiave

Quando si tratta di gestire i manifesti di privacy, mantenere la conformità e misure di sicurezza solide è cruciale. Ecco cosa conta di più:

Crittografia end-to-end: Mantiene aggiornamenti sicuri da inizio a fine.
Monitoraggio in tempo reale: Traccia l'efficace distribuzione degli aggiornamenti.
Capacità di rollback istantanea: Funge da rete di sicurezza per interventi veloci.
Valutazione automatica: Assicura che i tuoi aggiornamenti rispettino gli standard di conformità.

La creazione di un sistema di aggiornamento affidabile ti aiuta a mantenere il passo con le evoluzioni dei requisiti di privacy di Apple e Google. Questo approccio ha dimostrato di migliorare le percentuali di approvazione negli store di app e di rafforzare la fiducia degli utenti [1].

Come Iniziare

Puoi iniziare a implementare questi principi seguendo questi passaggi:

Configura il tuo ambiente: Esegui npx @capgo/cli init per iniziare.
Abilita le funzionalità di privacy: Utilizza la crittografia end-to-end per aggiornamenti sicuri.
Distribuisci strumenti di monitoraggio: Traccia gli aggiornamenti con analisi.
Pianifica i rollback: Assicurati di poter ripristinare velocemente versioni precedenti se necessario.

“Capgo is a must-have tool for developers who want to boost productivity. Avoiding review delays for bug fixes is a game changer.” - Bessie Cooper

__CAPGO_KEEP_0__ è uno strumento fondamentale per i developer che desiderano aumentare la produttività. Evitare i ritardi di revisione per i bug fix è un vero cambiamento di gioco.” - Bessie Cooper

Manifesto di Privacy per le App Capacitor: Guida