Configuración y obtención de credenciales en Firebase

Para utilizar los métodos de cloudPersistence en aplicaciones dedicadas, se necesita crear y configurar una base de datos en firebase. En caso de no completar esta configuración, la aplicación no podrá utilizar ningún método de cloudPersistence y se lanzará una excepción al ejecutarlos.

Cuando la configuración ingresada en mat|r es inválida, la aplicación fallará en la carga con una excepción y no se podrá ejecutar.

 

Pasos para la configuración de Firebase:

Paso 1 – Creación de cuenta en google:

Lo primero es crear una cuenta en google, https://accounts.google.com/SignUp. En caso de poseer una y se dispone de utilizarla para firebase, continuar con el siguiente paso.

Paso 2 – Inicio de sesión en Firebase:

Realizar el inicio de sesión en https://firebase.google.com/?hl=es. Esto se realiza presionando en ‘SIGN IN’ y luego, completando con el usuario y contraseña de google.

Paso 3 – Creación de proyecto:

Una vez completado el inicio de sesión, ingresar al listado de proyectos haciendo click en ‘IR A LA CONSOLA’, se encuentra en la parte superior derecha. Esto dirige a https://console.firebase.google.com/. Aquí se debe crear un proyecto para nuestra aplicación. Observar que no se tiene ningún proyecto, por tal motivo presionar en ‘Añadir proyecto’. En caso de tener una proyecto creado con anterioridad y se desea utilizar el mismo, ir al paso 4.

Se abrirá una ventana en la que tendremos que ingresar la información de nuestra aplicación. Tenemos que ingresar un nombre a la base de datos. Luego, seleccionar el país/región correspondiente. Por último, marcar el casillero de las condiciones de uso de firebase. La creación finaliza al presionar en ‘CREAR PROYECTO’.

Luego de que termine la creación, presionar ‘CONTINUAR’ y se direccionará a la ‘visión general’ del proyecto.

Paso 4 – Añadir aplicaciones a nuestro proyecto:

Ahora, se deben obtener las credenciales para nuestra aplicación dedicada. Para ello, se debe añadir la aplicación para Android e iOS.

  • 4.1: Android:

Empezar con Android presionando ‘Añade Firebase a tu aplicación de Android‘. Se abrirá una ventana, en ella hay que ingresar el “Nombre del paquete de Android”. Tiene que ser el mismo que se ingresa en la plataforma en el campo ‘Package Name’. Luego, presionar en “REGISTRAR LA APLICACIÓN”.

Descargar el archivo “google-services.json” que provee Firebase al presionar en “Descargar google-services.json”. Este archivo contiene la información necesaria para la configuración, las cuales son: “firebase_url”, “api_key” y “mobilesdk_app_id”.

Ejemplo de google-service.json

Volver a firebase y cerrar la ventana de creación para android presionando en la cruz que se encuentra del lado izquierdo del título.

 

  • 4.2: iOS

Ir a la creación de la aplicación para iOS, para esto presionar en “AÑADIR OTRA APLICACIÓN”. Luego, presionar en “Añade Firebase a tu aplicación de iOS”. Se abrirá la configuración para su creación, completar el campo “ID del conjunto de iOS” con el mismo nombre que se ingresó en el campo ‘Nombre del paquete de Android’ de la configuración de Android.

Presionar en “REGISTRAR LA APLICACIÓN” y descargar el archivo GoogleService-info.plist. De este, se debe obtener “API_KEY”, “GCM_SENDER_ID”, “DATABASE_URL” y “GOOGLE_APP_ID”.

Ejemplo de GoogleService-info.plist

Cerrar la configuración desde la cruz que se encuentra del lado izquierdo del título.

Paso 5 – Iniciar la base de datos:

Finalmente, ingresar a la base de datos para inicializarla y cambiar las reglas de seguridad. Esto es necesario para el acceso a la escritura y lectura de la misma.

Para esto, ingresar en ‘Database’ (que se encuentra en el panel izquierdo). La base de datos que se utilizara es ‘Realtime Database’. En esta, presionar en ‘EMPEZAR’ y se abrirá la configuración de las reglas de seguridad. En esta ventana seleccionar ‘modo de prueba’. Presionar en ‘HABILITAR’ y se habilita la base de datos para poder utilizarla con su aplicación.

Nota: En caso de que este paso no se realice, la aplicación fallará en la carga inicial por no tener acceso.

Paso 6 – Configuración en mat|r:

Ya obtenidas las credenciales, proceder a configurar la aplicación dedicada en la plataforma de mat|r. Desde el portal de mat|r ingresar a la aplicación que se desea configurar, dirigirse a la pestaña de “Build App” e ingresar las credenciales obtenidas de la siguiente manera:

Firebase Mat|r
current_key Firebase API Key (Android)
mobilesdk_app_id Firebase APP ID (Android)
API_KEY Firebase API Key (iOS)
GOOGLE_APP_ID Firebase APP ID (iOS)
GCM_SENDER_ID Firebase GCM Sender ID (iOS)
firebase_url / DATABASE_URL Firebase Database URL (All Platforms)

Nota: los valores de “firebase_url” y “DATABASE_URL” son los mismos.

Luego de ingresar las credenciales, ya se puede descargar la aplicación dedicada. La misma estará conectada a la base de datos en firebase que se configuró en estos pasos.

Ejemplo de configuración válida, respecto a la obtenida en firebase.