KappS Base de conocimiento · Blog

Apple Manifiestos de privacidad en 2026: la lista de verificación de API con motivo requerido

Blog Lista de verificación

El requisito de manifiesto de privacidad de Apple está en vigor desde el 1 de mayo de 2024 y sigue siendo uno de los pocos fallos de envío que no tienen nada que ver con el comportamiento de tu app: una compilación que usa una API con motivo requerido sin declarar el motivo simplemente no es aceptada por App Store Connect. En el mismo archivo conviven dos obligaciones distintas: las declaraciones de recopilación de datos, que se aplican en todas las plataformas, y las declaraciones de API con motivo requerido, que se aplican en iOS, iPadOS, tvOS, visionOS y watchOS. Si tu app enlaza uno de los SDK de la lista de SDK de uso común de Apple, también se requiere el manifiesto de privacidad de ese SDK, y además se exige una firma cuando el SDK se usa como dependencia binaria. Estas son las doce comprobaciones que ejecutamos antes de que un archivo salga del Mac.

La versión en una línea: el archivo debe llamarse PrivacyInfo.xcprivacy, debe estar en el paquete que contiene el código que usa la API, y cada categoría de API debe declararse con un código de motivo que publique Apple, no con una frase que hayas escrito tú.

1. ¿Realmente se requiere un manifiesto para esta app?

Dos obligaciones lo deciden, y su alcance difiere. Las declaraciones de recopilación de datos son necesarias para tu app o SDK de terceros en todas las plataformas. Las declaraciones de API de motivo requerido son necesarias en iOS, iPadOS, tvOS, visionOS y watchOS. Si la app usa una API de motivo requerido, recopila datos sobre la persona que usa apps que la incluyen, permite que la app recopile datos sobre las personas que la usan o contacta con dominios de seguimiento, necesita el archivo. Si es uno de los SDK de la lista, lo necesita de todos modos.

2. ¿El archivo tiene el nombre exacto y está en el paquete?

PrivacyInfo.xcprivacy es el nombre de archivo obligatorio; Apple rechaza cualquier otro. En Xcode: Archivo > Nuevo archivo, desplázate hasta la sección Recurso, elige el tipo Archivo de privacidad de la app, marca tu target y créalo. Luego confirma que aparece en los recursos de ese target, porque Xcode solo usa un manifiesto que encuentre allí cuando genera el informe de privacidad. Si distribuyes un SDK de terceros como biblioteca estática, usa la compatibilidad con frameworks estáticos añadida en Xcode 15 y añade el manifiesto a los recursos del bundle del target del framework junto con los demás recursos.

3. ¿Están presentes las cuatro claves de nivel superior?

  • NSPrivacyTracking: si la app o el SDK de terceros usa datos para el seguimiento.
  • NSPrivacyTrackingDomains — los dominios contactados para el rastreo.
  • NSPrivacyCollectedDataTypes: un diccionario por cada tipo de dato recopilado, donde se indica el tipo de dato, si está vinculado a la identidad de la persona, si se usa para seguimiento y con qué fines.
  • NSPrivacyAccessedAPITypes — un diccionario por cada categoría de API con motivo requerido, cada uno indicando la categoría y sus códigos de motivo.

Si la app no rastrea, dilo explícitamente en el archivo en lugar de omitir las claves de rastreo.

4. ¿Has auditado las cinco categorías de API con motivo de acceso obligatorio?

Apple agrupa las API reguladas en cinco categorías. Audita el código que escribiste y, por separado, el código dentro de cada SDK que enlazas: basta una sola llamada para que la declaración sea necesaria:

  • Marca de tiempo de archivo — getattrlist, getattrlistbulk, fgetattrlist, fstat, fstatat, lstat, getattrlistat.
  • Hora de arranque del sistema — mach_absolute_time().
  • Espacio en disco — statfs, statvfs, fstatfs, fstatvfs, además de la familia getattrlist.
  • Teclados activos: las API que informan qué teclados están activos en el dispositivo.
  • Valores predeterminados del usuario — lee y escribe a través de las API de valores predeterminados del usuario.

5. ¿Cada entrada usa un código de motivo aprobado?

Los códigos de motivo son cadenas fijas que publica Apple; eliges de la lista, no escribes los tuyos. Los que declaramos con más frecuencia: marcas de tiempo de archivos: DDA9.1 (mostrar marcas de tiempo a la persona que usa el dispositivo), C617.1 (archivos dentro de la app, el grupo de apps o el contenedor de CloudKit), 3B52.1 (archivos o directorios que el usuario concedió específicamente, por ejemplo mediante un selector de documentos), 0A2A.1 (un SDK de terceros que envuelve la API para la app). Hora de arranque del sistema: 35F9.1 (medir el tiempo transcurrido entre eventos de la app o ejecutar temporizadores), 8FFB.1 (marcas de tiempo absolutas de eventos ocurridos en tu app), 3D61.1 (hora de arranque dentro de un informe de errores opcional que envía la persona). Espacio en disco: 85F4.1 (mostrar el espacio en disco a la persona que usa el dispositivo), E174.1 (comprobar que hay espacio suficiente para escribir o liberar espacio cuando escasea), 7D9E.1 (espacio en disco dentro de un informe de errores opcional), B728.1 (app de investigación sanitaria). Valores predeterminados del usuario: CA92.1 (datos accesibles solo para la propia app), 1C8F.1 (app, extensiones de app y App Clips), C56D.1 (envoltorio de SDK, solo SDK de terceros), AC6B.1 (claves de configuración gestionadas por MDM). Teclados activos: 3EC4.1 (app de teclado personalizado), 54BD.1 (presentar la interfaz personalizada correcta).

6. ¿Coinciden los motivos con la funcionalidad que ven los usuarios?

Cada motivo conlleva sus propias condiciones, y los revisores las leen. E174.1 exige que la app se comporte de forma distinta según el espacio en disco de una manera observable para los usuarios. 3EC4.1 está reservado para apps cuya funcionalidad principal es un teclado personalizado para todo el sistema. 3D61.1 exige que el tiempo de arranque se muestre de forma destacada como parte de un informe que la persona elige enviar. Elige el motivo que describa lo que el código realmente hace; los motivos declarados también deben ser coherentes con la funcionalidad que presentas a los usuarios.

7. ¿Has detenido todas las transferencias que el motivo prohíbe?

Declarar un motivo habilita el uso de la API y de los datos derivados de ella solo para ese motivo. La mayoría de los motivos incluyen la frase de que la información, y todo lo derivado de ella, no puede enviarse fuera del dispositivo. Las excepciones documentadas son limitadas: el tiempo transcurrido entre eventos dentro de la app puede salir del dispositivo (35F9.1); las marcas de tiempo absolutas dentro de la app pueden salir (8FFB.1), pero el tiempo de arranque no; los valores de los informes de errores solo pueden salir después de que la persona envíe afirmativamente ese informe concreto; y el espacio en disco puede pasar por la red local a otro dispositivo de la misma persona para mostrarse, nunca por internet. Los SDK de analítica son donde esta regla se incumple primero, así que revisa qué suben antes de firmar la declaración.

8. ¿Es coherente la declaración de seguimiento?

La creación de huellas digitales está prohibida tanto si la persona concedió el permiso de seguimiento como si no, y no puedes usar estas API ni los datos derivados de ellas para el seguimiento. Si la respuesta es que no hay seguimiento, ponlo en el archivo: un falso explícito es una declaración, el silencio no.

9. ¿A qué manifiesto corresponde el SDK?

El del propio SDK. Un SDK de terceros no puede basarse en el manifiesto de la app que lo integra, ni en los de otros SDK que la app integra. Cada ejecutable o biblioteca dinámica de una app que usa una API con motivo requerido necesita un paquete que contenga un manifiesto que lo declare. La regla espejo es más benévola: el manifiesto de privacidad de tu app no tiene que cubrir los datos que recopilan los SDK de terceros que tu app integra.

10. ¿Has revisado la lista de SDK y sus firmas?

El manifiesto de privacidad es obligatorio para cualquier SDK de la lista de Apple cuando envías una app nueva que lo incluya, o una actualización que añada uno de los SDK de la lista; además, se exigen firmas cuando esos SDK se usan como dependencias binarias, para que Xcode pueda validar que el SDK fue firmado por el mismo desarrollador. Todas las versiones de un SDK de la lista entran en el ámbito, y también cualquier SDK que reempaquete uno de la lista. La lista afecta a la mayoría de los stacks reales: entre ellos, Flutter y sus plugins habituales, FirebaseCore, FirebaseMessaging, FirebaseCrashlytics, OneSignal, Alamofire, SDWebImage, Reachability, nanopb, GoogleUtilities, UnityFramework y hermes. Cuando uno de ellos pone en cuarentena un envío, la solución suele ser actualizar a una versión que incluya su propio manifiesto y firma.

11. ¿Puedes generar el informe de privacidad antes de subir la app?

Abre el proyecto en Xcode, elige Producto > Archivar y luego, con la tecla Control pulsada, haz clic en el archivo en el Organizador y elige Generar informe de privacidad. Xcode combina tu manifiesto con los manifiestos de todos los SDK a los que se vincula la app. Lee ese informe antes de rellenar los detalles de privacidad en App Store Connect, no después: es la misma imagen que ve el revisor.

12. ¿Qué ocurre si lo subes sin ella?

Primero un correo: Apple envía un recordatorio para añadir el motivo que falta al manifiesto de privacidad de la app. Después, la parada total: desde el 1 de mayo de 2024, las apps que no describen su uso de las API de motivo requerido no son aceptadas por App Store Connect. No hay cola de revisión para una compilación que no supera esta validación, y una cartera grande lo nota de inmediato, porque el mismo uso recurrente de la API aparece en todos los paquetes.

Fuentes

¿Gestionas cuentas de desarrollador a escala? Nosotros nos encargamos de la parte operativa.

Haz clic para elegir un archivo · clic derecho → Pegar, o pulsa Ctrl/⌘+V para pegar una captura de pantalla

También puedes arrastrar un archivo a este cuadro.

Respondemos al correo que nos proporciones. Tus datos se quedan con KappS.

✔ Enviado

Hemos recibido tu mensaje y responderemos en un plazo de 24 horas.


← Volver a editar