Salta al contenuto principale

Privacy Manifest per app iOS

Guida 2026 su conformità e troubleshooting per PrivacyInfo.xcprivacy nelle app iOS Capacitor: API con motivo obbligatorio, ITMS-91053 e ITMS-91061, manifest SDK di terze parti.

Illustrazione del blog sul Privacy Manifest per le app iOS Capgo

I privacy manifest di Apple sono obbligatori per gli upload su App Store: ogni app ha bisogno di un PrivacyInfo.xcprivacy che descriva la raccolta dati, i domini di tracciamento e qualsiasi API con motivo obbligatorio le tue chiamate code. Gli SDK di terze parti su la lista obbligatoria di Apple devono includere i propri manifest (e le firme se distribuiti come binari). Questa guida si concentra su conformità 2026 e troubleshooting per Capacitor App iOS: cosa dichiarare, come correggere ITMS-91053 e ITMS-91061, e come validare prima di inviare.

Cosa copre un privacy manifest

Un privacy manifest è un property list incluso con la tua app o SDK. Xcode aggrega tutti i manifest al momento dell'archiviazione in un unico report sulla privacy.

Chiave Scopo
NSPrivacyTracking Se la tua app o SDK usa i dati per il tracking come definito da Apple
NSPrivacyTrackingDomains Domini coinvolti nel tracking
NSPrivacyCollectedDataTypes Tipi di dati raccolti e come vengono usati
NSPrivacyAccessedAPITypes API con motivazione richiesta che il tuo stesso code utilizza, con i codici motivo approvati

Panoramica di Apple: Aggiungere un privacy manifest alla tua app o ai SDK di terze parti.

Sei responsabile di tutti i code nel binario, inclusi gli SDK incorporati. Il tuo manifest deve descrivere solo la tua appNon incollare le pratiche relative ai dati di un altro SDK nel tuo file.

Categorie API Required Reason

Da 1 maggio 2024, App Store Connect rifiuta gli upload se l'app utilizza un API elencato senza una motivazione approvata in NSPrivacyAccessedAPITypes. Apple documenta le API e le motivazioni approvate in Descrizione dell'uso della motivazione richiesta API.

A partire dal TN3183, il categoria i valori sono:

NSPrivacyAccessedAPIType valore Trigger tipici nelle app ibride
NSPrivacyAccessedAPICategoryUserDefaults Impostazioni, stato dei plugin, piccola persistenza
NSPrivacyAccessedAPICategoryFileTimestamp Metadati file, cache, bundle di aggiornamento
NSPrivacyAccessedAPICategoryDiskSpace Controllo dello spazio libero prima dei download
NSPrivacyAccessedAPICategorySystemBootTime Tempo trascorso, timer o timestamp assoluti
NSPrivacyAccessedAPICategoryActiveKeyboards Estensione tastiera o rilevamento input

Per ogni categoria che usi, aggiungi un dizionario con NSPrivacyAccessedAPIType e NSPrivacyAccessedAPITypeReasons. Scegli solo i codici motivo elencati da Apple per quella categoria. Codici errati causano il fallimento della review.

Frammento di esempio (adatta categorie e codici alla tua app dopo aver controllato il privacy report):

<key>NSPrivacyAccessedAPITypes</key>
<array>
  <dict>
    <key>NSPrivacyAccessedAPIType</key>
    <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
    <key>NSPrivacyAccessedAPITypeReasons</key>
    <array>
      <string>CA92.1</string>
    </array>
  </dict>
</array>

Capacitor stesso compare nell'elenco di Apple requisiti SDK di terze parti quindi il framework include un manifest per l'uso di API da parte di Capacitor. Serve comunque un manifest a livello di app per tuo layer nativi e JavaScript, plugin e tutte le API non coperte dalle dipendenze.

ITMS-91053: dichiarazione API mancante

ITMS-91053 significa che App Store Connect ha rilevato nella tua build una API con required reason senza una voce corrispondente in un privacy manifest unificato.

Come risolvere:

  1. Leggi l'email di rifiuto o l'upload log. Indica il API categoria (ad esempio NSPrivacyAccessedAPICategoryDiskSpace).
  2. Apri il report sulla privacy dell'archivio in Xcode (Prodotto > Archivio, poi Genera report sulla privacy sull'archivio) e verifica se la lacuna riguarda il tuo app target o una dipendenza.
  3. Se il API si trova in tuo code o un plugin tuo, aggiungi la categoria e un motivo approvato a ios/App/PrivacyInfo.xcprivacy.
  4. Se il API proviene da una dipendenza, aggiorna il pod o il pacchetto SPM a una versione che includa un manifest, oppure applica una patch al plugin e dichiara solo ciò che il tuo fork chiama davvero.
  5. Riarchivia e verifica che la categoria compaia nel report prima di caricare di nuovo.

Non dichiarare categorie che non usi. L'analisi statica di Apple è legata ai simboli nel binario.

ITMS-91061: privacy manifest di terze parti mancante

ITMS-91061 significa che SDK che impattano sulla privacy nel tuo bundle dell'app non ha PrivacyInfo.xcprivacy. Apple afferma che quando pubblichi una nuova app o un aggiornamento che aggiunge un SDK elencato, che SDK deve includere un manifest; anche gli SDK binari richiedono un firma dal vendor SDK.

Come risolvere:

  1. Copia il percorso del framework dall'email (ad esempio Frameworks/FirebaseCore.framework/FirebaseCore).
  2. Identifica il pacchetto CocoaPods, SPM o il pacchetto binario vendored.
  3. Aggiorna a una release del vendor che include PrivacyInfo.xcprivacy nella root del framework.
  4. Pulisci, ricostruisci e verifica il file all'interno del .xcarchive prima dell'upload.

Non sposta nel manifest della tua app le dichiarazioni di raccolta o API di SDK. Apple avverte esplicitamente che il manifest deve descrivere solo l'app. Se SDK non è più mantenuto, sostituiscilo o integra una build conforme.

Gli SDK elencati includono stack mobili comuni (Firebase, Flutter, Capacitor, shared_preferences_ios, e altri). Controlla l'elenco attuale sul sito di Apple prima di ogni release.

Manifest e firme SDK di terze parti

Quando aggiorni una dipendenza, Xcode verifica che i framework binari siano firmati dallo stesso sviluppatore delle release precedenti. Questo protegge la supply chain quando i manifest cambiano.

Workflow pratico:

  • Dopo aver pod install o risolvendo SPM, cerca ios/ per PrivacyInfo.xcprivacy file.
  • Archivia e usa Genera report sulla privacy per leggere il quadro complessivo.
  • Confronta il report con le risposte al questionario sulla privacy di App Store.

Per lo tooling di live update, dichiara le API con motivo obbligatorio effettivamente usate dal tuo updater (ad esempio spazio su disco, timestamp dei file o preferenze utente). L'accesso alla rete non è una categoria di motivo obbligatorio per API. Se l'updater raccoglie dati personali, dichiarali nelle etichette sulla privacy di App Store e nelle risposte al questionario; il semplice recupero di un aggiornamento via HTTPS non crea una nuova categoria di disclosure. Mantieni Conformità Capgo live update a mente quando documenti il comportamento OTA.

Aggiungi PrivacyInfo.xcprivacy in un progetto iOS Capacitor

  1. Sincronizza il progetto nativo: bunx cap sync ios.
  2. Apri lo workspace Xcode in ios/App.
  3. File > Nuovo > File, scegli Privacy dell'app (oppure aggiungi un PrivacyInfo.xcprivacy plist vuoto).
  4. Salva il file in ios/App (stessa cartella di AppDelegate va bene).
  5. Nel target Fasi di build > Copia risorse bundle, conferma PrivacyInfo.xcprivacy è presente.
  6. Compila tracking, tipi di dati raccolti e API Required Reason in base ad app e plugin.
  7. Esegui l'Archive, genera il report sulla privacy e correggi eventuali categorie mancanti prima di caricare su App Store Connect.

Se modifichi il plist come XML su disco, riapri Xcode per mantenere corretta la target membership.

Ogni app o target SDK mantiene il proprio PrivacyInfo.xcprivacy. Quando esegui l'archive, Xcode aggrega quei manifest in un unico report sulla privacy. Non devi unire manualmente i plist delle dipendenze nel file della tua app.

Per un plugin Capacitor personalizzato pubblicato come framework iOS autonomo, aggiungi PrivacyInfo.xcprivacy nella cartella di quel plugin ios/Plugin/ (o equivalente) e elenca il file nel target del plugin Copia risorse bundle, non solo nel target dell'app.

Quando NSPrivacyTracking è true o incorpori SDK di annunci o analytics, allinea il manifest con le etichette di privacy di App Store e mostra il prompt App Tracking Transparency quando richiesto da iOS. @capgo/capacitor-app-tracking-transparency copre il flusso ATT per le app Capacitor.

Checklist di validazione prima dell'invio

  • Il target dell'app include PrivacyInfo.xcprivacy nella Copia risorse bundle.
  • Ogni categoria di motivazione richiesta nel rifiuto o nel report ha codici di motivazione approvati.
  • Ogni SDK di terze parti elencato nella build include il proprio manifest nel percorso previsto.
  • Il report sulla privacy corrisponde a quanto sai su SDK per analytics, ads e autenticazione.
  • Le etichette sulla privacy dell'App Store sono allineate al report consolidato.

FAQ

I plugin Capacitor devono avere un proprio privacy manifest?

Se un plugin è distribuito come sorgente nel tuo repo, il suo utilizzo di API fa parte del binario della tua app. Dichiara le API chiamate dal plugin nel manifest dell'app, oppure contribuisci con un manifest all'interno del target del plugin se viene distribuito come framework separato. I pod binari devono seguire le regole Apple per i SDK di terze parti.

Posso risolvere l'errore ITMS-91061 modificando solo il PrivacyInfo.xcprivacy della mia app?

No. SDK deve includere il manifest. Il tuo file deve solo documentare le pratiche della tua app.

Dove sono documentate le date delle policy di Apple?

API dei motivi obbligatori: obbligatorie dal 1 maggio 2024. Le regole di manifest e firma di terze parti per gli SDK elencati sono descritte in Requisiti di terze parti per SDK.

Continua da Privacy Manifest per app iOS

Se stai usando Privacy Manifest per app iOS per pianificare sicurezza e compliance, collegalo a Crittografia per i dettagli di implementazione della crittografia, Conformità per i dettagli di implementazione in Compliance, Security Scanner di Capgo per il workflow del prodotto in Capgo Security Scanner, Sicurezza Capgo per il workflow del prodotto in Capgo Security, e Trust Center di Capgo per il workflow del prodotto in Capgo Trust Center.

Live updates per le app Capacitor

Quando un bug nel web-layer è live, rilascia la fix tramite Capgo invece di aspettare giorni l'approvazione degli store. Gli utenti ricevono l'update in background, mentre le modifiche native restano nel normale processo di review.

Ultimi articoli dal blog

Capgo ti offre gli insight migliori che ti servono per creare un'app mobile davvero professionale.