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

Adicionar o Firebase ao seu projeto da Apple

Pré-requisitos

  • Instalação dos programas a seguir:

    • Xcode 12.2 ou posterior
    • CocoaPods 1.10.0 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

Recomendamos o uso do CocoaPods (em inglês) para instalar as bibliotecas do Firebase. No entanto, se você prefere não usar o CocoaPods, é possível integrar os frameworks do SDK diretamente ou usar o Gerenciador de pacotes Swift.

Você está usando um dos exemplos do guia de início rápido? O projeto Xcode e o Podfile (com pods) já estão presentes, mas você ainda precisará adicionar o arquivo de configuração do Firebase e instalar os pods.

  1. Crie um Podfile, se ainda não tiver um:

    cd your-project-directory
    pod init
  2. No seu Podfile, adicione os pods do Firebase que você quer usar no app.

    É possível adicionar qualquer um dos produtos do Firebase compatíveis ao app da Apple.

    Analytics ativado

    platform :ios, ‘10.0’
    # Add the Firebase pod for Google Analytics pod 'Firebase/Analytics' # For Analytics without IDFA collection capability, use this pod instead # pod ‘Firebase/AnalyticsWithoutAdIdSupport’ # Add the pods for any other Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'

    Saiba mais sobre o IDFA, o identificador de publicidade no nível do dispositivo, na documentação da Apple Privacidade do usuário e uso de dados e Transparência no rastreamento de apps.

    Analytics não ativado

    platform :ios, ‘10.0’
    # Add the pods for the Firebase products you want to use in your app # For example, to use Firebase Authentication and Cloud Firestore pod 'Firebase/Auth' pod 'Firebase/Firestore'
  3. Instale os pods e abra seu arquivo .xcworkspace para ver o projeto no Xcode:

    pod install
    open your-project.xcworkspace

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 com suporte para as plataformas e os pods 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 CocoaPods, você ainda poderá aproveitar os SDKs do Firebase ao importar os frameworks diretamente.

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.

Gerenciador de pacotes do Swift

Para saber mais sobre a integração do Gerenciador de pacotes do Swift, acesse nosso guia.

Próximas etapas

Saiba mais sobre o Firebase:

Adicione serviços do Firebase ao seu app: