Manifesto di privacy per le app di Capacitor: Guida

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

• Cos'è un Manifesto di Privacy?
  Un file strutturato che descrive le pratiche di raccolta dati dell'app, l'utilizzo di API e i domini di tracciamento.

• Perché è importante:

  • Rispetta le regole dello Store per evitare rifiuti o rimozioni.
  • 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 di privacy per tipi di dati raccolti.
  • Tracking domains used for analytics or ads.

• Come crearne uno:

  • Utilizza JSON per definire i dettagli della raccolta dei dati.
  • Colloca il PrivacyInfo.xcprivacy il file nella directory corretta del tuo progetto.
  • Verificare con gli strumenti come Xcode per evitare gli errori.

• Gli strumenti per semplificare il processo:
  Usare 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-trasparenza-tracciamento-app gestisce le richieste di ATT di iOS e @capgo/capacitor-analisi Firebase documenti raccolgono dati Firebase per la revisione dell'App Store.

documenta la raccolta dei dati Firebase per la revisione dell'App Store.

Basi del Manifesto di Privacy

Definizione del Manifesto di Privacy

Il 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 l'adeguamento alle linee guida dell'App Store. Ecco come suddividere i componenti chiave che il tuo manifesto dovrebbe includere.

Elementi Principali del Manifesto di Privacy

Ecco gli elementi principali da includere nel manifesto di privacy per allinearsi con le richieste di Apple:

1. API di Ragione Richieste
   Questa sezione elenca le API sensibili alla privacy che l'app utilizza e spiega perché sono necessarie.

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

   API Categoria	Uso Comune	Documentazione Richiesta
   Servizi di Localizzazione	Navigazione utente	Descrizione dello scopo e utilizzo
   Libreria delle foto	Foto del profilo	Livello di accesso e intento
   Contatti	Sincronizzazione dell'agenda degli appuntamenti	Dichiarazione di minimizzazione dei dati

2. 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
   • Come viene utilizzato i dati per il tracciamento

3. 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 conforma 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 di Manifesti di Privacy per Capacitor

Requisiti di configurazione

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

• Xcode 15 o successivi installato
• Un progetto Capacitor 8.0+ configurato
• Accesso ai file della tua app Info.plist file
• Una comprensione di base della struttura JSON
• Guida alla documentazione delle 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 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 gli errori comuni

Ecco alcuni consigli per evitare problemi:

• Includere tutti i campi richiesti: Anche se alcuni campi sono vuoti, devono essere presenti.
• Utilizzare tipi API validi: Verificare gli identificatori API con la documentazione ufficiale di Apple.
• Controllare la formattazione JSON: Eseguire il file attraverso un linter JSON per individuare gli errori di sintassi.
• Fornire ragioni complete: Assicurarsi che ogni accesso API includa una ragione code corrispondente.
• Tenere le informazioni aggiornate: Aggiornare il manifesto ogni volta che vengono aggiunte nuove funzionalità.

Assicurati inoltre che il file di manifestazione rimanga sotto 512 KB per evitare errori di compilazione. Valuta 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 alla posizione dei file

Includere un manifesto di privacy nel tuo progetto Capacitor è possibile posizionando il PrivacyInfo.xcprivacy Per plugin __CAPGO_KEEP_0__, utilizza questa struttura:

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

Per Capacitor plugin, utilizzare questa struttura:

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

Impostazioni di costruzione

Aggiorna le impostazioni di compilazione di Xcode per assicurarti che si integri correttamente.

1. Apri il tuo progetto in Xcode.
2. TARGETS TARGETSSeleziona il tuo target di app o plugin.
3. Vai alla Impostazioni di costruzione sezione.
4. Imposta Manifesto di Privacy per lo Sviluppo di Regioni to en.
5. Imposta Includi manifesto sulla privacy to YES.

Includi manifesto di privacy CocoaPodsincludi il seguente snippet 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 questi cambiamenti, procedere con i controlli di implementazione per verificare che tutto sia configurato correttamente.

Controllo di Implementazione

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

1. Verifica della Costruzione

   • Confermare che non ci siano avvisi relativi alla privacy durante la costruzione.
   • Assicurarsi che il manifesto compili senza problemi.
   • Verificare che il manifesto sulla privacy sia incluso nei prodotti di costruzione.

2. Validazione in Esecuzione

   • In modalità debug, testare il comportamento delle richieste di accesso alla privacy e API.

3. Validazione di App Store Connect

   • Caricare la tua costruzione e recensire il Rapporto sulla Privacy in App Store Connect.
   • Verifica che le dichiarazioni API siano complete e che i formati dei domini di tracciamento siano corretti.

Se si incontra un errore di "validazione del manifesto di privacy fallita", verificare nuovamente il manifesto per assicurarsi che soddisfi le ultime richieste dell'App Store. Prestare particolare attenzione ai tipi API e alle configurazioni dei domini di tracciamento.

Modifiche al Manifesto di Privacy di Apple

Test e Risoluzioni

Creare un manifesto di privacy che soddisfi le linee guida di Apple è cruciale. Per rimanere su rotta, integrare un sistema di tracciamento degli errori affidabile nel processo di sviluppo. Ciò aiuta a collegare gli sforzi di sviluppo alle richieste di conformità.

Un strumento come Capgo Possono aiutare. Monitorano l'accesso API e identificano le problematiche del manifesto prima che possano influire sugli utenti. Una volta che i problemi potenziali sono stati segnalati, si può concentrare sulla validazione approfondita.

Dopo aver apportato aggiornamenti, testare il manifesto in un ambiente di sviluppo. Utilizzare le informazioni provenienti dal tracciamento degli errori per guidare la revisione. Questo approccio aiuta a garantire che l'app rimanga allineata con le norme di privacy di Apple.

Capgo Strumenti di Privacy

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

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 aggiornamenti sicuri
• Sistema di canale per la distribuzione di aggiornamenti controllati
• Tracciamento degli errori per identificare e risolvere problemi velocemente
• Ritorno automatico per 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 Azioni, GitLab CI, o Jenkins. In ogni caso, Capgo supporta 750 applicazioni in produzione, garantendo che ogni aggiornamento sia conforme alle norme sulla privacy.

“Pratichiamo lo sviluppo agile e @Capgo è fondamentale 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ò garantisce che gli aggiornamenti sulla privacy raggiungano l'intera base utente, mantenendo la conformità con le linee guida di Apple.

Conclusioni

Prendi nota dei punti chiave

Quando si tratta di gestire i manifesti di privacy, mantenere la conformità e adottare misure di sicurezza solide è fondamentale.

• Encryptazione end-to-end: Mantiene aggiornamenti sicuri da inizio a fine.
• Monitoraggio in tempo reale: Traccia efficacemente la distribuzione degli aggiornamenti.
• Capacità di rollback istantaneo: Funge da rete di sicurezza per interventi rapidi.
• Valutazione automaticaGarantisce che le tue aggiornamenti rispettino 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: Esegui npx @capgo/cli init per iniziare.
• Abilita le funzionalità di privacy.: Utilizza la crittografia end-to-end per aggiornamenti sicuri.
• Deploy gli strumenti di monitoraggio.: Traccia gli aggiornamenti con gli analytics.
• Prepara i rollback.: Assicurati di poter ripristinare velocemente versioni precedenti se necessario.

“Capgo è un'utile strumento per i developer che vogliono aumentare la produttività. Evitare i ritardi nella revisione dei bug è un vero cambiamento di gioco.” - Bessie Cooper

Gli aggiornamenti regolari e gli strumenti appropriati sono la chiave per rimanere conformi e migliorare nel tempo.

Continua da Privacy Manifest per Capacitor Apps: Guide

Se stai utilizzando Privacy Manifest per Capacitor Apps: Guide per pianificare la sicurezza e la conformità, connettilo con Encryption per la dettagliata implementazione in Compliance Compliance per i dettagli di implementazione nella Compliance, Capgo Scansionatore di Sicurezza per il flusso di lavoro del prodotto in Capgo Trust Center Capgo Sicurezza per il flusso di lavoro del prodotto in Capgo Sicurezza, e Capgo Trust Center per il flusso di lavoro del prodotto nel Trust Center di Capgo.