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

¿Quieres lanzar tu Capacitor aplicación en la Tienda de Aplicaciones sin retrasos? Comienza creando un Manifiesto de Privacidad. Apple ahora requiere que los desarrolladores incluyan este documento para asegurarse de que las aplicaciones cumplan con los estrictos estándares de privacidad. Aquí está lo que debes 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 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:
- Utiliza JSON para definir detalles de recopilación de datos.
- Coloca el archivo en el directorio correcto de tu proyecto. PrivacyInfo.xcprivacy Por ejemplo:
- Verifíquelo con herramientas como Xcode para evitar errores.
Herramientas para simplificar el proceso:
Usa plataformas como Capgo para la validación de manifiesto de privacidad automatizada, actualizaciones en tiempo real y seguimiento de errores.

Cumple con los requisitos, protege la privacidad del usuario y evita 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 tu aplicación. Detalla elementos como las APIs que acceden a los datos del usuario, dominios de seguimiento, tipos de datos recopilados y 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 manifiesto debe incluir.

Elementos principales del Manifiesto de Privacidad

Aquí se presentan los elementos principales a incluir en su manifiesto de privacidad para alinearse con los requisitos de Apple:

APIs de Razón Requeridas
Esta sección enumera las APIs 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 del uso
Biblioteca de fotos	Fotografías de perfil	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
- Razones para la 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 del usuario.

Crear manifestos de privacidad para Capacitor

Capacitor Documentación del marco de trabajo del sitio web

Requisitos de configuración

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

Xcode 15 o posterior instalado
Un proyecto Capacitor 8.0+ configurado
Acceso a la carpeta de tu aplicación Info.plist archivo
Una comprensión básica 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 iOS. Este archivo debe seguir las pautas de formato específicas:

Configuración de Información Básica

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

Define los 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.
Use Valid API Types: Verifica los tipos de API válidos.
: Verifica la formación de JSON.: Ejecuta tu archivo a través de un linter de JSON para detectar errores de sintaxis.
: Asegúrate de que cada acceso a __CAPGO_KEEP_0__ incluya una razón correspondiente __CAPGO_KEEP_1__.: Make sure every API access includes a corresponding reason code.
: Actualiza el manifiesto cada vez que se agreguen nuevas características.: Asegúrate de que el archivo de 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 __CAPGO_KEEP_0__ siguiendo las directrices de colocación de archivos.

Agregar Manifiestos de Privacidad a Capacitor

Adding Privacy Manifests to Capacitor

Para incluir un manifiesto de privacidad en tu proyecto __CAPGO_KEEP_0__, coloca el

Adding Privacy Manifests to Capacitor PrivacyInfo.xcprivacy estructura de directorio siguiente:

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

Para los plugins Capacitor, utilice esta estructura:

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

Configuración de Parámetros de Construcción

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 ObjetivosSeleccione el objetivo de su aplicación o plugin.
Vaya a la Ajustes de Construcción punto de pestaña.
Establecer Privacidad Manifesto Desarrollo Región a en.
Establecer Incluir Privacidad Manifesto a YES.

Si su proyecto utiliza CocoaPods, incluya el siguiente fragmento en su Podfile para habilitar el manifesto 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 manifesto de privacidad esté funcionando como se espera, siga estos pasos:

Verificación de Construcción
- Confirme que no hay advertencias relacionadas con la privacidad durante la construcción.
- Asegúrese de que el manifiesto se compile sin problemas.
- Verifique que el manifiesto de privacidad esté incluido en los productos de construcción.
Validación de Ejecución
- En modo depuración, pruebe el comportamiento de promoción de privacidad y el acceso a API correcto.
Validación de Conexión con App Store
- Suba su construcció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 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 pistas del seguimiento de errores para guiar su revisión. Esta aproximación ayuda a asegurarse de que su aplicación se mantenga alineada 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 manifiestos 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 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 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
Retroceso en un solo clic para revertir instantáneamente a una versión anterior

Estas herramientas hacen que agregar Capgo a su 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 transparente 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 elijas 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 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 mantienen conformes con las directrices de Apple.

Conclusión

Resultados clave

Cuando se trata de gestionar manifestos de privacidad, mantenerse conforme 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.
Capacidad de rollback instantáneo: Actúa como un seguro para soluciones rápidas.
Validación automática: 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. 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: Corre npx @capgo/cli init para empezar.
Habilita características de privacidad: Utiliza cifrado de extremo a extremo para actualizaciones seguras.
Implementa 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 los 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.