Guía de configuración de Apple Push Notification Service (APNs)
Configure los certificados y perfiles de aprovisionamiento de Apple Push Notification Service para habilitar la entrega de notificaciones push y el seguimiento de desinstalación para aplicaciones iOS mediante Singular SDK.
Descripción general
Requisitos previos
Habilite las notificaciones push de APNs creando certificados SSL y perfiles de aprovisionamiento en el Centro de miembros desarrolladores de Apple.
Componentes necesarios:
- Certificado SSL: Asociado con App ID configurado para notificaciones push
- Perfil de aprovisionamiento: Autoriza a los dispositivos a ejecutar la app durante el desarrollo y las pruebas
- Cuenta de desarrollador de Apple: Es necesario ser miembro activo para crear el certificado
- Ordenador Mac: Necesario para el acceso al llavero y la generación de certificados
Portal para desarrolladores de Apple: Toda la gestión de certificados y perfiles se realiza en el Centro de miembros desarrolladores de Apple. Asegúrese de que dispone de los permisos adecuados en el equipo de desarrolladores de su organización.
Tipos de certificados
Apple proporciona dos tipos de certificados SSL APNs para diferentes entornos.
| Tipo de certificado | Entorno | Caso de uso |
|---|---|---|
| Certificado SSL de desarrollo | Sandbox | Pruebas internas y compilaciones de desarrollo |
| Certificado SSL de producción | Producción | Versiones de App Store y TestFlight |
Coincidencia de entorno crítica: Las aplicaciones deben utilizar certificados que coincidan con su entorno de compilación. Las aplicaciones de producción con certificados de desarrollo no recibirán notificaciones push.
Paso 1: Generar una solicitud de firma de certificado
Cree un archivo de solicitud de firma de certificado (CSR) en su Mac para autenticar la creación del certificado SSL.
Crear archivo CSR
Usando Acceso a Llaveros
Genere la CSR a través de la aplicación Keychain Access en macOS.
- Abra Acceso a llaveros: Navegue hasta Aplicaciones → Utilidades → Acceso a Llaveros, o utilice la búsqueda de Spotlight (Cmd+Espacio).
- Acceda al Asistente para certificados: En la barra de menús, seleccione Acceso a llaveros → Asistente para certificados → Solicitar un certificado a una autoridad de certificación....
-
Introduzca la información del usuario:
- Dirección de correo electrónico del usuario: Introduzca su dirección de correo electrónico (utilizada en la cuenta de desarrollador de Apple)
- Nombre común: Introduzca un nombre descriptivo (por ejemplo, "Certificado APNs de su empresa")
- Dirección de correo electrónico de CA: Dejar en blanco
- Seleccione el tipo de solicitud: Elija la opción "Guardado en disco" (necesaria para la creación manual de certificados)
- Guardar archivo CSR: Haga clic en Continuar y guarde el archivo .certSigningRequest en una ubicación memorable de su Mac
Almacenamiento de claves privadas: Keychain Access genera y almacena automáticamente una clave privada al crear la CSR. Esta clave privada se emparejará con el certificado SSL que descargará de Apple más adelante.
Paso 2: Crear o configurar el App ID
Cree un nuevo App ID o configure un App ID existente para habilitar la función de Notificación Push.
Descripción de los ID de aplicaciones
Estructura del App ID
Un App ID identifica de forma única su aplicación iOS y debe ser un identificador explícito (no comodín) para soportar Notificaciones Push.
Formato: Notación de dominio inversa (por ejemplo, com.yourcompany.appname)
Se requiere un identificador de aplicación explícito: Los identificadores de aplicación con comodines (que contengan *) no pueden utilizar las notificaciones push. Si ya dispone de un ID de aplicación comodín, cree un nuevo ID de aplicación explícito para las aplicaciones compatibles con notificaciones push.
Crear nuevo ID de aplicación
Pasos de configuración del App ID
Cree un nuevo ID de aplicación en el portal para desarrolladores de Apple con las notificaciones push activadas.
- Acceda al portal para desarrolladores: Navegue hasta el Centro de miembros desarrolladores de Applee inicie sesión.
- Abra Certificados e identificadores: Seleccione "Certificados, identificadores y perfiles".
- Navegue hasta "Identificadores": En la barra lateral izquierda, seleccione "Identificadores"
- Seleccione Plataforma: En el menú desplegable superior izquierdo, seleccione "Aplicaciones iOS" (o "iOS, tvOS, watchOS" en la interfaz más reciente)
- Crear identificador: Haga clic en el botón "+" para crear un nuevo App ID
Configurar los detalles del identificador de la aplicación
Rellene la información del identificador de la aplicación y active la función de notificaciones push.
- Seleccione el tipo: Seleccione "App IDs" (no App Clips)
- Seleccione el tipo de paquete: Elija "App" como tipo
- Introduzca la descripción: Introduzca un nombre significativo (por ejemplo, "YourApp Production")
- Establecer ID de paquete: En la sección Prefijo de ID de aplicación, utilice el ID de equipo predeterminado.
-
Introducir ID de paquete explícito: En el campo ID de paquete, introduzca el identificador de su aplicación exactamente como aparece en Xcode (por ejemplo,
com.yourcompany.appname)
Coincidencia del ID del paquete: el valor del ID del paquete debe coincidir exactamente con el identificador del archivo Info.plist de tu aplicación y con la configuración del proyecto de Xcode. La distinción entre mayúsculas y minúsculas es importante.
Activar notificaciones push
Active la función de notificaciones push en la sección App Services.
- Desplácese a Capacidades: Localice la sección "App Services
- Active las notificaciones push: Marque la casilla "Notificaciones Push".
- Revise la configuración: Haga clic en Continuar y verifique la configuración
- Confirme el ID de la aplicación: Compruebe que el identificador muestra correctamente su ID de paquete.
- Compruebe el estado: Confirme que las notificaciones push aparecen como "Configurable".
- Registre el ID de la aplicación: Haga clic en Enviar para crear el App ID
Paso 3: Configurar el certificado de notificaciones push
Genere certificados SSL para Notificaciones Push para permitir la comunicación de APNs con su aplicación.
Acceder a la configuración del App ID
Editar configuración de App ID
Abra la configuración del App ID para crear certificados SSL para entornos de desarrollo y producción.
- Navegue hasta Identificadores: En el portal para desarrolladores de Apple, vaya a Certificados, identificadores y perfiles → Identificadores.
- Seleccione App ID: Haga clic en el App ID que haya creado o que desee configurar
- Editar configuración: Haz clic en el botón "Editar" (o el App ID se abre directamente en modo edición)
- Localice Notificaciones Push: Desplácese hasta la sección "Notificaciones Push" en la lista de capacidades
Crear certificado SSL de desarrollo
Generar certificado de desarrollo
Cree un certificado de desarrollo para probar las notificaciones push durante el desarrollo.
- Inicie la creación del certificado: En la sección Notificaciones push, haga clic en "Crear certificado..." en Certificado SSL de desarrollo
- Revise las instrucciones: Lea la información "Acerca de la creación de una solicitud de firma de certificado (CSR)".
- Continúe: Haga clic en el botón Continuar
- Cargar CSR: Haga clic en "Seleccionar archivo..." y seleccione el archivo .certSigningRequest que creó en el paso 1.
- Generar: Haga clic en Continuar (o Generar) para crear el certificado.
Descargar e instalar el certificado
Descargue el certificado SSL e instálelo en el llavero de su Mac para utilizarlo con las notificaciones push.
- Descargar certificado: Haga clic en el botón "Descargar" para guardar el archivo .cer en su Mac
- Completar el proceso: Haga clic en "Hecho" para cerrar el flujo de creación del certificado
- Instale el certificado: Localice el archivo .cer descargado y haga doble clic para añadirlo al llavero.
- Verifique la instalación: Abra Acceso a Llaveros y vaya a la categoría "Mis certificados".
- Localice el certificado: Busque el certificado "Apple Development iOS Push Services: your.bundle.id" con la clave privada asociada.
Emparejamiento de certificados: El certificado descargado se empareja automáticamente con la clave privada generada durante la creación de la CSR. Ambos deben estar presentes en el Llavero para que funcionen las notificaciones push.
Exportar certificado como .p12
Generar archivo P12
Exporte el certificado y la clave privada como archivo .p12 para cargarlos en servicios de notificaciones push (como Singular).
- Abra el Acceso a Llaveros: Vaya a la categoría "Mis certificados".
- Expanda el certificado: Haga clic en el triángulo que aparece junto al certificado "Apple Development iOS Push Services" para mostrar la clave privada.
- Seleccione ambos elementos: Mantenga pulsada la tecla Comando y haga clic para seleccionar tanto el certificado como la clave privada.
- Exportar: Haga clic con el botón derecho en la selección y elija "Exportar 2 elementos..."
- Nombre del archivo: Guárdelo con un nombre descriptivo (por ejemplo, "YourApp_Development_APNs.p12")
- Elija el formato: Asegúrese de que "Personal Information Exchange (.p12)" está seleccionado como formato de archivo.
- Establecer contraseña: Introduzca una contraseña segura para proteger el archivo .p12
- Confirme la exportación: Haga clic en Aceptar e introduzca la contraseña de inicio de sesión de Mac si se le solicita
Advertencia de seguridad: El archivo .p12 contiene su clave privada y su certificado. Guárdelo de forma segura y nunca lo publique en repositorios públicos. Recuerde la contraseña: no se puede recuperar.
Creación del certificado SSL de producción
Generación de certificados de producción
Repita el proceso de creación de certificados para el certificado SSL de producción necesario para las versiones de App Store.
- Vuelva a la configuración de App ID: Vuelva a la configuración de su App ID en el portal de desarrolladores de Apple
- Certificado de producción: En la sección de notificaciones push, haga clic en "Crear certificado..." en Certificado SSL de producción.
- Siga el mismo proceso: Cargue la CSR, genere el certificado, descárguelo e instálelo en el llavero.
- Exportar P12 de producción : Exporte como .p12 con un nombre descriptivo (por ejemplo, "YourApp_Production_APNs.p12")
- Almacenamiento seguro: Almacene el certificado de producción de forma segura, separado del certificado de desarrollo
Certificado de producción necesario: Las aplicaciones enviadas a App Store y distribuidas a través de TestFlight DEBEN utilizar certificados SSL de producción. Los certificados de desarrollo fallarán en un entorno de producción.
Paso 4: Crear perfil de aprovisionamiento
Genere perfiles de aprovisionamiento para autorizar a los dispositivos a ejecutar su aplicación durante las fases de desarrollo y prueba.
Descripción de los perfiles de aprovisionamiento
Tipos de perfiles
Los perfiles de aprovisionamiento vinculan su App ID, certificados y dispositivos registrados para permitir la instalación y prueba de la aplicación.
| Tipo de perfil | Propósito | Límite de dispositivos |
|---|---|---|
| Desarrollo de aplicaciones iOS | Pruebas internas en dispositivos registrados | Hasta 100 dispositivos por perfil |
| Ad Hoc | Distribución a probadores externos al equipo de desarrollo | Hasta 100 dispositivos por perfil |
| App Store | Distribución en App Store y TestFlight | Ilimitado (todos los dispositivos) |
Crear perfil de desarrollo
Configuración del perfil de desarrollo
Crear perfil de aprovisionamiento de desarrollo de iOS App para pruebas de notificaciones push.
- Acceda a Perfiles de aprovisionamiento: En el portal para desarrolladores de Apple, navegue hasta Certificados, identificadores y perfiles → Perfiles.
- Crear nuevo perfil: Haga clic en el botón "+" para iniciar la creación del perfil
- Seleccione Tipo: Elija "Desarrollo de aplicaciones iOS" en la sección Desarrollo
- Continuar: Haga clic en el botón Continuar
- Seleccione App ID: En el menú desplegable, elija el App ID configurado para las notificaciones push
- Continuar: Haga clic en el botón Continuar
Configure los detalles del perfil
Seleccione certificados, dispositivos y nombre del perfil de aprovisionamiento.
- Seleccione Certificado: Marque el certificado de desarrollo iOS asociado a su App ID.
- Continuar: Haga clic en el botón Continuar
- Seleccione Dispositivos: Marque todos los dispositivos en los que desea probar las notificaciones push (deben estar registrados previamente en la sección Dispositivos)
- Continuar: Haga clic en el botón Continuar
- Nombre del perfil: Introduzca un nombre descriptivo (por ejemplo, "YourApp Development Push Testing")
- Generar perfil: Haga clic en el botón Generar
Registro de dispositivos: Los dispositivos de prueba deben registrarse en el portal para desarrolladores de Apple antes de poder añadirlos a los perfiles de aprovisionamiento. Registre los dispositivos por UDID en la sección Dispositivos.
Instalar el perfil de aprovisionamiento
Descargue e instale el perfil de aprovisionamiento para utilizarlo en Xcode.
- Descargar perfil: Haga clic en el botón Descargar para guardar el archivo .mobileprovision
- Instalar perfil: Haga doble clic en el archivo .mobileprovision descargado para añadirlo a Xcode
- Verifique la instalación: Abra Xcode → Preferencias → Cuentas → Ver detalles para confirmar que aparece el perfil
- Seleccionar en proyecto: En la configuración del proyecto de Xcode, seleccione el perfil de aprovisionamiento en Firma y capacidades
Caducidad del perfil: Los perfiles de aprovisionamiento caducan al cabo de un año. Renueve los perfiles caducados en el portal para desarrolladores de Apple y descargue nuevos archivos .mobileprovision.
Verificación y pruebas
Compruebe que la configuración de los APN es correcta probando la entrega de notificaciones push a los dispositivos de desarrollo.
Lista de comprobación de la configuración
Verificación previa a las pruebas
Confirme que todos los componentes están correctamente configurados antes de probar las notificaciones push.
- ID de aplicación: ID de aplicación explícito con la función de notificaciones push activada.
- Certificados SSL: Certificados de desarrollo y producción creados y exportados como .p12
- Perfil de aprovisionamiento: Perfil de desarrollo instalado en Xcode con el ID de aplicación y los dispositivos correctos
- Coincidencia de ID de paquete: El ID de paquete del proyecto de Xcode coincide exactamente con el identificador de ID de aplicación.
- Capacidades: Capacidad de notificaciones push activada en Xcode Firma y capacidades
- Llavero: Certificados con claves privadas presentes en "Mis certificados" del Llavero de Mac
Prueba de las notificaciones push
Procedimiento de prueba
Envíe una notificación push de prueba para verificar la configuración de los APN.
- Crear e instalar: Cree la aplicación con el perfil de aprovisionamiento de desarrollo e instálela en el dispositivo de prueba.
- Solicitar permisos: Inicie la aplicación y conceda permisos de notificación push cuando se le solicite.
- Registrar token de dispositivo: Verificar que la aplicación recibe el token de dispositivo de APN en los registros de la consola
- Enviar notificación de prueba: Utilizar la herramienta de prueba de APNs o el servicio push para enviar una notificación de prueba
- Verificar entrega: Confirme que la notificación aparece en el dispositivo
Problemas comunes
| Problema | Causa | Solución |
|---|---|---|
| No se ha recibido ningún token de dispositivo | Las notificaciones push no están habilitadas en las capacidades | Habilite las notificaciones push en la pestaña Firma y capacidades de Xcode |
| Error de certificado no encontrado | Falta la clave privada en el llavero | Vuelva a exportar el certificado, incluida la clave privada, desde el Mac original que creó la CSR. |
| Notificaciones push no entregadas | Entorno incorrecto (dev vs prod) | Compruebe que el tipo de certificado coincide con la configuración de compilación |
| Perfil de aprovisionamiento no válido | Perfil caducado o dispositivos no registrados | Renueve el perfil de aprovisionamiento y asegúrese de que los dispositivos están registrados |
| El ID del paquete no coincide | El ID del paquete de Xcode no coincide con el ID de la aplicación | Actualice el ID del paquete en Xcode para que coincida exactamente con el identificador del ID de la aplicación. |
Herramientas de prueba: Utilice la consola de notificaciones push de Apple en Xcode o herramientas de terceros como Pusher, Knuff o comandos curl para enviar notificaciones de prueba durante el desarrollo.
Pasos siguientes
Con los APN configurados, integre la gestión de notificaciones push en su aplicación y configure Singular para el seguimiento de la desinstalación.
Guías de integración
Complete su configuración
- Implementación de iOS Push: Implementa el registro de APNs y la gestión de notificaciones en el código de tu aplicación iOS.
- Integración de Singular SDK: Siga la guía de implementaciónde Singular SDK de iOSpara habilitar el seguimiento de desinstalación
- Subir certificado a Singular: Sube tu certificado .p12 a la configuración de la aplicación de Singular para el seguimiento de desinstalación
- Pruebe el seguimiento de desinstalación: Verifique que la detección de desinstalaciones funciona correctamente antes de lanzar la aplicación a producción.
Despliegue de producción
Requisitos de envío a App Store:
- Certificado de producción: Utilice el certificado SSL de producción para las compilaciones de App Store
- Perfil de App Store: Crear y utilizar el perfil de aprovisionamiento de distribución de App Store
- Firma de código: Asegúrese de seleccionar el certificado y el perfil correctos en la configuración de Xcode Archive
- TestFlight: Las compilaciones de TestFlight utilizan el entorno de producción con el certificado de producción.