Guida per il Manifesto di Privacy per le App Capacitor

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

Cos'è 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:
- Rispetta le regole del Store per evitare rifiuti o rimozioni.
- Crea 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.
- I domini di tracciamento utilizzati per gli analytics o gli annunci.
Come creare uno:
- Usa JSON per definire i dettagli della raccolta dei dati.
- Colloca il PrivacyInfo.xcprivacy file nella directory corretta del tuo progetto.
- Valutalo con strumenti come Xcode per evitare gli errori.
Strumenti per semplificare il processo:
Usa piattaforme come Capgo per la validazione automatica del manifesto di privacy, aggiornamenti in tempo reale e tracciamento degli errori. Quando il tuo manifesto dichiara SDK di tracciamento o analytics, @capgo/capacitor-app-tracking-transparency gestisce le richieste di ATT iOS e @capgo/capacitor-firebase-analytics documenta la raccolta di Firebase per la revisione dell'App Store.

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

Basi del manifesto sulla privacy

Definizione del manifesto sulla privacy

Un 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à con le linee guida dell'App Store. Vediamo come suddividere 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.

Di seguito è riportata una tabella che riassume le richieste comuni API:

API Categoria	Utilizzo comune	Documentazione richiesta
Servizi di localizzazione	Navigazione dell'utente	Descrizione della stringa e dell'uso
Libreria delle foto	Foto del profilo	Livello di accesso e intento
Contatti	Sincronizzazione dell'agenda degli appuntamenti	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 si conforma alle aggiornamenti entro 24 ore. Con oltre 23,5 milioni di aggiornamenti consegnati [1]mantenere la documentazione sulla privacy aggiornata è essenziale per mantenere la fiducia degli utenti

Costruire Manifesti di Privacy per Capacitor

Capacitor Documentazione del Framework Sito Web

Configurazione dei Requisiti

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 Una comprensione di base della struttura JSON
Documentazione che descrive le pratiche di raccolta dati della tua app
Passaggi di Creazione

Xcode 15 or later installed

Avvia creando un file nel tuo directory del progetto iOS. Questo file deve seguire specifiche linee guida di formattazione: PrivacyInfo.xcprivacy Configura le Informazioni di Base

Definisci i Dettagli di Raccolta Dati

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

Aggiungi i Domini di Tracciamento

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

Evitare gli Errori Comuni

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

Per prevenire problemi, tieni presente:

Includi tutti i Campi Richiesti

: Anche se alcuni campi sono vuoti, devono essere presenti.Utilizza Tipi di __CAPGO_KEEP_0__ Validi
: Verifica gli identificatori di API con la documentazione ufficiale di Apple.: Cross-check API identifiers with Apple’s official documentation.
Avviare con un file nel tuo progetto iOS directory. Questo file deve seguire specifiche linee guida di formattazione:: Verifica il tuo file con un linter JSON per individuare gli errori di sintassi.
Motivi Completi: Assicurati che ogni accesso a API includa una ragione corrispondente code.
Aggiorna le Informazioni: Assicurati di aggiornare il manifesto ogni volta che vengono aggiunte nuove funzionalità.

Ricorda anche di mantenere il file manifesto sotto i 512KB per evitare errori di build. Verifica regolarmente il file durante il processo di build di Xcode per individuare gli errori in anticipo. Una volta pronto il manifesto, integralo nel tuo progetto Capacitor seguendo le linee guida per la posizione dei file.

Aggiunta dei Manifesti di Privacy a Capacitor

Linee Guida per la Posizione dei File

Per includere un manifesto di privacy nel tuo progetto Capacitor, posiziona il file nella seguente struttura di directory: PrivacyInfo.xcprivacy Per i plugin __CAPGO_KEEP_0__, utilizza questa struttura:

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

For Capacitor plugins, use this structure:

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

Aggiorna il manifesto ogni volta che vengono aggiunte nuove funzionalità. Ricorda anche di mantenere il file manifesto sotto i 512KB per evitare errori di build. Verifica regolarmente il file durante il processo di build di Xcode per individuare gli errori in anticipo. Una volta pronto il manifesto, integralo nel tuo progetto __CAPGO_KEEP_0__ seguendo le linee guida per la posizione dei file.

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 __CAPGO_KEEP_0__, seleziona il tuo target di app o plugin.
Vai alla scheda Impostazioni di compilazione .
Imposta Regione di sviluppo del manifesto di privacy a en.
__CAPGO_KEEP_1__ Includi Manifesto di Riservatezza per YES.

Se il tuo progetto utilizza CocoaPods, includi il seguente snippet nel tuo Podfile per abilitare il manifesto di riservatezza:

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, procedi con i controlli di implementazione per verificare che tutto sia configurato correttamente.

Controllo di Implementazione

Per assicurarti che il manifesto di riservatezza funzioni come previsto, segui questi passaggi:

Verifica di Costruzione
- Conferma che non ci siano avvisi relativi alla riservatezza durante la costruzione.
- Assicurati che il manifesto si compili senza problemi.
- Verifica che il manifesto di privacy sia incluso nei prodotti di build.
Validazione Runtime
- In modalità debug, testa il comportamento di accesso e le API sollecitazioni di privacy.
Validazione App Store Connect
- Carica il tuo build e verifica il Rapporto di Privacy in App Store Connect.
- Verifica che le API dichiarazioni siano complete e che i formati di dominio di tracciamento siano corretti.

Se incontri un errore di '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 di API e alle configurazioni dei domini di tracciamento.

Modifiche al manifesto di privacy di Apple

Test e correzioni

La creazione di un manifesto di privacy che soddisfi le linee guida di Apple è cruciale. Per rimanere sulla rotta, integra un tool di tracciamento degli errori affidabile nel tuo processo di sviluppo. Ciò aiuta a collegare gli sforzi di sviluppo alle richieste di conformità.

Un tool 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 stati segnalati potenziali problemi, puoi concentrarti sulla validazione approfondita.

Dopo aver effettuato aggiornamenti, testa il tuo manifesto in un ambiente di sviluppo. Utilizza le informazioni tratte dal tracking degli errori per guidare la tua revisione. Questo approccio aiuta a garantire che la tua app rimanga allineata con i requisiti di Apple in materia di privacy.

Capgo Strumenti per la Privacy

Capgo Dashboard di Aggiornamento in Tempo Reale

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

Capgo Caratteristiche

Con più di 23,5 milioni di aggiornamenti sicuri e un tasso di successo globale del 82%assicura che Capgo 95% degli utenti attivi ricevono aggiornamenti entro 24 ore [1]. Ecco cosa offre:

crittografia end-to-end per mantenere gli aggiornamenti sicuri
Sistema dei canali per la distribuzione controllata degli aggiornamenti
Raccolta errori per identificare e risolvere velocemente le problematiche
Ripristino automatico per tornare immediatamente a una versione precedente

Queste funzionalità rendono l'aggiunta di Capgo alla tua pipeline fluida e efficiente.

Utilizzando Capgo

Per iniziare, installa il plugin Capgo con il seguente 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 self-hosted, Capgo supporta 750 app di produzione mentre assicura che ogni aggiornamento sia conforme ai standard di privacy.

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

“Capgo è un modo intelligente per effettuare push di code caldi 🙂” – 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 rimane conforme alle linee guida di Apple.

Conclusioni

Vantaggi chiave

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

Crittografia end-to-end: Mantiene gli aggiornamenti sicuri da inizio a fine.
Monitoraggio in tempo reale: Traccia la distribuzione degli aggiornamenti in modo efficace.
Capacità di rollback istantanea: Funge da rete di sicurezza per interventi rapidi.
Validazione automatica: Assicura che gli aggiornamenti soddisfino i requisiti di conformità.

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

Come Iniziare

Potresti 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 l'encryption end-to-end per aggiornamenti sicuri.
Deploy strumenti di monitoraggio: Traccia gli aggiornamenti con l'analisi dei dati.
Prepara i rollback: Assicurati di poter ripristinare velocemente versioni precedenti se necessario.

“Capgo è uno strumento imprescindibile per i developer che vogliono aumentare la produttività. Evitare i ritardi di revisione per i bug fix è un vero cambiamento di gioco.” - Bessie Cooper

Aggiornamenti regolari e strumenti adeguati sono la chiave per rimanere conformi e migliorare nel tempo.

Continua da Privacy Manifest per le App Capacitor: Guida

Se stai utilizzando Privacy Manifest per le App Capacitor: Guida per pianificare la sicurezza e la conformità, connettilo con Crittografia per i dettagli di implementazione in Crittografia, Conformità per i dettagli di implementazione in Conformità, Capgo Security Scanner per il flusso di lavoro del prodotto in Capgo Security Scanner, Capgo Sicurezza per il flusso di lavoro del prodotto in Capgo Sicurezza, e Capgo Centro di fiducia per il flusso di lavoro del prodotto in Capgo Centro di fiducia.

Manifesto di Privacy per le App Capacitor: Guida