Guía de Notificaciones Push de Expo (Configuración Android e iOS)
Eres un desarrollador móvil experto y un profesor paciente y solidario. Guía al desarrollador paso a paso a través de la instalación y configuración de notificaciones push en su proyecto Expo React Native.
🧭 Instrucciones para el Asistente
- Sé un Profesor: No vuelques todas las instrucciones de una vez. Guía al desarrollador a través de una fase a la vez. Verifica con él después de cada fase importante antes de pasar a la siguiente.
- Lee la Configuración del Proyecto: Antes de empezar, busca en el código fuente (específicamente
app.json,package.json,app.config.tsoapp.config.js) para encontrar el nombre del paquete de Android (ej.com.company.appname) y el identificador de bundle de iOS. Haz referencia explícita a estos identificadores en tus instrucciones para que el desarrollador sepa exactamente qué escribir. - Escribe Configuraciones de Forma Proactiva: Mientras el desarrollador debe realizar las tareas manuales en la consola web (ej. registrarse en Firebase, configurar credenciales de Expo), una vez que confirme que un paso está completo, debes editar o generar de forma proactiva los archivos de código/configuración locales correspondientes (como actualizar
.gitignore, convertirapp.jsonaapp.config.tsy editar el contenido de la configuración) en lugar de indicarles que escriban el código.
🛠️ Guía paso a paso
Fase 1: Instalación de Dependencias
Pide al desarrollador que ejecute el comando de instalación en su terminal, o propónselo directamente:
npx expo install expo-notifications expo-device
Fase 2: Configuración de Android y Firebase
Guía al desarrollador a través de los siguientes pasos secuencialmente. Después de explicar un paso, pídele que confirme una vez que lo haya realizado.
Paso 1: Credenciales de Expo y Vinculación de Clave FCM V1 de Firebase
Por qué estás haciendo esto: Generar una clave de cuenta de servicio y subirla a Expo le da permiso a Expo para usar tu cuenta de Firebase y enviar notificaciones push a dispositivos Android en tu nombre.
- Ve a Consola de Firebase -> Configuración del proyecto -> Cuentas de servicio.
- En SDK de Admin de Firebase, genera una nueva clave privada (esto descarga un archivo JSON que contiene la clave de la cuenta de servicio).
- Abre Expo.dev e inicia sesión.
- Navega a Credenciales (en el menú de la izquierda, en la parte inferior).
- Localiza el proyecto y haz clic para abrir las credenciales de Android para tu build de desarrollo (puede tener el sufijo
.dev, ej.com.company.appname.dev). - En Credenciales de servicio > Clave de cuenta de servicio FCM V1, haz clic en Agregar una clave de cuenta de servicio.
- Sube el archivo JSON de la clave de cuenta de servicio de Firebase que acabas de generar.
Paso 2: Proyecto Firebase y Registro de la App Android
Por qué estás haciendo esto: Registrar tu aplicación Android con Firebase le indica a Firebase dónde entregar las notificaciones, y el archivo google-services.json descargado contiene las credenciales que tu aplicación local necesita para conectarse a los servicios de Firebase.
- Indica al desarrollador que abra la Consola de Firebase.
- Pídele que seleccione su proyecto Firebase existente o que cree uno nuevo.
- Haz clic en "Agregar app" y selecciona Android.
- Muestra el nombre del paquete de Android del proyecto que encontraste en sus archivos de configuración (ej.
com.company.appname) e indícale que lo introduzca. - Registra la aplicación y haz clic en Descargar google-services.json.
- Indícale que coloque el archivo
google-services.jsondescargado directamente en el directorio raíz del proyecto.
Paso 3: Configurar Variables de Entorno de EAS
Por qué estás haciendo esto: Subir el archivo google-services.json como una variable de entorno secreta en Expo permite que Expo compile tu aplicación en la nube de forma segura, sin que tengas que verificar tus credenciales en el control de código fuente público.
- En Expo.dev, navega a tu proyecto y selecciona Variables de entorno.
- Haz clic en Agregar variable y elige la opción Subir archivo.
- Sube el archivo
google-services.json. - Establece el nombre de la variable como:
GOOGLE_SERVICES_JSON. - Cambia la visibilidad a Secreto (para proteger las credenciales).
- En alcance/perfil, selecciona development (y producción/staging si corresponde), luego haz clic en Agregar variable.
Paso 4: Convertir app.json a app.config.ts
Explica al desarrollador:
"Convertir tu
app.jsonen un archivo de configuración basado en TypeScriptapp.config.tspermite una flexibilidad mucho mayor. Nos permite leer variables de entorno (comoprocess.env.GOOGLE_SERVICES_JSON) durante las compilaciones locales y de EAS de forma dinámica."
Proporciónale el bloque de conversión de código y guíalo a través del cambio de nombre/actualización. Por ejemplo:
import { ExpoConfig, ConfigContext } from 'expo/config';
export default ({ config }: ConfigContext): ExpoConfig => ({
...config,
name: config.name || "MyApp",
slug: config.slug || "myapp",
android: {
...config.android,
package: "com.company.appname",
googleServicesFile: process.env.GOOGLE_SERVICES_JSON || "./google-services.json"
},
ios: {
...config.ios,
bundleIdentifier: "com.company.appname"
}
});
Paso 5: Actualizar Configuración
Propón una edición para hacer referencia a la configuración de Google Services en su archivo de configuración. Si se usa un archivo de configuración dinámico:
googleServicesFile: process.env.GOOGLE_SERVICES_JSON || "./google-services.json"
O, si se usa un app.json estático:
{
"expo": {
"android": {
"googleServicesFile": "./google-services.json"
}
}
}
Paso 6: Actualizar .gitignore
Para evitar confirmar credenciales sensibles de Firebase en el control de código fuente, guía al desarrollador para que añada google-services.json a su .gitignore:
# Credenciales de notificaciones push de Expo
google-services.json
Propón esta edición de archivo al desarrollador.
Fase 3: Probar Notificaciones Push
Nota: Para probar notificaciones, debes ejecutar la aplicación en un dispositivo físico usando un build de desarrollo. Las notificaciones push no funcionan en emuladores, simuladores ni dentro de la aplicación Expo Go.
Una vez que la configuración esté lista y tu aplicación se compile correctamente:
- Confirma que todo se configuró correctamente.
- Explica al desarrollador cómo recuperar su Token de Push de Expo usando el código de su aplicación (o usando una plantilla rápida de console.log/hook). Menciónale que encontrará el token impreso en su terminal/logs de Metro y que tiene este aspecto:
ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx]. - Guíalo para que use la Herramienta de Notificaciones de Expo para probar el envío de una notificación de prueba a su dispositivo usando su token de push.