O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Adicionar o Firebase ao projeto do iOS

Pré-requsitos

  • 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:

    • Seu projeto precisa ser desenvolvido para iOS 10 ou versões posteriores.
  • Configure um dispositivo físico com iOS ou use o simulador iOS para executar 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 app para iOS, é preciso criar um projeto do Firebase para então conectá-lo ao app. 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, é possível adicionar seu app para iOS 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 do iOS.

  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 do Firebase para iOS (GoogleService-Info.plist).

  2. Mova o 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 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 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 (Beta).

Você está usando uma das amostras 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 para iOS.

    Analytics ativado

    platform :ios, ‘10.0’
    # Add the Firebase pod for Google Analytics pod 'Firebase/Analytics'
    # 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'

    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 para você.

  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 Firebase Analytics, pode executar seu aplicativo para enviar uma verificação ao console do Firebase que instalou o Firebase.

Pronto. Você pode pular para as próximas etapas.

Pods disponíveis

Esta seção lista os produtos do Firebase compatíveis com o iOS e os pods deles. Saiba mais sobre estas bibliotecas do Firebase para iOS:

Serviço ou produto Pods Adicionar Analytics?
AdMob pod 'Google-Mobile-Ads-SDK'
Analytics pod 'Firebase/Analytics'
App Distribution pod 'Firebase/AppDistribution'
Authentication pod 'Firebase/Auth'
Cloud Firestore pod 'Firebase/Firestore'
SDK de cliente do Cloud Functions para Firebase pod 'Firebase/Functions'
Cloud Messaging pod 'Firebase/Messaging'
Cloud Storage pod 'Firebase/Storage'
Firebase Crashlytics pod 'Firebase/Crashlytics'
Dynamic Links pod 'Firebase/DynamicLinks'
Mensagens no app pod 'Firebase/InAppMessaging'
(obrigatório)
APIs do modelo personalizado do Firebase ML pod 'Firebase/MLModelDownloader'
Monitoramento de desempenho pod 'Firebase/Performance'
Realtime Database pod 'Firebase/Database'
Configuração remota pod 'Firebase/RemoteConfig'

Integração sem CocoaPods

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

Frameworks

Além de oferecer compatibilidade com a plataforma iOS, o zip agora inclui arquivos .xcframework que adicionam suporte à comunidade do Catalyst. Para detalhes, consulte o arquivo README do SDK do Firebase para iOS no GitHub.

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

  2. Descompacte o arquivo e analise o README dos frameworks que você quer 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

No momento, o Gerenciador de pacotes do Swift está na versão Beta. Siga a documentação no GitHub e registre qualquer feedback no rastreador de problemas do GitHub.

Próximas etapas

Saiba mais sobre o Firebase:

Adicione serviços do Firebase ao seu app: