Guía del Manifesto de Privacidad para aplicaciones Capacitor

Quieres lanzar tu Capacitor aplicación en la Tienda de Aplicaciones ¿sin retrasos? Comience creando un Manifiesto de Privacidad. Apple ahora requiere que los desarrolladores 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, el 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 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.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, Guía para aplicaciones de @capgo/capacitor-app-tracking-transparency gestiona las solicitudes de transparencia de la aplicación de iOS y @capgo/capacitor-firebase-analytics Manténgase conforme, proteja la privacidad del usuario y evite retrasos en la tienda de aplicaciones siguiendo esta guía.

Básicos 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 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 __CAPGO_KEEP_0__. Este documento no solo ayuda a establecer confianza sino que también garantiza el cumplimiento con las directrices de la Tienda de Aplicaciones. Vamos a desglosar los componentes clave que tu manifiesto debe incluir.

A privacy manifest is a structured file that outlines your app’s data practices. It details elements like APIs accessing user data, tracking domains, data types collected, and third-party SDK integrations. This document not only helps establish trust but also ensures compliance with App Store guidelines. Let’s break down the key components your manifest should include.

Aquí están los elementos principales que debes incluir en tu manifiesto 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.
@__CAPGO_KEEP_0__

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
Biblioteca 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
- Razones de recopilación de datos
- Si los datos están vinculados a la identidad del usuario
- Cómo los datos se utilizan 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 del usuario.

Configurando Declaraciones de Privacidad para Capacitor

Capacitor Documentación del Sitio Web del Marco de Trabajo

Requisitos de Configuración

Antes de empezar a construir la declaración, asegúrese de tener:

Xcode 15 o posterior instalado
Un proyecto Capacitor 8.0+ configurado
Acceso a los archivos de su aplicación Info.plist Un 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 archivo en el directorio de su proyecto iOS. PrivacyInfo.xcprivacy 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 las siguientes sugerencias:

Incluir Todos los Campos Requeridos: Incluso si algunos campos están vacíos, deben estar presentes.
Utilice Tipos de API Válidos: Verifique los identificadores de API con la documentación oficial de Apple.
Verifique la Formació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 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

Configuració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 pantalla.
Establezca Región de desarrollo de manifiesto de privacidad a en.
Establezca Incluir Declaración de Privacidad a YES.

Si su proyecto utiliza CocoaPods, incluya el siguiente fragmento en su Podfile a

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, continúe con las comprobaciones de implementación para verificar que todo esté configurado correctamente.

Comprobación de Implementación

Para asegurarse de que la declaración 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
- En modo de depuración, pruebe el comportamiento de acceso apropiado de API y las solicitudes de privacidad.
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 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 manifestación antes de que afecten a los usuarios. Una vez que se han señalado posibles problemas, puede centrar su atención en una validación exhaustiva.

Después de realizar actualizaciones, pruebe su manifest en un entorno de desarrollo. Utilice las pistas de seguimiento de errores para guiar su revisión. Esta aproximación ayuda a asegurar que su aplicación se mantenga alineada con los estándares de privacidad de Apple.

Capgo Herramientas de Privacidad

Capgo Live Update Dashboard Interface

Capgo facilita la gestión de manifestos de privacidad y actualizaciones de aplicaciones, asegurando que sus 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 globalCapgo garantiza que 95% de los usuarios activos reciben actualizaciones dentro de 24 horas [1]. Aquí está lo que ofrece:

Encriptación de extremo a extremo contexto: Página/área: Sitio web de marketing de Capgo. Rol: Etiqueta de IU o elemento de navegación corto. Clave de mensaje `end_to_end_encryption` (Encriptación de extremo a extremo).
para mantener las actualizaciones seguras Sistema de canales
para la distribución de actualizaciones controlada Seguimiento de errores
para identificar y abordar problemas rápidamente Reinicio instantáneo

These tools make adding Capgo to your workflow smooth and efficient.

Usando Capgo

Para empezar, instale el plugin Capgo con este comando:

npx @capgo/cli init

Capgo integra de manera fluida con las pipelines CI/CD, automatizando la validación del manifiesto de privacidad a través de plataformas como GitHub Actions, GitLab CI, o Jenkins. Independientemente de que elija opciones de 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 en la entrega continua a nuestros usuarios!” – Rodrigo Mantica

“Capgo es una forma inteligente de realizar empujes de code calientes 🙂” – 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` (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 actualizaciones de manera efectiva.Capacidad de rollback instantáneo
: Actúa como un seguro para reparaciones rápidas.Validación automática

Construyendo un sistema de actualizaciones fiable 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?

Comience a implementar estos principios siguiendo estos pasos:

Configura tu entorno: Inicia npx @capgo/cli init para empezar.
Habilite características de privacidad: Utilice la cifrado de extremo a extremo para actualizaciones seguras.
Implemente herramientas de monitoreo: Siga las actualizaciones con análisis.
Planifique los rollbacks: 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 su productividad. Evitar retrasos en la revisión de correcciones de errores es un cambio de juego.” - Bessie Cooper

Las actualizaciones regulares y las 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 La Declaración de Privacidad para aplicaciones Capacitor: para planificar la seguridad y la conformidad, conecta con La cifrado para el detalle de implementación en Cifrado, La conformidad para el detalle de implementación en Conformidad, El escáner de seguridad Capgo para el flujo de trabajo del producto en El 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.

Manifiesto de Privacidad para aplicaciones Capacitor