Agregue Firebase a su proyecto de Apple

requisitos previos

• Instale lo siguiente:

  • Xcode 13.3.1 o posterior

• Asegúrate de que tu proyecto cumpla con estos requisitos:

  • Su proyecto debe apuntar a estas versiones de plataforma o posteriores:
    • iOS 11
    • mac OS 10.13
    • tvOS 12
    • reloj OS 6

• Configure un dispositivo Apple físico o use un simulador para ejecutar su aplicación.

  ¿Quieres usar la mensajería en la nube?

  Para Cloud Messaging en plataformas Apple, estos son los requisitos previos:

  • Configura un dispositivo Apple físico .
  • Obtenga una clave de autenticación de notificación push de Apple para su cuenta de desarrollador de Apple .
  • Habilite las notificaciones automáticas en Xcode en Aplicación > Capacidades .

• Inicie sesión en Firebase con su cuenta de Google.

Si aún no tiene un proyecto de Xcode y solo quiere probar un producto de Firebase, puede descargar uno de nuestros ejemplos de inicio rápido .

Paso 1 : crea un proyecto de Firebase

Antes de que pueda agregar Firebase a su aplicación de Apple, debe crear un proyecto de Firebase para conectarse a su aplicación. Visite Comprender los proyectos de Firebase para obtener más información sobre los proyectos de Firebase.

Paso 2 : Registre su aplicación con Firebase

Para usar Firebase en su aplicación de Apple, debe registrar su aplicación con su proyecto de Firebase. Registrar su aplicación a menudo se denomina "agregar" su aplicación a su proyecto.

1. Ve a la consola de Firebase .

2. En el centro de la página de descripción general del proyecto, haga clic en el icono de iOS+ para iniciar el flujo de trabajo de configuración.

   Si ya agregó una aplicación a su proyecto de Firebase, haga clic en Agregar aplicación para mostrar las opciones de la plataforma.

3. Ingrese el ID del paquete de su aplicación en el campo ID del paquete .

   ¿Qué es un ID de paquete y dónde se encuentra?

   • Un ID de paquete identifica de forma única una aplicación en el ecosistema de Apple.

   • Encuentre su ID de paquete: abra su proyecto en Xcode, seleccione la aplicación de nivel superior en el navegador de proyectos, luego seleccione la pestaña General .

     El valor del campo Identificador de paquete es el ID del paquete (por ejemplo, com.yourcompany.yourproject ).

   • Tenga en cuenta que el valor del ID del paquete distingue entre mayúsculas y minúsculas y no se puede cambiar para esta aplicación de Firebase después de que se haya registrado con su proyecto de Firebase.

4. (Opcional) Ingrese otra información de la aplicación: apodo de la aplicación e ID de la tienda de aplicaciones.

   ¿Cómo se usan el apodo de la aplicación y el ID de la tienda de aplicaciones en Firebase?

   • Apodo de la aplicación : un identificador de conveniencia interno que solo es visible para usted en la consola de Firebase

   • Id. de App Store : Utilizado por Firebase Dynamic Links para redirigir a los usuarios a su página de App Store y por Google Analytics para importar eventos de conversión a Google Ads . Si su aplicación aún no tiene una ID de App Store, puede agregar la ID más adelante en la configuración de su proyecto .

5. Haga clic en Registrar aplicación .

Paso 3 : Agregar un archivo de configuración de Firebase

1. Haga clic en Descargar GoogleService-Info.plist para obtener el archivo de configuración de su plataforma Firebase Apple ( GoogleService-Info.plist ).

   ¿Qué necesita saber acerca de este archivo de configuración?

   • El archivo de configuración de Firebase contiene identificadores únicos, pero no secretos, para su proyecto. Para obtener más información sobre este archivo de configuración, visite Comprender los proyectos de Firebase .

   • Puede volver a descargar su archivo de configuración de Firebase en cualquier momento.

   • Asegúrese de que el nombre del archivo de configuración no tenga caracteres adicionales, como (2) .

2. Mueva su archivo de configuración a la raíz de su proyecto Xcode. Si se le solicita, seleccione agregar el archivo de configuración a todos los destinos.

Si tiene varios ID de paquete en su proyecto, debe asociar cada ID de paquete con una aplicación registrada en la consola de Firebase para que cada aplicación pueda tener su propio archivo GoogleService-Info.plist .

Paso 4 : agregue los SDK de Firebase a su aplicación

Use Swift Package Manager para instalar y administrar las dependencias de Firebase.

1. En Xcode, con su proyecto de aplicación abierto, vaya a Archivo > Agregar paquetes .
2. Cuando se le solicite, agregue el repositorio del SDK de las plataformas Apple de Firebase:

  https://github.com/firebase/firebase-ios-sdk

3. Seleccione la versión SDK que desea utilizar.

4. Elija las bibliotecas de Firebase que desea usar.

   Si Google Analytics está habilitado en su proyecto de Firebase, asegúrese de agregar FirebaseAnalytics . Para Analytics sin capacidad de recopilación de IDFA, agregue FirebaseAnalyticsWithoutAdId en su lugar.

Cuando termine, Xcode comenzará a resolver y descargar automáticamente sus dependencias en segundo plano.

Paso 5 : Inicialice Firebase en su aplicación

El paso final es agregar el código de inicialización a su aplicación. Es posible que ya haya hecho esto como parte de la adición de Firebase a su aplicación. Si está utilizando un proyecto de muestra de inicio rápido , esto se ha hecho por usted.

1. Importe el módulo FirebaseCore en su UIApplicationDelegate , así como cualquier otro módulo de Firebase que use el delegado de su aplicación. Por ejemplo, para usar Cloud Firestore y autenticación:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Rápido

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   C objetivo

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Configure una instancia compartida de FirebaseApp en el método application(_:didFinishLaunchingWithOptions:) del delegado de su aplicación:

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Rápido

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   C objetivo

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Si usa SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura de App a través UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor . También debe deshabilitar el intercambio de delegados de aplicaciones. Para obtener más información, consulte las instrucciones de SwiftUI .

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. Si ha incluido el SDK de Firebase para Google Analytics, puede ejecutar su aplicación para enviar una verificación a la consola de Firebase de que instaló Firebase correctamente.

¡Eso es! Puede pasar directamente a los siguientes pasos .

Sin embargo, si tiene problemas para configurarlo, visite la sección de Preguntas frecuentes y resolución de problemas de las plataformas de Apple .

Bibliotecas disponibles

En esta sección, se enumeran los productos de Firebase compatibles con las plataformas de Apple. Obtenga más información sobre estas bibliotecas de la plataforma Apple de Firebase:

• Documentación de referencia ( Swift | Obj-C )

• Firebase Apple plataformas SDK GitHub repo

Integre sin usar Swift Package Manager

Si no quiere usar Swift Package Manager, aún puede aprovechar los SDK de Firebase usando CocoaPods o importando los marcos directamente.

CocoaPods

Obtenga más información sobre la integración de CocoaPods en nuestra guía .

Marcos

Además de admitir la plataforma iOS, el zip ahora incluye archivos .xcframework . Para obtener más información, consulte el archivo LÉAME del SDK de las plataformas Apple de Firebase en GitHub .

1. Descargue el marco SDK zip . Este es un archivo de ~200 MB y puede tardar algún tiempo en descargarse.

2. Descomprima el archivo, luego revise el README para los marcos que desea incluir en su aplicación.

3. Agregue el indicador del vinculador -ObjC en sus Other Linker Settings del vinculador en la configuración de compilación de su objetivo.

Próximos pasos

Más información sobre Firebase:

• Visite Comprender los proyectos de Firebase para obtener más información sobre los proyectos de Firebase y las prácticas recomendadas para los proyectos.

• Explora las aplicaciones de muestra de Firebase .

• Obtén experiencia práctica con Firebase iOS Codelab .

• Explore el código fuente abierto en GitHub .

• Prepárese para lanzar su aplicación:

  • Configura alertas de presupuesto para tu proyecto en Google Cloud Console.
  • Supervise el panel de uso y facturación en la consola de Firebase para obtener una imagen general del uso de su proyecto en varios servicios de Firebase.
  • Revise la lista de verificación de lanzamiento de Firebase .

• ¿Tiene problemas con Firebase y su proyecto de Apple? Visite la sección de solución de problemas y preguntas frecuentes de las plataformas de Apple .

Agregue los servicios de Firebase a su aplicación:

• Obtenga información sobre el comportamiento de los usuarios con Analytics .

• Configure la autenticación de usuario con Autenticación .

• Almacene datos, como información del usuario, con Cloud Firestore o Realtime Database .

• Almacene archivos, como fotos y videos, con Cloud Storage .

• Active el código de back-end que se ejecuta en un entorno seguro con Cloud Functions .

• Envía notificaciones con Cloud Messaging .

• Averigüe cuándo y por qué su aplicación falla con Crashlytics .

requisitos previos

• Instale lo siguiente:

  • Xcode 13.3.1 o posterior

• Asegúrate de que tu proyecto cumpla con estos requisitos:

  • Su proyecto debe apuntar a estas versiones de plataforma o posteriores:
    • iOS 11
    • mac OS 10.13
    • tvOS 12
    • reloj OS 6

• Configure un dispositivo Apple físico o use un simulador para ejecutar su aplicación.

  ¿Quieres usar la mensajería en la nube?

  Para Cloud Messaging en plataformas Apple, estos son los requisitos previos:

  • Configura un dispositivo Apple físico .
  • Obtenga una clave de autenticación de notificación push de Apple para su cuenta de desarrollador de Apple .
  • Habilite las notificaciones automáticas en Xcode en Aplicación > Capacidades .

• Inicie sesión en Firebase con su cuenta de Google.

Si aún no tiene un proyecto de Xcode y solo quiere probar un producto de Firebase, puede descargar uno de nuestros ejemplos de inicio rápido .

Paso 1 : crea un proyecto de Firebase

Antes de que pueda agregar Firebase a su aplicación de Apple, debe crear un proyecto de Firebase para conectarse a su aplicación. Visite Comprender los proyectos de Firebase para obtener más información sobre los proyectos de Firebase.

Paso 2 : Registre su aplicación con Firebase

Para usar Firebase en su aplicación de Apple, debe registrar su aplicación con su proyecto de Firebase. Registrar su aplicación a menudo se denomina "agregar" su aplicación a su proyecto.

1. Ve a la consola de Firebase .

2. En el centro de la página de descripción general del proyecto, haga clic en el icono de iOS+ para iniciar el flujo de trabajo de configuración.

   Si ya agregó una aplicación a su proyecto de Firebase, haga clic en Agregar aplicación para mostrar las opciones de la plataforma.

3. Ingrese el ID del paquete de su aplicación en el campo ID del paquete .

   ¿Qué es un ID de paquete y dónde se encuentra?

   • Un ID de paquete identifica de forma única una aplicación en el ecosistema de Apple.

   • Encuentre su ID de paquete: abra su proyecto en Xcode, seleccione la aplicación de nivel superior en el navegador de proyectos, luego seleccione la pestaña General .

     El valor del campo Identificador de paquete es el ID del paquete (por ejemplo, com.yourcompany.yourproject ).

   • Tenga en cuenta que el valor del ID del paquete distingue entre mayúsculas y minúsculas y no se puede cambiar para esta aplicación de Firebase después de que se haya registrado con su proyecto de Firebase.

4. (Opcional) Ingrese otra información de la aplicación: apodo de la aplicación e ID de la tienda de aplicaciones.

   ¿Cómo se usan el apodo de la aplicación y el ID de la tienda de aplicaciones en Firebase?

   • Apodo de la aplicación : un identificador de conveniencia interno que solo es visible para usted en la consola de Firebase

   • Id. de App Store : Utilizado por Firebase Dynamic Links para redirigir a los usuarios a su página de App Store y por Google Analytics para importar eventos de conversión a Google Ads . Si su aplicación aún no tiene una ID de App Store, puede agregar la ID más adelante en la configuración de su proyecto .

5. Haga clic en Registrar aplicación .

Paso 3 : Agregar un archivo de configuración de Firebase

1. Haga clic en Descargar GoogleService-Info.plist para obtener el archivo de configuración de su plataforma Firebase Apple ( GoogleService-Info.plist ).

   ¿Qué necesita saber acerca de este archivo de configuración?

   • El archivo de configuración de Firebase contiene identificadores únicos, pero no secretos, para su proyecto. Para obtener más información sobre este archivo de configuración, visite Comprender los proyectos de Firebase .

   • Puede volver a descargar su archivo de configuración de Firebase en cualquier momento.

   • Asegúrese de que el nombre del archivo de configuración no tenga caracteres adicionales, como (2) .

2. Mueva su archivo de configuración a la raíz de su proyecto Xcode. Si se le solicita, seleccione agregar el archivo de configuración a todos los destinos.

Si tiene varios ID de paquete en su proyecto, debe asociar cada ID de paquete con una aplicación registrada en la consola de Firebase para que cada aplicación pueda tener su propio archivo GoogleService-Info.plist .

Paso 4 : agregue los SDK de Firebase a su aplicación

Use Swift Package Manager para instalar y administrar las dependencias de Firebase.

1. En Xcode, con su proyecto de aplicación abierto, vaya a Archivo > Agregar paquetes .
2. Cuando se le solicite, agregue el repositorio del SDK de las plataformas Apple de Firebase:

  https://github.com/firebase/firebase-ios-sdk

3. Seleccione la versión SDK que desea utilizar.

4. Elija las bibliotecas de Firebase que desea usar.

   Si Google Analytics está habilitado en su proyecto de Firebase, asegúrese de agregar FirebaseAnalytics . Para Analytics sin capacidad de recopilación de IDFA, agregue FirebaseAnalyticsWithoutAdId en su lugar.

Cuando termine, Xcode comenzará a resolver y descargar automáticamente sus dependencias en segundo plano.

Paso 5 : Inicialice Firebase en su aplicación

El paso final es agregar el código de inicialización a su aplicación. Es posible que ya haya hecho esto como parte de la adición de Firebase a su aplicación. Si está utilizando un proyecto de muestra de inicio rápido , esto se ha hecho por usted.

1. Importe el módulo FirebaseCore en su UIApplicationDelegate , así como cualquier otro módulo de Firebase que use el delegado de su aplicación. Por ejemplo, para usar Cloud Firestore y autenticación:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Rápido

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   C objetivo

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Configure una instancia compartida de FirebaseApp en el método application(_:didFinishLaunchingWithOptions:) del delegado de su aplicación:

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Rápido

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   C objetivo

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Si usa SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura de App a través UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor . También debe deshabilitar el intercambio de delegados de aplicaciones. Para obtener más información, consulte las instrucciones de SwiftUI .

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. Si ha incluido el SDK de Firebase para Google Analytics, puede ejecutar su aplicación para enviar una verificación a la consola de Firebase de que instaló Firebase correctamente.

¡Eso es! Puede pasar directamente a los siguientes pasos .

Sin embargo, si tiene problemas para configurarlo, visite la sección de Preguntas frecuentes y resolución de problemas de las plataformas de Apple .

Bibliotecas disponibles

En esta sección, se enumeran los productos de Firebase compatibles con las plataformas de Apple. Obtenga más información sobre estas bibliotecas de la plataforma Apple de Firebase:

• Documentación de referencia ( Swift | Obj-C )

• Firebase Apple plataformas SDK GitHub repo

Integre sin usar Swift Package Manager

Si no quiere usar Swift Package Manager, aún puede aprovechar los SDK de Firebase usando CocoaPods o importando los marcos directamente.

CocoaPods

Obtenga más información sobre la integración de CocoaPods en nuestra guía .

Marcos

Además de admitir la plataforma iOS, el zip ahora incluye archivos .xcframework . Para obtener más información, consulte el archivo LÉAME del SDK de las plataformas Apple de Firebase en GitHub .

1. Descargue el marco SDK zip . Este es un archivo de ~200 MB y puede tardar algún tiempo en descargarse.

2. Descomprima el archivo, luego revise el README para los marcos que desea incluir en su aplicación.

3. Agregue el indicador del vinculador -ObjC en sus Other Linker Settings del vinculador en la configuración de compilación de su objetivo.

Próximos pasos

Más información sobre Firebase:

• Visite Comprender los proyectos de Firebase para obtener más información sobre los proyectos de Firebase y las prácticas recomendadas para los proyectos.

• Explora las aplicaciones de muestra de Firebase .

• Obtén experiencia práctica con Firebase iOS Codelab .

• Explore el código fuente abierto en GitHub .

• Prepárese para lanzar su aplicación:

  • Configura alertas de presupuesto para tu proyecto en Google Cloud Console.
  • Supervise el panel de uso y facturación en la consola de Firebase para obtener una imagen general del uso de su proyecto en varios servicios de Firebase.
  • Revise la lista de verificación de lanzamiento de Firebase .

• ¿Tiene problemas con Firebase y su proyecto de Apple? Visite la sección de solución de problemas y preguntas frecuentes de las plataformas de Apple .

Agregue los servicios de Firebase a su aplicación:

• Obtenga información sobre el comportamiento de los usuarios con Analytics .

• Configure la autenticación de usuario con Autenticación .

• Almacene datos, como información del usuario, con Cloud Firestore o Realtime Database .

• Almacene archivos, como fotos y videos, con Cloud Storage .

• Active el código de back-end que se ejecuta en un entorno seguro con Cloud Functions .

• Envía notificaciones con Cloud Messaging .

• Averigüe cuándo y por qué su aplicación falla con Crashlytics .