Guía de Declaración de Privacidad para aplicaciones Capacitor

¿Quieres lanzar tu Capacitor aplicación en el App Store ¿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, API uso y dominios de seguimiento.
Por qué importa:
- Cumple con las reglas del App Store 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 del usuario (por ejemplo, ubicación, fotos).
- Etiquetas de privacidad para los tipos de datos recopilados.
- Seguimiento de dominios 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.
- Validarlo con herramientas como Xcode para evitar errores.
Herramientas para simplificar el proceso:
Use plataformas como Capgo para la validación automática del manifiesto de privacidad, actualizaciones en tiempo real y seguimiento de errores.

Stay compliant, protect user privacy, y evita retrasos en la tienda de aplicaciones siguiendo esta guía.

Elementos 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 APIs 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 manifest debe incluir.

Elementos principales del manifiesto de privacidad

Aquí tienes 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 APIs 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 de 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 uso
Biblioteca de fotos	Fotos de perfil	Nivel de acceso y intención
Contactos	Sincronización del libro de direcciones	Declaración de minimización de datos

Etiquetas de privacidad
Estos etiquetas proporcionan transparencia especificando:
- Tipos de datos que se están recopilando
- Motivos para la recopilación de datos
- ¿Se vincula la información recopilada a la identidad del usuario?
- ¿Cómo se utiliza la información recopilada 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 actualizada la documentación de privacidad es fundamental para mantener la confianza del usuario.

Creación de 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ú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 detalle las prácticas de recopilación de datos de su aplicación

Pasos de Creación

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

Configuración de Información Básica

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

Definición de 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.
Utilizar Tipos de API Válidos: Verifica los identificadores de API con la documentación oficial de Apple.
Verificar la Formateo 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: 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, integre 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 su proyecto Capacitor, coloque el archivo en la siguiente estructura de directorios: PrivacyInfo.xcprivacy Para plugins __CAPGO_KEEP_0__, utilice 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 las configuraciones de compilación de Xcode para asegurarse de que se integre correctamente:

Abra su proyecto en Xcode.

Bajo
CONFIGURACIONES DEL OBJETIVO TARGETSseleccione el objetivo de su aplicación o plugin.
Ir a la sección de Configuración de compilación pantalla.
Establecer Región de desarrollo del manifiesto de privacidad a en.
Establecer Incluir manifiesto de privacidad Si su proyecto utiliza YES.

CocoaPods Setincluya el siguiente fragmento en su Podfile para 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

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 funciona 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 las solicitudes de privacidad y el acceso a API.
Validación de App Store Connect
- Sube tu build y revisa el Informe de Privacidad en App Store Connect.
- Asegúrate de que las declaraciones API estén completas y los formatos de dominio de seguimiento sean correctos.

Si encuentras un error de "validación de manifiesto de privacidad fallida", revisa tu manifiesto para asegurarte de que cumple con los requisitos más recientes de la App Store. Presta 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, integra un seguimiento de errores confiable en tu proceso de desarrollo. Esto ayuda a vincular los esfuerzos de desarrollo con los requisitos de cumplimiento.

Una herramienta como Capgo puede ayudarte. Monitorea el acceso API e identifica problemas en el manifiesto antes de que afecten a los usuarios. Una vez que se han identificado posibles problemas, puedes centrar tu atención en una validación exhaustiva.

Después de realizar actualizaciones, prueba tu manifiesto en un entorno de desarrollo. Utiliza las pistas de seguimiento de errores para guiar tu revisión. Este enfoque ayuda a asegurarte de que tu aplicación se alinee con los estándares de privacidad de Apple.

Capgo Herramientas de Privacidad

Capgo Panel de control de actualizaciones en vivo

Capgo simplifica 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:

Cifrado de extremo a extremo para mantener actualizaciones seguras
sistema de canales para la distribución de actualizaciones controlada
seguimiento de errores para identificar y abordar problemas rápidamente
devolución automática para revertir 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 plugin Capgo con este comando:

npx @capgo/cli init

Capgo integra de manera fluida con las pipelines de 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 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.

“La práctica de 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 tu base de usuarios mientras se mantiene la conformidad con las directrices de Apple.

Conclusión

Toma de Claves

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

Cifrado de extremo a extremo: 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 soluciones rápidas.
La automatización de la validación: Asegura que sus actualizaciones cumplan con los estándares de cumplimiento.

Crear un sistema de actualizaciones confiable te ayuda a mantener el ritmo con los requisitos de privacidad en constante evolución de Apple y Google. Este enfoque ha demostrado mejorar las tasas de aprobación en las tiendas de aplicaciones y fortalecer la confianza de los usuarios [1].

Cómo Empezar

Puedes comenzar a implementar estos principios siguiendo estos pasos:

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

“Capgo es una herramienta imprescindible para desarrolladores que desean aumentar la 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.

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