Adicione o Firebase ao seu projeto da Apple

Pré-requisitos

  • Instale o seguinte:

    • Xcode 14.1 ou posterior
  • Certifique-se de que seu projeto atenda a estes requisitos:

    • Seu projeto deve ter como alvo estas versões de plataforma ou posteriores:
      • iOS 11
      • macOS 10.13
      • tvOS 12
      • watchOS 6
  • Configure um dispositivo Apple físico ou use um simulador para executar seu aplicativo.

Se você ainda não tem um projeto Xcode e deseja apenas testar um produto Firebase, baixe um de nossos exemplos de início rápido .

Etapa 1 : crie um projeto Firebase

Antes de adicionar o Firebase ao seu aplicativo Apple, você precisa criar um projeto do Firebase para se conectar ao seu aplicativo. Visite Entenda os projetos do Firebase para saber mais sobre os projetos do Firebase.

Etapa 2 : registre seu aplicativo no Firebase

Para usar o Firebase em seu aplicativo Apple, você precisa registrar seu aplicativo no seu projeto Firebase. Registrar seu aplicativo geralmente é chamado de "adicionar" seu aplicativo ao projeto.

  1. Vá para o console do Firebase .

  2. No centro da página de visão geral do projeto, clique no ícone iOS+ para iniciar o fluxo de trabalho de configuração.

    Se você já adicionou um aplicativo ao seu projeto do Firebase, clique em Adicionar aplicativo para exibir as opções da plataforma.

  3. Insira o ID do pacote do seu aplicativo no campo ID do pacote .

  4. (Opcional) Insira outras informações do aplicativo: apelido do aplicativo e ID da App Store .

  5. Clique em Registrar aplicativo .

Etapa 3 : adicionar um arquivo de configuração do Firebase

  1. Clique em Baixar GoogleService-Info.plist para obter o arquivo de configuração das plataformas Firebase Apple ( GoogleService-Info.plist ).

  2. Mova seu arquivo de configuração para a raiz do seu projeto Xcode. Se solicitado, selecione para adicionar o arquivo de configuração a todos os destinos.

Se você tiver vários IDs de pacote no seu projeto, deverá associar cada ID de pacote a um aplicativo registrado no Console do Firebase para que cada aplicativo possa ter seu próprio arquivo GoogleService-Info.plist .

Etapa 4 : adicionar SDKs do Firebase ao seu aplicativo

Use o Swift Package Manager para instalar e gerenciar dependências do Firebase.

  1. No Xcode, com o projeto do seu aplicativo aberto, navegue até File > Add Packages .
  2. Quando solicitado, adicione o repositório SDK das plataformas Apple do Firebase:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Selecione a versão do SDK que você deseja usar.
  5. Escolha as bibliotecas do Firebase que você deseja usar.

    Se o Google Analytics estiver ativado em seu projeto Firebase, adicione FirebaseAnalytics . Para o Analytics sem capacidade de coleta de IDFA, adicione FirebaseAnalyticsWithoutAdId .

Quando terminar, o Xcode começará automaticamente a resolver e baixar suas dependências em segundo plano.

Etapa 5 : inicialize o Firebase em seu aplicativo

A etapa final é adicionar o código de inicialização ao seu aplicativo. Talvez você já tenha feito isso como parte da adição do Firebase ao seu aplicativo. Se você estiver usando um projeto de amostra de início rápido , isso foi feito para você.

  1. Importe o módulo FirebaseCore em seu UIApplicationDelegate , bem como quaisquer outros módulos Firebase que seu delegado de aplicativo usa. Por exemplo, para usar o Cloud Firestore e o Authentication:

    SwiftUI

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

    Rápido

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objetivo-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Configure uma instância compartilhada FirebaseApp no ​​método application(_:didFinishLaunchingWithOptions:) delegado do seu aplicativo:

    SwiftUI

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

    Rápido

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

    Objetivo-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Se estiver usando SwiftUI, você deve criar um delegado de aplicativo e anexá-lo à sua estrutura App via UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor . Você também deve desativar o swizzling de delegado do aplicativo. Para obter mais informações, consulte as instruções do 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. Se você incluiu o SDK do Firebase para Google Analytics, poderá executar seu aplicativo para enviar a verificação ao console do Firebase de que você instalou o Firebase com sucesso.

É isso! Você pode pular para as próximas etapas .

No entanto, se você estiver tendo problemas para configurar, visite Solução de problemas e perguntas frequentes das plataformas Apple .

Bibliotecas disponíveis

Esta seção lista os produtos Firebase compatíveis com plataformas Apple. Saiba mais sobre essas bibliotecas da plataforma Firebase Apple:

Serviço ou Produto Vagens Bibliotecas SwiftPM Adicionar análise?
AdMob pod 'Google-Mobile-Ads-SDK' N / D
Análise pod 'FirebaseAnalytics' FirebaseAnalytics
Verificação de aplicativo pod 'FirebaseAppCheck' FirebaseAppCheck
Distribuição de aplicativos pod 'FirebaseAppDistribution' FirebaseAppDistribution
Autenticação pod 'FirebaseAuth' FirebaseAuth
Cloud Fire Store pod 'FirebaseFirestore' FirebaseFirestore
SDK do cliente do Cloud Functions para Firebase pod 'FirebaseFunctions' FirebaseFunctions
Mensagens na nuvem pod 'FirebaseMessaging' FirebaseMessaging
Armazenamento na núvem pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Links Dinâmicos pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
Mensagens no aplicativo pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(obrigatório)
Instalações do Firebase pod 'FirebaseInstallations' FirebaseInstallations
APIs de modelo personalizado do Firebase ML pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Monitoramento de desempenho pod 'FirebasePerformance' FirebasePerformance
Banco de dados em tempo real pod 'FirebaseDatabase' FirebaseDatabase
Configuração remota pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

Integre sem usar o Swift Package Manager

Se não quiser usar o Swift Package Manager, você ainda pode aproveitar as vantagens dos SDKs do Firebase usando CocoaPods ou importando as estruturas diretamente.

CocoaPods

Saiba mais sobre a integração do CocoaPods em nosso guia .

Estruturas

Além de oferecer suporte à plataforma iOS, o zip agora inclui arquivos .xcframework . Para obter detalhes, consulte o README do SDK das plataformas Apple do Firebase no GitHub .

  1. Baixe o zip do SDK da estrutura . Este é um arquivo de aproximadamente 200 MB e pode levar algum tempo para ser baixado.

  2. Descompacte o arquivo e integre as estruturas que deseja incluir no seu aplicativo.

    Você pode encontrar instruções de integração em um dos seguintes locais:

    Para obter informações sobre versões ou dependências da estrutura, consulte o arquivo METADATA.md na distribuição zip baixada.

  3. Adicione o sinalizador do vinculador -ObjC em Other Linker Settings nas configurações de compilação do seu destino.

Próximos passos

Saiba mais sobre o Firebase:

Adicione serviços do Firebase ao seu aplicativo: