Privacy Manifest for Capacitor Apps: Guide

Manifiesto de Privacidad para Aplicaciones __CAPGO_KEEP_0__ Capacitor __CAPGO_KEEP_0__ aplicación en la Tienda de Aplicaciones Start by creating a Privacy Manifest. Apple now requires developers to include this document to ensure apps meet strict privacy standards. Here’s what you need to know:

¿Qué es un Manifiesto de Privacidad?
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 datos de los usuarios.
Componentes clave a incluir:
- Las APIs que acceden a 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:
- Utiliza JSON para definir detalles de recopilación de datos.
- Coloque el PrivacyInfo.xcprivacy archivo en el directorio correcto de tu proyecto.
- Verifíquelo con herramientas como Xcode para evitar errores.
Herramientas para simplificar el proceso:
Usa 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-transparencia-de-app gestiona las solicitudes de ATT de iOS y @capgo/capacitor-análisis de Firebase documentos de recopilación de datos de Firebase para la revisión de la tienda App.

Mantente conforme, protege la privacidad del usuario y evita retrasos en la tienda de aplicaciones siguiendo esta guía.

Privacidad Manifesto Básicos

Definición de Privacidad Manifesto

Un manifesto 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 confianza sino que también garantiza el cumplimiento con las directrices de la Tienda de Aplicaciones. Vamos a desglosar los componentes clave que tu manifesto debe incluir.

Elementos Principales del Privacidad Manifesto

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.

A continuación se muestra una tabla que resume los requisitos comunes API.

Categoría de API	Uso Común	Documentación Requerida
Servicios de Ubicación	Navegación del usuario	Descripción de la finalidad y el 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 se utiliza el dato 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 la documentación de privacidad actualizada es fundamental para mantener la confianza del usuario.

Crear manifestos de privacidad para Capacitor

Capacitor Documentación del sitio web del marco de trabajo

Requisitos de configuración

Antes de empezar a construir el manifiesto, asegúrate de tener:

Xcode 15 o posterior instalado
Un proyecto Capacitor configurado con 8.0+
Acceso a los archivos de su aplicación Info.plist archivo
Una comprensión básica de la estructura de JSON
Guía para aplicaciones de Capacitor sobre la manifestación de privacidad

Pasos de Creación

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

Configuración de Informació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, ten 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álidosVerifique los identificadores API con la documentación oficial de Apple.
Comprobar la Formación de JSONEjecuta un linter de JSON en tu archivo 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 agregan nuevas características.

Además, asegúrese de que el archivo de manifesto no supere los 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 manifesto esté listo, intégralo en su proyecto Capacitor siguiendo las directrices de colocación de archivos.

Agregar manifestos de privacidad a Capacitor

Guía de colocación de archivos

Para incluir un manifiesto de privacidad en tu proyecto Capacitor, coloca el PrivacyInfo.xcprivacy Para plugins __CAPGO_KEEP_0__, utilice esta estructura:

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

Para Capacitor plugins, utilice esta estructura:

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

Configuración de Edició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.
OBJETIVOS TARGETSseleccione el objetivo de su aplicación o plugin.
Vaya a la Configuración de construcción página.
Establecer Desarrollo de la Declaración de Privacidad to en.
Establecer Incluya el Manifiesto de Privacidad to YES.

Incluir Declaración de Privacidad CocoaPodsCocoaPods, incluya el siguiente fragmento en su Podfile Habilitar el manifiesto 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

Una vez realizados estos cambios, proceda con las comprobaciones de implementación para verificar que todo esté configurado correctamente.

Comprobación de implementación

Siga estos pasos para asegurarse de que el manifiesto de privacidad esté funcionando como se espera.

Verificación de compilación
- Confirmar que no haya advertencias relacionadas con la privacidad durante la compilación.
- Comprobar que el manifiesto se compile sin problemas.
- Verificar que el manifiesto de privacidad esté incluido en los productos de compilación.
Validación de tiempo de ejecución
- En modo depuración, pruebe los prompts de privacidad adecuados y el comportamiento de acceso API.
Validación de App Store Connect
- Cargar su compilación y revisar el Informe de Privacidad en App Store Connect.
- Verifique que las declaraciones API estén completas y los formatos de dominio de seguimiento estén correctos.

Si se produce 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 la Tienda de Aplicaciones. 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 Reparaciones

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.

A tool like Capgo puede ayudar. Monitorea el acceso a API e identifica problemas con el manifiesto antes de que afecten a los usuarios. Una vez que se han identificado posibles problemas, puede centrarse en una validación exhaustiva.

Después de realizar actualizaciones, pruebe su manifiesto en un entorno de desarrollo. Utilice las inspecciones del seguimiento de errores para guiar su revisión. Esta aproximación ayuda a asegurarse de que la aplicación se alinee con los estándares de privacidad de Apple.

Capgo Herramientas de Privacidad

Capgo Live Update Panel de Control

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 éxito global, Capgo garantiza que 95% de los usuarios activos reciben actualizaciones dentro de las 24 horas [1]. Aquí está lo que ofrece:

Encriptación de extremo a extremo mantener actualizaciones seguras
Sistema de canal para la distribución de actualizaciones controladas
Seguimiento de errores para identificar y abordar problemas rápidamente
Revertir con un solo clic para reversionar instantáneamente a una versión anterior

Estos herramientas facilitan la integración de Capgo en tu flujo de trabajo.

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 Acciones, GitLab CI, o JenkinsIndependientemente de que elijas opciones de nube o autogestionadas, Capgo apoya 750 aplicaciones de producción asegurando que cada actualización cumpla con los estándares de privacidad.

“Practicamos el desarrollo ágil y @Capgo es crucial para entregar actualizaciones continuas a nuestros usuarios!” – Rodrigo Mantica

“Capgo es una forma inteligente de realizar 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

Toma de Claves

Cuando se trata de gestionar manifestos de privacidad, mantener la conformidad y medidas de seguridad sólidas es crucial. Aquí lo que importa más:

Encriptación de extremo a extremoMantiene actualizaciones seguras desde el inicio hasta el final.
Monitoreo en tiempo real: Rastrea de manera efectiva la distribución de actualizaciones.
Capacidad de rollback instantáneo: Actúa como un seguro para reparaciones rápidas.
Validación automática: Ensures your updates meet compliance standards.

Construir 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 en las tiendas de aplicaciones y fortalecer la confianza de los usuarios [1].

How to Get Started

Puedes comenzar a implementar estos principios siguiendo estos pasos:

Configura tu entorno: Ejecuta npx @capgo/cli init Para empezar.
Habilite las características de privacidad.Utilice la cifrado de extremo a extremo para actualizaciones seguras.
Despliegue herramientas de monitoreo.: Siga actualizaciones con análisis.
Planifique para revertir.: Asegúrese de que pueda revertir a versiones anteriores con rapidez si es necesario.

“Capgo es una herramienta imprescindible para desarrolladores que buscan 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 el Manifiesto de Privacidad para Capacitor Aplicaciones: Guía

Si está utilizando La Declaración 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, Conformidad para el detalle de implementación en Conformidad, 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.

Manual de privacidad para aplicaciones de Capacitor