Los manifiestos de privacidad de Apple son obligatorios para subir apps a la App Store: cada app necesita un PrivacyInfo.xcprivacy que describa la recolección de datos, dominios de rastreo y cualquier API con motivos requeridos tus llamadas de code. SDKs de terceros en la lista requerida de Apple deben incluir sus propios manifiestos (y firmas si se distribuyen como binarios). Esta guía se centra en Cumplimiento 2026 y solución de problemas para Capacitor apps de iOS: qué declarar y cómo solucionarlo ITMS-91053 y ITMS-91061, y cómo validarlo antes de enviar.
Qué cubre un manifiesto de privacidad
Un manifiesto de privacidad es un archivo property list incluido en tu app o SDK. Xcode combina todos los manifiestos al archivar en un único informe de privacidad.
| Clave | Propósito |
|---|---|
NSPrivacyTracking |
Si tu app o SDK usa datos para el rastreo según la definición de Apple |
NSPrivacyTrackingDomains |
Dominios involucrados en el rastreo |
NSPrivacyCollectedDataTypes |
Tipos de datos recopilados y cómo se usan |
NSPrivacyAccessedAPITypes |
APIs de motivo requeridas que tu app code utiliza, con códigos de motivo aprobados |
Resumen de Apple: Añadir un privacy manifest a tu app o a un SDK de terceros.
Eres responsable de todos los code en el binario, incluidos los SDK integrados. Tu manifest debe describir solo tu app. No copies las prácticas de datos de otro SDK en tu archivo.
Categorías de API de motivo requerido
Desde 1 de mayo de 2024, App Store Connect rechaza las subidas si tu app usa una API listada sin un motivo aprobado en NSPrivacyAccessedAPITypes. Apple documenta las APIs y los motivos aprobados en Cómo describir el uso de API de motivo requerido.
Según Apple, TN3183, categoría los valores son:
NSPrivacyAccessedAPIType valor |
Disparador típico en apps híbridas |
|---|---|
NSPrivacyAccessedAPICategoryUserDefaults |
Ajustes, estado de plugins, persistencia pequeña |
NSPrivacyAccessedAPICategoryFileTimestamp |
Metadatos de archivos, cachés, bundles de actualización |
NSPrivacyAccessedAPICategoryDiskSpace |
Comprobaciones de espacio libre antes de descargas |
NSPrivacyAccessedAPICategorySystemBootTime |
Tiempo transcurrido, temporizadores o marcas de tiempo absolutas |
NSPrivacyAccessedAPICategoryActiveKeyboards |
Extensión de teclado o detección de entrada |
Para cada categoría que uses, añade un diccionario con NSPrivacyAccessedAPIType y NSPrivacyAccessedAPITypeReasons. Elige solo códigos de motivo que Apple lista para esa categoría. Códigos incorrectos provocan rechazos en la revisión.
Fragmento de ejemplo (ajusta las categorías y códigos para que coincidan con tu app tras inspeccionar el informe de privacidad):
<key>NSPrivacyAccessedAPITypes</key>
<array>
<dict>
<key>NSPrivacyAccessedAPIType</key>
<string>NSPrivacyAccessedAPICategoryUserDefaults</string>
<key>NSPrivacyAccessedAPITypeReasons</key>
<array>
<string>CA92.1</string>
</array>
</dict>
</array>
el propio Capacitor aparece en la requisitos de SDK de terceros así que el framework incluye un manifiesto para el uso de API del propio Capacitor. Aun así, necesitas un manifiesto a nivel de app para tus capas nativas y de JavaScript, plugins y cualquier API no cubierta por las dependencias.
ITMS-91053: falta la declaración de API
ITMS-91053 significa que App Store Connect detectó un motivo requerido de API en tu build sin la entrada correspondiente en un manifiesto de privacidad combinado.
Solución:
- Lee el correo de rechazo o el log de subida. Ahí se indica el API categoría (por ejemplo
NSPrivacyAccessedAPICategoryDiskSpace). - Abre el informe de privacidad del archive en Xcode (Producto > Archivo, luego Generar informe de privacidad en el archive) y comprueba si la brecha está en el target de tu app o en una dependencia.
- Si el API está en tus code o un plugin propio, añade la categoría y un motivo aprobado a
ios/App/PrivacyInfo.xcprivacy. - Si el API proviene de una dependencia, actualiza el pod o el paquete SPM a una versión que incluya un manifest, o parchea el plugin y declara solo lo que tu fork realmente invoca.
- Reempaqueta y confirma que la categoría aparece en el informe antes de volver a subir.
No declares categorías que no uses. El análisis estático de Apple se basa en los símbolos del binario.
ITMS-91061: falta el privacy manifest de terceros
ITMS-91061 significa un SDK que afecta a la privacidad en tu app bundle no tiene PrivacyInfo.xcprivacy. Apple indica que al publicar una app nueva o una actualización que añade un SDK listado, que SDK debe incluir un manifiesto; los SDK binarios también necesitan un válido firma del proveedor de SDK.
Corrección:
- Copia la ruta del framework desde el email (por ejemplo,
Frameworks/FirebaseCore.framework/FirebaseCore). - Identifica el paquete binario de CocoaPods, SPM o vendored.
- Actualiza a una versión del vendor que incluya
PrivacyInfo.xcprivacyen la raíz del framework. - Limpia, reconstruye y verifica el archivo dentro de
.xcarchiveantes de subirlo.
No muevas la colección de SDK o las declaraciones de API al manifiesto de tu app. Apple advierte explícitamente que el manifiesto solo debe describir la app. Si el SDK no tiene mantenimiento, reemplázalo o usa un build vendored compatible.
Los SDK listados incluyen stacks móviles comunes (Firebase, Flutter, Capacitor, shared_preferences_iosy otros). Consulta la lista actual en el sitio de Apple antes de cada release.
Manifiestos y firmas de SDK de terceros
Al actualizar una dependencia, Xcode valida que los frameworks binarios estén firmados por el mismo desarrollador que en las versiones anteriores. Eso protege la cadena de suministro cuando los manifiestos cambian.
Flujo de trabajo práctico:
- Después de
pod installo al resolver SPM, buscaios/paraPrivacyInfo.xcprivacyarchivos. - Archiva y usa Generar informe de privacidad para ver el panorama completo.
- Compara el informe con las respuestas de tu cuestionario de privacidad de App Store.
Para las herramientas de live update, declara las APIs de motivo requerido que tu actualizador usa realmente (por ejemplo, espacio en disco, marcas de tiempo de archivos o UserDefaults). El acceso a la red no es una categoría de motivo requerido de API. Si el actualizador recopila datos personales, incluye esos datos en las etiquetas de privacidad de App Store y en las respuestas del cuestionario; descargar una actualización por HTTPS por sí solo no crea una nueva categoría de divulgación. Mantén cumplimiento de Capgo live update en cuenta al documentar el comportamiento OTA.
Añadir PrivacyInfo.xcprivacy en un proyecto iOS de Capacitor
- Sincroniza el proyecto nativo:
bunx cap sync ios. - Abre el espacio de trabajo de Xcode en
ios/App. - Archivo > Nuevo > Archivo, elige App Privacy (o añadir un
PrivacyInfo.xcprivacyplist vacío). - Guarda el archivo en
ios/App(la misma carpeta queAppDelegateva bien). - En el target Fases de compilación > Copiar recursos del bundle, confirma que
PrivacyInfo.xcprivacyestá listado. - Completa el seguimiento, los tipos de datos recopilados y las APIs de motivo requerido según tu app y plugins.
- Archiva, genera el informe de privacidad y corrige las categorías que falten antes de subir a App Store Connect.
Si editas el plist como XML en disco, vuelve a abrir Xcode para que la pertenencia al target siga siendo correcta.
Cada app o target de SDK mantiene su propio PrivacyInfo.xcprivacy. Al archivar, Xcode agrupa esos manifiestos en un único informe de privacidad. No tienes que fusionar manualmente los plists de dependencias en el archivo de tu app.
Para un plugin de Capacitor personalizado se distribuye como su propio framework de iOS, añade PrivacyInfo.xcprivacy bajo la de ese plugin ios/Plugin/ carpeta (o equivalente) y lístalo en el target del plugin: Copiar recursos del bundle, no solo en el target de la app.
Cuando NSPrivacyTracking es cierto o si integras SDKs de anuncios o analítica, alinea el manifest con las etiquetas de privacidad de la App Store y muestra el prompt de App Tracking Transparency cuando iOS lo requiera. @capgo/capacitor-app-tracking-transparency cubre el flujo de ATT para apps de Capacitor.
Checklist de validación antes de enviar
- El target de la app incluye
PrivacyInfo.xcprivacyen Copiar recursos del bundle. - Cada categoría de motivo requerida en el rechazo o informe tiene códigos de motivo aprobados.
- Cada SDK de terceros listado en el build incluye su propio manifiesto en la ruta esperada.
- El informe de privacidad coincide con tu comprensión de los SDK de analítica, anuncios y autenticación.
- Las etiquetas de privacidad de App Store se alinean con el informe fusionado.
FAQ
¿Los plugins de Capacitor necesitan sus propios manifiestos de privacidad?
Si un plugin se distribuye como código fuente en tu repo, su uso de API forma parte del binario de tu app. Declara las APIs que el plugin llama en el app manifest, o contribuye con un manifest dentro del target del plugin si se distribuye como un framework independiente. Los pods binarios deben cumplir las reglas de terceros de Apple SDK.
¿Puedo corregir ITMS-91061 editando solo el PrivacyInfo.xcprivacy de mi app?
No. El SDK debe incluir el manifest. Tu archivo solo debe documentar las prácticas de tu app.
¿Dónde se documentan las fechas de las políticas de Apple?
APIs de motivo requerido: obligatorias desde 1 de mayo de 2024. Las reglas de firma y manifiesto de terceros para los SDK listados se describen en Requisitos de SDK de terceros.
Continuar desde Privacy Manifest para apps iOS
Si estás usando Privacy Manifest para apps iOS para planificar la seguridad y el cumplimiento, conéctalo con Cifrado para los detalles de implementación en Cifrado, Cumplimiento para los detalles de implementación en Cumplimiento, Escáner de seguridad de Capgo para el flujo de trabajo del producto en Capgo Security Scanner, Seguridad de Capgo para el flujo de trabajo del producto en Capgo Security, y Centro de confianza de Capgo para el flujo de trabajo del producto en Capgo Trust Center.