Catch up on everthing we announced at this year's Firebase Summit. Learn more

Adicionar o Firebase ao seu projeto da Apple

Pré-requisitos

  • Instalar o seguinte:

    • Xcode 12.5 ou posterior
  • Verifique se o projeto atende a estes requisitos:

    • O projeto precisa segmentar estas versões da plataforma ou versões mais recentes:
      • iOS 10
      • macOS 10.12
      • tvOS 12
      • watchOS 6
  • Configure um dispositivo físico da Apple ou use um simulador para executar o seu app.

Se você ainda não tem um projeto do Xcode e quiser testar um produto do Firebase, faça o download de um dos nossos exemplos de início rápido.

Etapa 1: criar um projeto do Firebase

Antes de adicionar o Firebase ao seu app da Apple, crie um projeto do Firebase para conectá-lo ao seu aplicativo. Acesse Noções básicas sobre projetos do Firebase para saber mais.

Etapa 2: registrar seu app com o Firebase

Depois de criar um projeto do Firebase, adicione o seu app da Apple a ele.

Consulte Noções básicas sobre projetos do Firebase para ver práticas recomendadas e informações sobre como adicionar apps a um projeto do Firebase, incluindo como lidar com diversas variantes de build.

  1. Acesse 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 app ao seu projeto do Firebase, clique em Adicionar app para exibir as opções da plataforma.

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

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

  5. Clique em Register app.

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

  1. Clique em Fazer o download do GoogleService-Info.plist para solicitar o arquivo de configuração das plataformas Apple do Firebase (GoogleService-Info.plist).

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

Se o projeto tiver vários IDs de pacotes, associe cada ID com um app registrado no Console do Firebase para que tenha o próprio arquivo GoogleService-Info.plist.

Etapa 4: adicionar SDKs do Firebase ao seu app

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

  1. Com seu projeto do app aberto no Xcode, acesse File > Swift Packages > Add Package Dependency.
  2. Quando solicitado, adicione o repositório do SDK do Firebase para as plataformas da Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. Selecione a versão do SDK que você quer usar.
  5. Escolha as bibliotecas do Firebase que você quer usar.

    Se o Google Analytics estiver ativado no seu projeto do Firebase, adicione FirebaseAnalytics. Para o Analytics sem o recurso de coleção de IDFAs, adicione FirebaseAnalyticsWithoutAdId em vez da outra opção.

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

Etapa 5: inicializar o Firebase no seu app

A etapa final é adicionar o código de inicialização ao app. Talvez você já tenha feito isso quando adicionou o Firebase ao seu app. Se você estiver usando um projeto de amostra do guia de início rápido, isso já foi feito.

  1. Importe o módulo do Firebase no UIApplicationDelegate:

    Swift

    import Firebase

    Objective-C

    @import Firebase;
  2. Configure uma instância compartilhada do FirebaseApp, normalmente no método application:didFinishLaunchingWithOptions: do app.

    Swift

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Se você incluiu o SDK do Firebase no Google Analytics, poderá executar seu app para enviar a verificação ao Console do Firebase informando que a instalação foi um sucesso.

Pronto. Pule para as próximas etapas.

Se você estiver com problemas para fazer a configuração, acesse a Solução de problemas e perguntas frequentes sobre as plataformas da Apple.

Bibliotecas disponíveis

Nesta seção, listamos os produtos do Firebase compatíveis com as plataformas da Apple. Saiba mais sobre estas bibliotecas da plataforma Apple do Firebase:

Serviço ou produto Pods Bibliotecas do SwiftPM Adicionar o Analytics?
AdMob pod 'Google-Mobile-Ads-SDK' N/A
Analytics pod 'Firebase/Analytics' FirebaseAnalytics
App Check pod 'Firebase/AppCheck' FirebaseAppCheck
App Distribution pod 'Firebase/AppDistribution' FirebaseAppDistribution
Authentication pod 'Firebase/Auth' FirebaseAuth
Cloud Firestore pod 'Firebase/Firestore' FirebaseFirestore
SDK de cliente do Cloud Functions para Firebase pod 'Firebase/Functions' FirebaseFunctions
Cloud Messaging pod 'Firebase/Messaging' FirebaseMessaging
Cloud Storage pod 'Firebase/Storage' FirebaseStorage
Crashlytics pod 'Firebase/Crashlytics' FirebaseCrashlytics
Dynamic Links pod 'Firebase/DynamicLinks' FirebaseDynamicLinks
Mensagens no app pod 'Firebase/InAppMessaging' FirebaseInAppMessaging
(obrigatório)
Instalações do Firebase pod 'Firebase/Installations' FirebaseInstallations
APIs do modelo personalizado do Firebase ML pod 'Firebase/MLModelDownloader' FirebaseMLModelDownloader
Monitoramento de desempenho pod 'Firebase/Performance' FirebasePerformance
Realtime Database pod 'Firebase/Database' FirebaseDatabase
Configuração remota pod 'Firebase/RemoteConfig' FirebaseRemoteConfig

Integração sem um gerenciador de dependências

Se não quiser usar o Gerenciador de pacotes do Swift, você ainda poderá aproveitar os SDKs do Firebase importando os frameworks diretamente ou usando o CocoaPods.

Frameworks

Além de oferecer suporte para a plataforma iOS, o zip agora inclui arquivos .xcframework. Para detalhes, consulte no GitHub o arquivo README do SDK do Firebase para as plataformas da Apple (em inglês).

  1. Faça o download do arquivo zip com o SDK do framework. Esse arquivo tem aproximadamente 200 MB e o download pode levar algum tempo.

  2. Descompacte o arquivo e confira o documento README para ver quais frameworks você vai querer incluir no seu app.

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

CocoaPods

Para saber mais sobre a integração do CocoaPods, consulte nosso guia.

Próximas etapas

Saiba mais sobre o Firebase:

Adicione serviços do Firebase ao seu app: