Agrega Firebase a tu proyecto de iOS

Requisitos previos

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

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

  • Abre tu proyecto en Xcode.

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

    • Los proyectos Swift deben usar la versión 3.0 o una más reciente.

  • Configura un dispositivo iOS físico o un simulador para ejecutar la app.

    • Para Cloud Messaging, necesitarás los siguientes elementos:

      • Un dispositivo iOS físico
      • Una clave de autenticación de notificaciones push de Apple para tu cuenta de desarrollador de Apple
      • En Xcode, habilita las notificaciones push en App > Capabilities
    • En todos los demás productos de Firebase, puedes usar un dispositivo iOS físico o un simulador.

  • Accede a Firebase con tu Cuenta de Google.

Si aún no tienes un proyecto de Xcode, puedes descargar uno de nuestros ejemplos de inicio rápido si solo quieres probar un producto de Firebase.

Paso 1: Crea un proyecto de Firebase

A fin de poder agregar Firebase a tu app para iOS, debes crear un proyecto de Firebase y conectarlo a la app. Consulta Información sobre los proyectos de Firebase para obtener detalles acerca del tema.

Paso 2: Registra tu app con Firebase

Cuando tengas un proyecto de Firebase, podrás agregarle tu app para iOS.

Visita 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 la app en el campo ID del paquete de iOS.

    • Para encontrar el ID del paquete, abre tu app en Xcode y accede a la pestaña General en el directorio Runner de nivel superior. El valor del campo Bundle Identifier (Identificador de paquete) es el ID del paquete de iOS (por ejemplo, com.yourcompany.yourproject).
  3. Ingresa otra información de la app si el flujo de trabajo de configuración lo solicita (opcional).

  4. Haz clic en Registrar app.

Paso 3: Agrega un 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 (GoogleService-Info.plist).

  2. Traslada el archivo de configuración al directorio raíz de tu proyecto de Xcode. Si se te solicita, selecciona la opción para agregar el archivo de configuración a todos los destinos.

Si tienes varios ID de paquete en tu proyecto, debes asociar cada uno con una app registrada en Firebase console a fin de que cada app tenga su propio archivo GoogleService-Info.plist.

Paso 4: Agrega los SDK de Firebase a tu app

Te recomendamos que uses CocoaPods para instalar las bibliotecas de Firebase. Si prefieres no usarlo, puedes integrar los marcos de trabajo del SDK directamente.

Ten en cuenta que, si usas una de las muestras de inicio rápido, estas ya contienen el proyecto de Xcode y el Podfile (con pods), pero, de todas formas, debes agregar tu archivo de configuración de Firebase y, luego, instalar los pods.

Puedes agregar cualquiera de los productos de Firebase admitidos a tu app para iOS. Recomendamos que comiences con Google Analytics para Firebase.

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

    cd your-project-directory
    pod init
  2. En tu Podfile, agrega los pods que deseas usar en tu app. Por ejemplo, para Analytics, agrega el siguiente contenido:

    pod 'Firebase/Analytics'

    Este pod agregará las bibliotecas necesarias a fin de comenzar a usar Firebase en tu app para iOS junto con Google Analytics para Firebase.

  3. Instala los pods y abre el archivo .xcworkspace para ver el proyecto en Xcode. Puedes hacerlo con los siguientes comandos:

    pod install
    open your-project.xcworkspace

Paso 5: Inicializa Firebase en tu app

El paso final es agregar código de inicialización a la aplicación. Es posible que ya lo hayas hecho cuando agregaste Firebase a la app. Si utilizas un proyecto de ejemplo de inicio rápido, ya está hecho.

  1. Importa el módulo de Firebase en UIApplicationDelegate:

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  2. Configura una instancia compartida de FirebaseApp, generalmente en el método application:didFinishLaunchingWithOptions: de tu app:

    Swift

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

    Objective-C

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

Después de agregar el código de inicialización, ejecuta tu app para verificar con Firebase console que instalaste Firebase correctamente.

Pods disponibles

Los siguientes pods están disponibles para los distintos productos Firebase.

Producto Pod
AdMob pod 'Firebase/AdMob'
Analytics pod 'Firebase/Analytics'
Authentication pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
SDK de cliente de Cloud Functions para Firebase pod 'Firebase/Functions'
Cloud Messaging pod 'Firebase/Messaging'
Cloud Storage pod 'Firebase/Storage'
Crashlytics pod 'Fabric'
pod 'Crashlytics'
Dynamic Links pod 'Firebase/DynamicLinks'
In-App Messaging pod 'Firebase/InAppMessaging'
Visualización de In-App Messaging pod 'Firebase/InAppMessagingDisplay'
Kit de AA: API de Vision pod 'Firebase/MLVision'
Kit de AA: Modelo de etiquetado de imágenes pod 'Firebase/MLVisionLabelModel'
Kit de AA: Modelo de escaneo de códigos de barras pod 'Firebase/MLVisionBarcodeModel'
Kit de AA: Modelo de reconocimiento de texto pod 'Firebase/MLVisionTextModel'
Kit de AA: Modelo de detección de rostro pod 'Firebase/MLVisionFaceModel'
Kit de AA: Modelo de detección y seguimiento de objetos pod 'Firebase/MLVisionObjectDetection'
Kit de AA: API de Natural Language pod 'Firebase/MLNaturalLanguage'
Kit de AA: Modelo de identificación de idiomas pod 'Firebase/MLNLLanguageID'
Kit de AA: Modelo de traducción pod 'Firebase/MLNLTranslate'
Kit de AA: Modelo de Respuesta inteligente pod 'Firebase/MLNLSmartReply'
Kit de AA: API de Custom Model pod 'Firebase/MLModelInterpreter'
Kit de AA: API de AutoML Vision Edge pod 'Firebase/MLVisionAutoML'
Performance Monitoring pod 'Firebase/Performance'
Realtime Database pod 'Firebase/Database'
Remote Config pod 'Firebase/RemoteConfig'

Integra sin CocoaPods

Para sacar provecho de los SDK de Firebase sin usar CocoaPods, puedes importar los marcos de trabajo de forma directa.

  1. Descarga el archivo ZIP del marco de trabajo del SDK. Se trata de un archivo de aproximadamente 1 GB, por lo que la descarga puede tardar un poco.

  2. Descomprime el archivo y revisa el archivo README de los marcos de trabajo que deseas incluir en tu app.

  3. Agrega la marca del vinculador ObjC a la sección Other Linker Settings de la configuración de compilación del destino.

Pasos siguientes

Obtén información acerca de Firebase:

Agrega funciones de Firebase a la app: