Guía del Manifiesto de Privacidad para aplicaciones Capacitor

¿Quieres lanzar tu Capacitor aplicación en la Tienda de Aplicaciones sin retrasos? Comienza creando una Declaración 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 debes saber:

¿Qué es una Declaración de privacidad?
Un archivo estructurado que describe las prácticas de recopilación de datos de tu aplicación, el uso de API y los dominios de seguimiento.
Por qué importa:
- Cumple con las reglas de la Tienda de Aplicaciones para evitar rechazos o eliminaciones.
- Construye confianza siendo transparente sobre el manejo de los datos del usuario.
Componentes clave a incluir:
- APIs que acceden a los datos del usuario (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.xcprivacy archivo 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-transparency gestiona las solicitudes de transparencia de ATT de iOS y @capgo/capacitor-firebase-analytics documenta la recopilación de datos de Firebase para la revisión de la tienda App.

Manténgase conforme, proteja la privacidad del usuario y evite retrasos en la tienda de aplicaciones siguiendo esta guía.

Bases del Manifiesto de Privacidad

Definición del Manifiesto de Privacidad

Un manifiesto de privacidad es un archivo estructurado que describe las prácticas de datos de la 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 App. Vamos a desglosar los componentes clave que su manifiesto debe incluir.

Elementos de Manifesto de Privacidad Protegidos

Aquí se presentan los elementos principales que deben incluirse en el manifesto de privacidad para alinearse con los requisitos de Apple:

Requisitos de API de Razón
Esta sección enumera las API sensibles a la privacidad que utiliza su 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	Cadena de propósito y descripción de uso
Librería de fotos	Perfiles de imagen	Nivel de acceso e intención
Contactos	Sincronización de 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 24 horas. Con más de 23,5 millones de actualizaciones entregadas [1]mantener actualizada la documentación de privacidad es fundamental para mantener la confianza de los usuarios.

Crear manifestos de privacidad para Capacitor

Documentación del sitio web del marco de trabajo Capacitor

Requisitos de configuración

Antes de empezar a crear el manifiesto, asegúrese de tener:

Xcode 15 o posterior instalado
Un proyecto Capacitor 8.0+ configurado
Acceso a la aplicación de su aplicación Info.plist file
Un conocimiento básico de la estructura de JSON
Documentación que describe las prácticas de recopilación de datos de tu aplicación

Pasos de Creación

Comienza creando un PrivacyInfo.xcprivacy archivo en el directorio de proyecto de iOS. Este archivo debe seguir ciertas directrices de formato:

Configuración de Información Básica

{
    "NSPrivacyTracking": false,
    "NSPrivacyTrackingDomains": [],
    "NSPrivacyCollectedDataTypes": []
}

Define 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, ten en cuenta estos consejos:

Incluir Todos los Campos Requeridos: Aunque algunos campos estén vacíos, deben estar presentes.
Use Tipos de Datos Válidos API: Verifique los identificadores API con la documentación oficial de Apple.
Verificar la Formateo de JSON: Ejecute su archivo a través de un linter de JSON para detectar errores de sintaxis.
Proporcionar Razones Completas: Asegúrese de que cada acceso API incluya una razón correspondiente code.
Mantener la Información Actualizada: Actualice el manifiesto cada vez que se agreguen nuevas características.

También asegúrese de que el archivo de manifiesto se mantenga debajo de 512KB para evitar errores de compilación. Valide regularmente el archivo durante el proceso de compilación de Xcode para detectar errores temprano. Una vez que su manifiesto esté listo, intégrelo en su proyecto 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 Capacitor, coloca el archivo en la siguiente estructura de directorios: PrivacyInfo.xcprivacy Para plugins __CAPGO_KEEP_0__, utiliza esta estructura:

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

For Capacitor plugins, use this structure:

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

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 pestaña
Configuración de Compilación Para incluir un manifiesto de privacidad en tu proyecto __CAPGO_KEEP_0__ place the file in the following directory structure: Para plugins __CAPGO_KEEP_0__ use this structure:
Establecer Declaración de privacidad Desarrollo de la región a en.
Establecer Incluir Declaración de privacidad a YES.

Si su proyecto utiliza CocoaPods, incluya el siguiente fragmento en su Podfile para habilitar la declaración de privacidad:

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

Después de realizar estos cambios, proceda con las comprobaciones de implementación para verificar que todo esté configurado correctamente.

Verificación de implementación

To asegurarse de que el manifiesto de privacidad está funcionando como se espera, siga estos pasos:

Verificación de construcción
- Confirmar que no hay advertencias relacionadas con la privacidad durante la construcción.
- Asegurarse de que el manifiesto se compile sin problemas.
- Verificar que el manifiesto de privacidad esté incluido en los productos de construcción.
Validación de tiempo de ejecución
- En modo de depuración, pruebe el comportamiento de promoción de privacidad y API acceso.
Validación de App Store Connect
- Suba su construcción y revise el Informe de Privacidad en App Store Connect.
- Compruebe que las declaraciones 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 API y las configuraciones de dominio de seguimiento.

Cambios en el manifiesto de privacidad de Apple

Pruebas y Reparaciones

Crear un manifiesto de privacidad que cumpla con las directrices de Apple es crucial. Para mantener el ritmo, 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 de manifiesto antes de que afecten a los usuarios. Una vez que se han señalado posibles problemas, puede centrarse en una validación exhaustiva.

Después de realizar actualizaciones, pruebe su manifiesto en un entorno de desarrollo. Utilice las pistas del 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 Dashboard de Actualización en Vivo

Capgo simplifica la gestión de manifiestos de privacidad y actualizaciones de aplicaciones, asegurando que sus estándares de privacidad permanezcan intactos sin retrasar los despliegues.

Capgo Características

With más de 23,5 millones de actualizaciones seguras y un 82% de tasa de éxito global, Capgo garantiza que 95% de los usuarios activos reciben actualizaciones dentro de 24 horas [1]. Aquí está lo que ofrece:

Encriptación de fin a fin para mantener las actualizaciones seguras
Sistema de canales para la distribución controlada de actualizaciones
Seguimiento de errores To identificar y abordar problemas rápidamente
Rol de devolución de clic To reversionar instantáneamente a una versión anterior

Estas herramientas hacen que agregar Capgo a tu flujo de trabajo sea suave y eficiente.

Usando Capgo

Para empezar, instale el complemento Capgo con este comando:

npx @capgo/cli init

Capgo integra de manera transparente con las cadenas de integración y entrega continuas, automatizando la validación del manifiesto de privacidad a través de plataformas como GitHub Actions, GitLab CI, o JenkinsIndependientemente de que elijas opciones en la nube o autogestionadas, Capgo 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 para entregar continuamente a nuestros usuarios!” – Rodrigo Mantica

“Capgo es una forma inteligente de hacer actualizaciones de code calientes 🙂” – NASA’s OSIRIS-REx

Capgo también incluye análisis integrados para monitorear las tasas de éxito de las 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 mantener medidas de seguridad sólidas es crucial. Aquí lo que importa más:

Encriptación de extremo a extremo: Mantén las actualizaciones seguras desde el principio hasta el final.
Monitoreo en tiempo real: Sigue la distribución de las actualizaciones de manera efectiva.
Capgo: Actúa como una red de seguridad para arreglos rápidos.
Capgo: Asegura que tus actualizaciones cumplan con los estándares de cumplimiento.

Crear un sistema de actualizaciones confiable te ayuda a mantenerse al día con los requisitos de privacidad en constante evolución de Apple y Google. Este enfoque 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: Corre npx @capgo/cli init para empezar.
Habilita características de privacidad: Utiliza cifrado de extremo a extremo para actualizaciones seguras.
Implementar herramientas de monitoreo: Seguir actualizaciones con análisis.
Planificar para revertir: Asegúrese de que pueda revertir rápidamente a versiones anteriores si es necesario.

“Capgo es una herramienta imprescindible para los desarrolladores que desean aumentar la productividad. Evitar retrasos en la revisión para los arreglos de errores es un cambio de juego.” - Bessie Cooper

Actualizaciones regulares y herramientas adecuadas son clave para mantenerse conforme y mejorar con el tiempo.

Siga adelante desde el Manifiesto de Privacidad para Aplicaciones Capacitor: Guía

Si está utilizando Manifiesto de Privacidad para Aplicaciones Capacitor: Guía para planificar la seguridad y la conformidad, conecte con Encriptación para el detalle de implementación en Encriptación, Compliance para el detalle de implementación en Compliance, Capgo Escáner de Seguridad para el flujo de trabajo del producto en Capgo Escáner de Seguridad, 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.

Declaración de privacidad para aplicaciones Capacitor : Guía