Quieres lanzar tu Capacitor aplicación en la Tienda de Aplicaciones ¿sin retrasos? Comience creando un Manifiesto de Privacidad. Apple ahora requiere a los desarrolladores que incluyan este documento para asegurarse de que las aplicaciones cumplan con estrictos estándares de privacidad. Aquí está lo que necesita saber:
-
¿Qué es un Manifiesto de Privacidad?
Un archivo estructurado que describe las prácticas de recopilación de datos de tu aplicación, API y dominios de seguimiento. -
Por qué importa:
- Cumple con las reglas de la Tienda de Aplicaciones para evitar rechazos o eliminación.
- Construye confianza al ser transparente sobre el manejo de datos de los usuarios.
-
Componentes clave a incluir:
- APIs que acceden a los datos de los usuarios (por ejemplo, ubicación, fotos).
- Etiquetas de privacidad para los tipos de datos recopilados.
- Dominios de seguimiento utilizados para análisis o publicidad.
-
Cómo crear uno:
- Utilice JSON para definir detalles de recopilación de datos.
- Coloque el
PrivacyInfo.xcprivacyarchivo en el directorio correcto de su proyecto. - Validéelo con herramientas como Xcode para evitar errores.
-
Herramientas para simplificar el proceso:
Utilice plataformas como Capgo para la validación automática del manifiesto de privacidad, actualizaciones en tiempo real y seguimiento de errores. Cuando su manifiesto declare SDKs de seguimiento o análisis, @capgo/capacitor-app-tracking-transparencia gestiona las solicitudes de ATT de iOS y @capgo/capacitor-firebase-análisis documenta la recopilación de datos de Firebase para la revisión de la Tienda de Aplicaciones.
Manténgase conforme, proteja la privacidad del usuario y evite retrasos en la tienda de aplicaciones siguiendo esta guía.
Bases de la Declaración de Privacidad
Definición de Declaración de Privacidad
Una declaración de privacidad es un archivo estructurado que describe las prácticas de datos de tu aplicación. Detalla elementos como las API que acceden a los datos del usuario, los dominios de seguimiento, los tipos de datos recopilados y las integraciones de terceros SDK. Este documento no solo ayuda a establecer la confianza sino que también garantiza el cumplimiento con las directrices de la Tienda de Aplicaciones. Vamos a desglosar los componentes clave que tu manifest debe incluir.
Elementos Principales de la Declaración de Privacidad
Aquí se presentan los elementos principales que debes incluir en tu declaración de privacidad para alinearte con los requisitos de Apple:
-
APIs de Razón Requeridas
Esta sección enumera las API sensibles a la privacidad que utiliza tu aplicación y explica por qué son necesarias.A continuación, se muestra una tabla que resume los requisitos comunes API:
API Categoría Uso común Documentación requerida Servicios de ubicación Navegación del usuario Descripción de la cadena de propósito y uso Librería de fotos Fotos de perfil Nivel de acceso e intención Contactos Sincronización del libro de direcciones Declaración de minimización de datos -
Etiquetas de privacidad
Estas etiquetas proporcionan transparencia especificando:- Tipos de datos recopilados
- Motivos de recopilación de datos
- Si los datos están vinculados a la identidad del usuario
- Cómo se utilizan los datos para el seguimiento
-
Dominios de seguimiento
Esta sección enumera todos los dominios involucrados en el seguimiento, como aquellos utilizados para análisis, publicidad o procesamiento de datos de terceros.
“Cumplimiento con la tienda de aplicaciones” - Capgo [1]
Según Capgo, el 95% de los usuarios cumple con las actualizaciones dentro de las 24 horas. Con más de 23,5 millones de actualizaciones entregadas [1], mantener su documentación de privacidad actualizada es fundamental para mantener la confianza del usuario.
Configurando Declaraciones de Privacidad para Capacitor
Requisitos de configuración
Antes de empezar a construir la declaración de privacidad, asegúrese de tener:
- Xcode 15 o posterior instalado
- Un proyecto de Capacitor 8.0+ configurado
- Acceso a los archivos de su aplicación
Info.plistUn archivo - Una comprensión básica de la estructura JSON
- Documentación que describe las prácticas de recopilación de datos de su aplicación
Pasos de creación
Comience creando un PrivacyInfo.xcprivacy archivo en el directorio de su proyecto de iOS. Este archivo debe seguir ciertas directrices de formato:
Configuración Básica
{
"NSPrivacyTracking": false,
"NSPrivacyTrackingDomains": [],
"NSPrivacyCollectedDataTypes": []
}Definir Detalles de Recopilación de Datos
{
"NSPrivacyAccessedAPITypes": [
{
"NSPrivacyAccessedAPIType": "NSLocationWhenInUseUsageDescription",
"NSPrivacyAccessedAPITypeReasons": ["1.1"]
},
{
"NSPrivacyAccessedAPIType": "NSCameraUsageDescription",
"NSPrivacyAccessedAPITypeReasons": ["2.1"]
}
]
}Agregar Dominios de Seguimiento
{
"NSPrivacyTrackingDomains": [
"analytics.yourdomain.com",
"metrics.yourdomain.com"
]
}Evitando Errores Comunes
Para evitar problemas, tenga en cuenta estos consejos:
- Incluir Todos los Campos Requeridos: Incluso si algunos campos están vacíos, deben estar presentes.
- Usar Tipos de API Válidos: Verifique los identificadores de API con la documentación oficial de Apple.
- Verificar la Formateación de JSON: Ejecuta tu archivo a través de un linter de JSON para detectar errores de sintaxis.
- Proporcionar Razones Completas: Asegúrate de que cada acceso a API incluya una razón correspondiente code.
- Mantener la Información Actualizada: Actualiza el manifiesto cada vez que se agreguen nuevas características.
También asegúrate de que el archivo del manifiesto se mantenga debajo de 512KB para evitar errores de compilación. Valida regularmente el archivo durante el proceso de compilación de Xcode para detectar errores temprano. Una vez que tu manifiesto esté listo, intégralo en tu proyecto de Capacitor siguiendo las directrices de colocación de archivos.
Agregar Manifiestos de Privacidad a Capacitor
Guía de Colocación de Archivos
Para incluir un manifiesto de privacidad en tu proyecto de Capacitor, coloca el archivo en la siguiente estructura de directorios: PrivacyInfo.xcprivacy Para plugins de __CAPGO_KEEP_0__, utiliza esta estructura:
your-app/
├── ios/
│ ├── App/
│ │ ├── PrivacyInfo.xcprivacy
│ │ └── Info.plist
│ └── App.xcworkspaceFor Capacitor plugins, use this structure:
your-plugin/
├── ios/
│ ├── Plugin/
│ │ └── PrivacyInfo.xcprivacy
│ └── Plugin.xcodeprojConfiguración de Configuración de Compilación
Una vez que el archivo está en su lugar, actualice sus ajustes de compilación de Xcode para asegurarse de que se integre correctamente:
- Abra su proyecto en Xcode.
- Bajo TARGETS, seleccione su objetivo de aplicación o plugin.
- Vaya a la Configuración de compilación pestaña.
- Establezca Región de desarrollo de manifiesto de privacidad a
en. - Establezca Incluya el Manifiesto de Privacidad para
YES.
contexto: Página/área: Página de producto de actualizaciones en vivo. Rol: Etiqueta de IU breve o elemento de navegación. Clave de mensaje `live_update_dynamic_label_to` (Etiqueta dinámica de actualizaciones en vivo a). Si su proyecto utilizaCocoaPods Podfile , incluya el siguiente fragmento en su
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
endpara habilitar el manifiesto de privacidad:
Después de realizar estos cambios, proceda con las comprobaciones de implementación para verificar que todo esté configurado correctamente.
Comprobación de Implementación
-
Para asegurarse de que el manifiesto de privacidad funcione como se espera, siga estos pasos:
- Verificación de Compilación
- Confirme que no hay advertencias relacionadas con la privacidad durante la compilación. Asegúrese de que el manifiesto se compile sin problemas.
- Verifique que el manifiesto de privacidad esté incluido en los productos de compilación.
-
Validación de tiempo de ejecución
- In debug mode, test for proper privacy prompts and API access behavior.
-
Validación de App Store Connect
- Suba su compilación y revise el Informe de Privacidad en App Store Connect.
- Verifique que las declaraciones de API sean completas y que los formatos de dominio de seguimiento sean correctos.
Si encuentra un error de "Validación de manifiesto de privacidad fallida", revise su manifiesto para asegurarse de que cumple con los requisitos más recientes de App Store. Preste especial atención a los tipos de API y las configuraciones de dominio de seguimiento.
Cambios en el manifiesto de privacidad de Apple
Pruebas y correcciones
Crear un manifiesto de privacidad que cumpla con las directrices de Apple es crucial. Para mantenerse en el camino, integre un seguimiento de errores confiable en su proceso de desarrollo. Esto ayuda a vincular los esfuerzos de desarrollo con los requisitos de cumplimiento.
Una herramienta como Capgo Puede ayudar. Monitorea el acceso a API y identifica problemas en el manifiesto antes de que afecten a los usuarios. Una vez que se han identificado posibles problemas, puede centrar su atención en una validación exhaustiva.
Una vez que se hayan realizado actualizaciones, pruebe su manifiesto en un entorno de desarrollo. Utilice las pistas de seguimiento de errores para guiar su revisión. Esta aproximación ayuda a asegurarse de que la aplicación se mantenga alineada con los estándares de privacidad de Apple.
Capgo Herramientas de Privacidad
Capgo simplifica la gestión de manifiestos de privacidad y actualizaciones de aplicaciones, asegurando que los estándares de privacidad permanezcan intactos sin retrasar los despliegues.
Capgo Características
Con más de 23,5 millones de actualizaciones seguras y un 82% de tasa de éxito global, Capgo ensures that 95% de usuarios activos reciben actualizaciones dentro de 24 horas [1]. Aquí está lo que ofrece:
- criptografía de extremo a extremo para mantener las actualizaciones seguras
- sistema de canales para la distribución de actualizaciones controlada
- seguidor de errores para identificar y abordar problemas rápidamente
- devolución automática para revertir instantáneamente a una versión anterior
Estos herramientas hacen que agregar Capgo a tu flujo de trabajo sea suave y eficiente.
Usando Capgo
Para empezar, instale el plugin Capgo con este comando:
npx @capgo/cli initCapgo integra de manera fluida con las pipelines CI/CD, automatizando la validación del manifiesto de privacidad a través de plataformas como Capgo Actions GitHub Actions, , oJenkins . Independientemente de que elija opciones en la nube o autogestionadas, __CAPGO_KEEP_0__ admite 750 aplicaciones de producción mientras garantiza que cada actualización cumpla con los estándares de privacidad.“Practicamos el desarrollo ágil y @Capgo es crucial en la entrega continua a nuestros usuarios!” – Rodrigo Mantica
“Capgo es una forma inteligente de realizar empujes de __CAPGO_KEEP_1__ calientes 🙂” – NASA's OSIRIS-REx
“Capgo is a smart way to make hot code pushes 🙂” – NASA’s OSIRIS-REx
Capgo también incluye análisis integrados para monitorear las tasas de éxito de actualizaciones y la participación de los usuarios en tiempo real. Esto garantiza que las actualizaciones de privacidad lleguen a toda su base de usuarios mientras se mantiene la conformidad con las directrices de Apple.
Conclusión
Resultados clave
Cuando se trata de gestionar manifestos de privacidad, mantener la conformidad y medidas de seguridad sólidas es crucial. Aquí está lo que importa más:
- Encriptación de extremo a extremoContext: Página/área: Sitio web de marketing de Capgo. Rol: Etiqueta de UI corta o elemento de navegación. Clave de mensaje `end_to_end_encryption` (End To End Encryption).
- : Mantiene las actualizaciones seguras desde el principio hasta el final.Monitoreo en tiempo real
- : Sigue la distribución de actualizaciones de manera efectiva.Capacidad de rollback instantáneo
- : Actúa como un seguro para correcciones rápidas.Validación automática
La creación de un sistema de actualizaciones confiable te ayuda a mantener el ritmo con los requisitos de privacidad en constante evolución de Apple y Google. Esta aproximación ha demostrado mejorar las tasas de aprobación de la tienda de aplicaciones y fortalecer la confianza del usuario [1].
¿Cómo Empezar?
Puedes comenzar a implementar estos principios siguiendo estos pasos:
- Configura tu entorno: Ejecuta
npx @capgo/cli initpara empezar. - Habilita características de privacidad: Utiliza la cifrado de extremo a extremo para actualizaciones seguras.
- Despliega herramientas de monitoreo: Sigue actualizaciones con análisis.
- Planifica rollbacks: Asegúrate de que puedas revertir rápidamente a versiones anteriores si es necesario.
“Capgo es una herramienta imprescindible para los desarrolladores que desean aumentar su productividad. Evitar retrasos en la revisión de correcciones de errores es un cambio de juego.” - Bessie Cooper
Actualizaciones regulares y herramientas adecuadas son clave para mantenerse conforme y mejorar con el tiempo.
Sigue adelante desde la Guía de la Declaración de Privacidad para aplicaciones Capacitor:
Si estás utilizando Declaración de Privacidad para aplicaciones Capacitor: para planificar la seguridad y la conformidad, conecta con Encriptación para el detalle de implementación en Encriptación, Conformidad para el detalle de implementación en Conformidad, Escáner de Seguridad Capgo para el flujo de trabajo del producto en Escáner de Seguridad Capgo, Capgo Seguridad para el flujo de trabajo del producto en Capgo Seguridad, y Capgo Centro de Confianza para el flujo de trabajo del producto en Capgo Centro de Confianza.
