Guida per il manifesto di privacy degli app Capacitor

Texts: Capacitor Manifesto di protezione dei dati per le app __CAPGO_KEEP_0__: Guida Vuoi lanciare la tua __CAPGO_KEEP_0__ app sul

App Store
A structured file outlining your app’s data collection practices, API usage, and tracking domains.
Inizia creando un Manifesto di protezione dei dati. Apple richiede ora ai sviluppatori di includere questo documento per garantire che le app soddisfino gli standard di protezione dei dati rigorosi. Ecco cosa devi sapere:
- Cosa è un Manifesto di protezione dei dati?
- Costruisce 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 di privacy per i tipi di dati raccolti.
- Dominio di tracciamento utilizzato 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.
- Valutalo con strumenti come Xcode per evitare errori.
Strumenti per semplificare il processo:
Utilizza 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 tracking o analitiche, @capgo/capacitor-app-tracking-transparency gestisce le richieste di ATT di iOS e @capgo/capacitor-firebase-analytics documenta la raccolta di 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.

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 API che accedono ai dati degli utenti, domini di tracciamento, tipi di dati raccolti e terze parti SDK integrate. 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 Manifesto Privacy Protetti

Ecco gli elementi principali da includere nel tuo manifesto di privacy per adattarti alle richieste di Apple:

API di Motivi Obbligatori
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
Galleria delle Foto	Foto di 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 tracking
Dominio di tracking
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], è essenziale mantenere aggiornata la documentazione sulla privacy per mantenere la fiducia degli utenti.

Creazione di manifesti di privacy per Capacitor

Documentazione del sito web del framework Capacitor

Requisiti di configurazione

Prima di iniziare a creare il manifesto, assicurati di avere:

Xcode 15 o successivo installato
Un progetto Capacitor 8.0+ configurato
Accesso all'applicazione tua Info.plist file
Una comprensione di base della struttura JSON
Documentazione che descrive le pratiche di raccolta dei dati dell'applicazione

Passaggi di Creazione

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

Impostazione delle Informazioni di Base

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

Definisci i Dettagli della Raccolta dei 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, tieni presente queste indicazioni:

Includi tutti i campi richiesti: Anche se alcuni campi sono vuoti, devono essere presenti.
Usa Tipi 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à.

Assicurati inoltre che il file manifesto rimanga sotto i 512KB per evitare errori di build. Valida regolarmente il file durante il processo di build di Xcode per catturare 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, collocare il file nella seguente struttura di directory: PrivacyInfo.xcprivacy Per i plugin __CAPGO_KEEP_0__, utilizzare 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

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

Apri il tuo progetto in Xcode.

Sotto
TARGETS , seleziona il tuo target di app o plugin.Vai alla scheda
Impostazioni di compilazione . Inserisci il seguente valore per il campo "Privacy - Privacy Manifest File":
Imposta Manifesto di protezione dello sviluppatore Regione a en.
Imposta Includi manifesto di protezione a YES.

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

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

To assicurarsi che il manifesto di privacy funziona 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 delle richieste di privacy e API accesso.
Validazione di App Store Connect
- Inviare la tua costruzione e recensisci il Rapporto sulla Privacy in App Store Connect.
- Controlla che le dichiarazioni API siano complete e che i formati dei domini 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 API e alle configurazioni dei domini di tracciamento.

Modifiche al manifesto di privacy di Apple

Testing and Fixes

La creazione di un manifesto di privacy che soddisfi le linee guida di Apple è cruciale. 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 con le 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 stati segnalati potenziali problemi, puoi concentrarti sulla validazione approfondita.

Dopo aver effettuato aggiornamenti, testa il manifesto in un ambiente di sviluppo. Utilizza le informazioni dal tracciamento degli errori per guidare la tua revisione. Questo approccio aiuta a garantire che l'app rimanga allineata con le linee guida 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 i rilasci.

Capgo Caratteristiche

Con più di 23,5 milioni di aggiornamenti protetti e un 82% di successo globale, Capgo garantisce che 95% degli utenti attivi ricevano gli 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
Tracciamento degli errori To identificare e risolvere problemi velocemente
Ripristino rapido To tornare immediatamente a una versione precedente

Questi strumenti 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 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 a 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 🙂” – OSIRIS-REx di NASA

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

Prendi in considerazione i punti 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 gli aggiornamenti sicuri da inizio a fine.
Monitoraggio in tempo reale: Traccia l'efficacia della distribuzione degli aggiornamenti.
Capacità di rollback istantanea: Funziona come un sistema di sicurezza per riparazioni rapide.
Validazione automatica: Assicura che le tue 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 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 ambiente: Run 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 l'analisi.
Pianifica il 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 Encryption per i dettagli di implementazione in Encryption, Compliance per la dettagliata implementazione in Compliance, Capgo Scanner di Sicurezza per il flusso di lavoro del prodotto in Capgo Scanner di Sicurezza, Capgo Sicurezza per il flusso di lavoro del prodotto in Capgo Sicurezza, e Capgo Centro di Trust per il flusso di lavoro del prodotto in Capgo Centro di Trust.

Manifesto di Privacy per le app Capacitor: Guida