Guida al manifesto di privacy per le app Capacitor

Vuoi lanciare il tuo Capacitor app sulla 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é conta:
- Rispetta le regole dell'App Store per evitare le rimostranze o la rimozione.
- Costruisce la fiducia essendo trasparente sul trattamento dei dati degli utenti.
Componenti chiave da includere:
- APIs che accedono ai dati degli utenti (ad esempio, posizione, foto).
- Etichette di privacy per i tipi di dati raccolti.
- Raccolta dei domini utilizzati per l'analisi o gli annunci pubblicitari.
Come creare uno:
- Utilizza JSON per definire i dettagli della raccolta dei dati.
- Posiziona il PrivacyInfo.xcprivacy il file nella directory corretta del tuo progetto.
- Verificare con gli strumenti come Xcode per evitare gli errori.
Strumenti per semplificare il processo:
Utilizzare piattaforme come Capgo per la validazione del manifesto di privacy automatizzata, aggiornamenti in tempo reale e tracciamento degli errori.

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

Basi 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 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à con le linee guida degli store di app. Lasciamo che smontiamo 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 adattarsi alle richieste di Apple:

Motivi obbligatori delle API
Questa sezione elenca le API sensibili alla privacy che il tuo app utilizza e spiega perché sono necessarie.

Sotto è riportata una tabella che riassume le richieste comuni API:

API Categoria	Utilizzo comune	Documentazione richiesta
Servizi di localizzazione	Navigazione dell'utente	Descrizione della stringa di scopo e descrizione dell'utilizzo
Galleria delle foto	Immagine del profilo	Livello di accesso e intento
Contatti	Sincronizzazione rubrica	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]La documentazione sulla privacy è essenziale per mantenere la fiducia degli utenti.

Creazione di Manifesti sulla Privacy per Capacitor

Capacitor Documentazione del Framework

Sito web della Documentazione del Framework

Requisiti di configurazione

Prima di iniziare a creare il manifesto, assicurati di avere:
A Capacitor 8.0+ project set up
Un progetto __CAPGO_KEEP_0__ 8.0+ configurato Info.plist Accesso alla cartella dei file del tuo
Una comprensione di base della struttura JSON
Documentazione che descrive le pratiche di raccolta dati dell'applicazione

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 domini di tracciamento

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

Evitare errori comuni

Per evitare problemi, tenere a mente queste indicazioni:

Includere 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 JSON: Esegui il tuo file attraverso un linter JSON per catturare gli errori di sintassi.
Fornisci Motivi Completi: Assicurati che ogni accesso 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 i 512KB per evitare gli errori di build. Valuta regolarmente il file durante il processo di build di Xcode per catturare gli errori precoci. Una volta pronto il 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 nel seguente struttura di directory:

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

Per i plugin Capacitor utilizzare la seguente struttura:

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

Impostazione delle impostazioni di compilazione

Una volta che il file è in posizione, aggiorna le impostazioni di compilazione di Xcode per assicurarsi che si integrino correttamente:

Apri il tuo progetto in Xcode.
Sotto TARGETS, seleziona il tuo target di app o plugin.
Vai al Impostazioni di compilazione tab.
Imposta Manifesto sulla privacy Sviluppo Regione a en.
Imposta Includi manifesto sulla privacy a YES.

Se il tuo progetto utilizza CocoaPods, includi il seguente frammento nel tuo Podfile per abilitare il manifesto sulla 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 queste modifiche, procedi con i controlli di implementazione per verificare che tutto sia configurato correttamente.

Controllo di implementazione

Per assicurarti che il manifesto sulla privacy funzioni come previsto, segui questi passaggi:

Verifica della costruzione
- Conferma che non ci sono 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 richieste di privacy.
Validazione di App Store Connect
- Carica la tua costruzione e recensisci il Rapporto sulla Privacy in App Store Connect.
- Controlla che le dichiarazioni API siano complete e che i formati di dominio di tracciamento siano corretti.

Se si verifica un errore di "Validazione del manifesto di privacy fallita", controlla 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

È fondamentale creare un manifesto di privacy che rispetti le linee guida di Apple. Per rimanere su rotta, integrare un sistema di tracciamento degli errori nel tuo processo di sviluppo. Ciò aiuta a collegare gli sforzi di sviluppo alle richieste di conformità.

Un strumento come Capgo può aiutare. Monitora l'accesso a API e identifica le problematiche del manifesto prima che possano influire sugli utenti. Una volta che sono state segnalate potenziali problematiche, puoi concentrarti sulla validazione approfondita.

Dopo aver effettuato aggiornamenti, testa il manifesto 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 gli standard di privacy di Apple.

Capgo Strumenti di privacy

Capgo Dashboard di aggiornamento in tempo reale

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

Capgo Caratteristiche

Con più di 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:

Chiarificazione end-to-end per mantenere gli aggiornamenti sicuri
Sistema di canali per la distribuzione controllata degli aggiornamenti
Tracciamento degli errori per identificare e risolvere rapidamente le problematiche
Ripristina con un clic per tornare immediatamente a una versione precedente

Questi strumenti rendono l'aggiunta di Capgo al tuo workflow fluido e efficiente.

Utilizzare Capgo

Per iniziare, installa il plugin Capgo con questo comando:

npx @capgo/cli init

Capgo 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. Scegliendo tra opzioni cloud o auto-hosted, Capgo supporta 750 app di produzione mentre assicura che ogni aggiornamento sia conforme ai requisiti di privacy.

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

“Capgo è un modo intelligente per eseguire push di code in tempo reale 🙂” – 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 di privacy raggiungano l'intera base di utenti mentre rimaniamo conformi alle linee guida di Apple.

Conclusioni

Punti chiave

Quando si tratta di gestire i manifesti di privacy, è fondamentale rimanere conformi e mantenere misure di sicurezza solide. Ecco cosa conta di più:

Crittografia end-to-end: Mantiene gli aggiornamenti sicuri da inizio a fine.
Monitoraggio in tempo reale: Traccia l'efficace distribuzione degli aggiornamenti.
Capacità di rollback istantaneaFunziona come un sistema di sicurezza per correzioni rapide.
Validazione automaticaAssicura che le tue aggiornamenti soddisfino i requisiti di conformità.

Costruire un sistema di aggiornamento affidabile ti aiuta a tenere il passo con le esigenze di privacy in continua evoluzione di Apple e Google. Questo approccio ha dimostrato di migliorare le percentuali di approvazione delle app store e di rafforzare la fiducia degli utenti. [1].

Come Iniziare

Puoi iniziare a implementare questi principi seguendo questi passaggi:

Configura il tuo ambienteEsegui npx @capgo/cli init per iniziare.
Abilita le funzionalità di privacyUtilizza l'encryption end-to-end per aggiornamenti sicuri.
Distribuisci strumenti di monitoraggioSegui gli aggiornamenti con gli analytics.
Pianifica i rollbackAssicurati di poter tornare velocemente a versioni precedenti se necessario.

"Capgo è un'utile di base per i sviluppatori che vogliono aumentare la produttività. Evitare i ritardi nella revisione dei bug è un vero cambiamento di gioco." - Bessie Cooper

Aggiornamenti regolari e strumenti appropriati sono la chiave per mantenere la conformità e migliorare nel tempo.

Manifesto di privacy per le app Capacitor