Agrega Firebase a tu proyecto de C++plat_iosplat_androidplat_cpp

Usa nuestros SDK de Firebase C++ que ofrecen una interfaz de este lenguaje en Firebase para iOS y Android, y potencia tus juegos de C++.

Accede a Firebase de forma íntegra por medio de tu código de C++ sin la necesidad de escribir código nativo de la plataforma. Además, el SDK de Firebase toma varias expresiones específicas del lenguaje de Firebase y las traduce a una interfaz más familiar para los desarrolladores de C++.

Obtén más información acerca de cómo mejorar tus juegos con Firebase en nuestra página de juegos de Firebase.

Paso 1: Configura tu entorno

• Instala Xcode 9.4.1 o una versión más reciente.

• Instala CocoaPods 1.4.0 o una versión más reciente.

• Abre tu proyecto de C++ en Xcode.

  • Tu app debe orientarse a iOS 8 o una versión más reciente.

• Configura un dispositivo o emulador para ejecutar la app.

  • Para Cloud Messaging, necesitarás los siguientes elementos:
    • Un dispositivo iOS físico
    • Un certificado APNS con notificaciones push habilitadas

• Accede a Firebase con tu Cuenta de Google.

Paso 2: Crea un proyecto de Firebase

Antes de que puedas agregar Firebase a tu proyecto de C++, tendrás que crear un proyecto de Firebase para conectarlo con el de C++. Consulta la Información sobre los proyectos de Firebase para obtener más detalles sobre el tema.

Paso 3: Registra tu app con Firebase

Puedes registrar una o más apps para conectarlas con tu proyecto de Firebase.

Consulta la Información sobre los proyectos de Firebase a fin de obtener detalles sobre las recomendaciones y consideraciones para agregar apps a un proyecto de Firebase, incluido cómo manejar diversas variantes de compilación.

1. En el centro de la página de descripción general del proyecto en Firebase console, haz clic en el ícono de iOS para iniciar el flujo de trabajo de configuración.

   Si ya agregaste una app a tu proyecto de Firebase, haz clic en Agregar app para que se muestren las opciones de la plataforma.

2. Ingresa el ID del paquete de tu app en el campo ID del paquete de iOS.

   • Podrás encontrar el ID del paquete en el proyecto abierto en Xcode. Selecciona la app de nivel superior en el navegador del proyecto a la izquierda y, luego, accede a la pestaña General. El valor del campo Bundle Identifier (Identificador de paquete) es el ID del paquete de iOS (por ejemplo, com.yourcompany.ios-app-name).

3. (Opcional) Ingresa otra información de la app si el flujo de trabajo de configuración lo solicita.

   El sobrenombre es un identificador interno y conveniente, y solo tú puedes verlo en Firebase console.

4. Haz clic en Registrar app.

Paso 4: Agrega el archivo de configuración de Firebase

1. Haz clic en Descargar GoogleService-Info.plist a fin de obtener el archivo de configuración de Firebase para iOS.

   • Puedes volver a descargar el archivo de configuración de Firebase para iOS cuando quieras.

   • Asegúrate de que no se hayan agregado caracteres adicionales, como (2), al nombre del archivo de configuración.

2. Abre tu proyecto de C++ en un IDE y arrastra el archivo de configuración al directorio raíz de tu proyecto de C++.

3. Si se te solicita, selecciona la opción para agregar el archivo de configuración a todos los destinos.

4. Completaste las tareas de configuración en Firebase console. Sigue con el paso Agrega los SDK de Firebase C++ que se muestra a continuación.

Paso 5: Agrega los SDK de Firebase C++

Los pasos que se indican en esta sección sirven de ejemplo para agregar cualquier producto de Firebase compatible a un proyecto de Firebase C++. En este, se explica cómo agregar Google Analytics para Firebase.

Aunque agregar Google Analytics para Firebase a tu proyecto de C++ es opcional, es una manera relativamente sencilla de verificar que Firebase funciona adecuadamente con tu app. Analytics también puede ser muy útil durante el desarrollo y la depuración, además de ayudarte a realizar un seguimiento del desempeño adecuado de tus apps de producción.

1. Descarga el SDK de Firebase C++ y descomprímelo en la ubicación que prefieras.

   El SDK de Firebase C++ no es específico de una plataforma, pero sí contiene bibliotecas específicas de estas.

2. Agrega los pods de Firebase desde el SDK descomprimido.

   1. Crea un Podfile si aún no tienes uno:

      cd your-app-directory

      pod init

   2. Por cada producto de Firebase que quieras usar, agrega los pods correspondientes a tu Podfile. Para Analytics, ejecuta el siguiente código:

      pod 'Firebase/Analytics', '5.12.0'

   3. Instala los pods y abre el archivo .xcworkspace en Xcode.

      pod install

      open your-app.xcworkspace

3. Agrega los marcos de trabajo de Firebase desde el SDK descomprimido.

   Por lo general, la manera más fácil de agregar estos marcos de trabajo es arrastrarlos directamente desde una ventana de Finder hasta el panel Project Navigator (Navegador del proyecto) de Xcode (según la configuración predeterminada, este es el panel en el extremo izquierdo, o puedes hacer clic en el ícono de archivo que aparece en la parte superior izquierda de Xcode).

   1. Agrega el marco de trabajo principal de Firebase (firebase.framework), que es obligatorio para poder usar los productos de Firebase.

   2. Agrega el marco de trabajo de cada producto de Firebase que quieras usar. Para Analytics, agrega firebase_analytics.framework.

4. Vuelve a Firebase console y, en el flujo de trabajo de configuración, haz clic en Siguiente.

5. Ejecuta tu app para enviar la verificación a Firebase de que lo ingresaste correctamente.

   En los registros de tu dispositivo, se mostrará la verificación de Firebase que indica que se completó la inicialización. Si ejecutaste tu app en un emulador que tiene acceso a redes, Firebase console notificará que se completó la conexión a tu app.

   Listo. Tu app de C++ está registrada y configurada para usar productos de Firebase.

Bibliotecas disponibles

Consulta la documentación de referencia y la actualización del SDK de código abierto en GitHub para obtener más información sobre las bibliotecas de Firebase C++.

Bibliotecas disponibles para iOS

Recuerda que en la versión de Android de esta página de configuración se enumeran las bibliotecas de C++ para Android.

Cada producto de Firebase tiene dependencias diferentes. Procura agregar todas las dependencias enumeradas para el producto de Firebase que desees a tu Podfile y tu proyecto de C++.

firebase.framework
  pod 'Firebase/Analytics', '6.1.0'

firebase.framework
  firebase_admob.framework
  pod 'Firebase/Analytics', '6.1.0'
  pod 'Firebase/AdMob', '6.1.0'

firebase.framework
  firebase_analytics.framework
  pod 'Firebase/Analytics', '6.1.0'

firebase.framework
  firebase_auth.framework
  pod 'Firebase/Analytics', '6.1.0'
  pod 'Firebase/Auth', '6.1.0'

firebase.framework
  firebase_functions.framework
  pod 'Firebase/Analytics', '6.1.0'
  pod 'Firebase/Functions', '6.1.0'

firebase.framework
  firebase_messaging.framework
  pod 'Firebase/Analytics', '6.1.0'
  pod 'Firebase/Messaging', '6.1.0'

firebase.framework
  firebase_storage.framework
  pod 'Firebase/Analytics', '6.1.0'
  pod 'Firebase/Storage', '6.1.0'

firebase.framework
  firebase_dynamic_links.framework
  pod 'Firebase/Analytics', '6.1.0'
  pod 'Firebase/DynamicLinks', '6.1.0'

firebase.framework
  firebase_database.framework
  pod 'Firebase/Analytics', '6.1.0'
  pod 'Firebase/Database', '6.1.0'

firebase.framework
  firebase_remote_config.framework
  pod 'Firebase/Analytics', '6.1.0'
  pod 'Firebase/RemoteConfig', '6.1.0'
  

Información adicional sobre la configuración para dispositivos móviles

Referencia de métodos

En iOS, algunos eventos de aplicación (como abrir URL y recibir notificaciones) requieren que el delegado de la aplicación implemente ciertos métodos específicos. Por ejemplo, recibir una notificación puede requerir que el delegado de la aplicación implemente application:didReceiveRemoteNotification:. Debido a que cada aplicación de iOS tiene su propio delegado, Firebase utiliza la referencia de métodos, que permite reemplazar un método con otro a fin de agregar sus propios controladores, además de los que ya hayas implementado.

Las bibliotecas de Firebase Invites, Dynamic Links y Cloud Messaging deben adjuntar controladores al delegado de la aplicación mediante la referencia de métodos. Si utilizas alguno de estos productos de Firebase, cuando se carguen, Firebase identificará la clase AppDelegate, agregará los métodos requeridos a ella y generará una devolución de llamada a la implementación del método existente.

Configura un flujo de trabajo para computadoras de escritorio (Beta)

Cuando creas un juego, suele ser más fácil probarlo en plataformas de computadoras de escritorio antes de implementarlo y probarlo en dispositivos móviles en una etapa posterior del desarrollo. Para admitir este flujo de trabajo, proporcionamos un subconjunto de los SDK de Firebase C++ que se puede ejecutar en Windows, macOS, Linux y desde dentro del editor de C++.

1. Debes completar los siguientes pasos para los flujos de trabajo en computadoras de escritorio:

   • Configura tu proyecto de C++ para CMake.
   • Crea un proyecto de Firebase.
   • Registra tu app (para iOS o Android) con Firebase.
   • Agrega un archivo de configuración de Firebase de plataformas para dispositivos móviles.

2. Crea una versión para computadoras de escritorio del archivo de configuración de Firebase:

   • Si agregaste el archivo google-services.json de Android: Cuando ejecutes tu app, Firebase ubicará este archivo para dispositivos móviles y generará automáticamente un archivo de configuración de Firebase para computadoras de escritorio (google-services-desktop.json).

   • Si agregaste el archivo GoogleService-Info.plist de iOS: Antes de que ejecutes tu app, debes convertir este archivo para dispositivos móviles en un archivo de configuración de Firebase para computadoras de escritorio. A fin de convertir el archivo, ejecuta el siguiente comando desde el mismo directorio donde se encuentra el archivo GoogleService-Info.plist:

     generate_xml_from_google_services_json.py --plist -i GoogleService-Info.plist

   Este archivo de configuración para computadoras de escritorio contiene el ID del proyecto de C++ que ingresaste en el flujo de trabajo de configuración de Firebase console. Consulta la Información sobre los proyectos de Firebase para obtener detalles acerca de los archivos de configuración.

3. Agrega los SDK de Firebase al proyecto de C++.

   Los pasos que se indican a continuación sirven como ejemplo de cómo agregar cualquier producto compatible de Firebase al proyecto de C++. En este, se explica cómo agregar Google Analytics para Firebase.

   1. Establece la ubicación de la variable del entorno FIREBASE_CPP_SDK_DIR en la del SDK de Firebase C++ descomprimido.

   2. Agrega el siguiente contenido al archivo CMakeLists.txt de tu proyecto, incluidas las bibliotecas de los productos de Firebase que deseas usar. Por ejemplo, para Analytics, agrega el siguiente contenido:

      # Add Firebase libraries to the target using the function from the SDK.
      add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL)
      
      # The core Firebase library (firebase_app) is required to use any Firebase product,
      # and it must always be listed last.
      set(firebase_libs firebase_analytics firebase_app)
      target_link_libraries(${target_name} "${firebase_libs}")
      

4. Ejecuta la app de C++.

Bibliotecas disponibles (para computadoras de escritorio)

El SDK de Firebase C++ incluye compatibilidad con flujos de trabajo de escritorio para un subconjunto de funciones, lo que permite usar ciertas partes de Firebase en versiones independientes para computadoras de escritorio en Windows, macOS y Linux.

Las bibliotecas de escritorio restantes son implementaciones auxiliares (no funcionales) que Firebase proporciona a fin de realizar compilaciones para Windows, macOS y Linux. Por lo tanto, no es necesario que compiles código de manera condicional orientado a la versión para computadoras de escritorio.

Realtime Database para computadoras de escritorio

El SDK de Realtime Database para computadoras de escritorio usa REST a fin de acceder a tu base de datos, por lo que debes declarar los índices que usas con Query::OrderByChild() en computadoras de escritorio o los objetos de escucha fallarán.

Información adicional para la configuración en computadoras de escritorio

Bibliotecas de Windows

En Windows, las versiones de las bibliotecas se proporcionan en función de los siguientes aspectos:

• Plataforma de compilación: modo de 32 bits (x86) frente a 64 bits (x64)
• Entorno de ejecución de Windows: multiproceso/MT frente a multiproceso DLL/MD
• Destino: liberación frente a depuración

Ten en cuenta que las bibliotecas que se indican a continuación se probaron con Visual Studio 2015 y 2017.

Cuando compiles apps para computadoras de escritorio de C++ en Windows, vincula las siguientes bibliotecas de los SDK de Windows con tu proyecto. Consulta la documentación del compilador para obtener más información.

Bibliotecas de macOS

En el caso de macOS (Darwin), solo se proporcionan las versiones de biblioteca para la plataforma de 64 bits (x86_64). También se proporcionan los marcos de trabajo para facilitar tu trabajo.

Recuerda que las bibliotecas de macOS se probaron con Xcode 9.4.1.

Cuando compiles apps para computadoras de escritorio de C++ en macOS, vincula los siguientes elementos a tu proyecto:

• biblioteca del sistema pthread
• marco de trabajo del sistema de macOS CoreFoundation
• marco de trabajo del sistema de macOS Foundation
• marco de trabajo del sistema de macOS Security

Consulta la documentación del compilador para obtener más información.

Bibliotecas de Linux

En el caso de Linux, solo se proporcionan las versiones de biblioteca para las plataformas de 32-bit (i386) y 64-bit (x86_64).

Recuerda que las bibliotecas de Linux se probaron con GCC 4.8.0, GCC 7.2.0 y Clang 5.0 en Ubuntu.

Cuando compiles apps para computadoras de escritorio de C++ en Linux, vincula la biblioteca del sistema pthread con tu proyecto. Consulta la documentación del compilador para obtener más información. Define -D_GLIBCXX_USE_CXX11_ABI=0 si vas a compilar con GCC 5 o una versión más reciente.

Pasos siguientes

• Explora las apps de muestra de Firebase.

• Explora el SDK de código abierto en GitHub.

• Prepárate para iniciar tu app:

  • Configura alertas de facturación.
  • Revisa la Lista de tareas para el lanzamiento de Firebase.