Adicionar o Firebase ao projeto do iOS

Pré-requisitos

  • Instale o Xcode 10.1 ou versões posteriores.

  • Instale o CocoaPods 1.4.0 ou versões posteriores.

  • Abra seu projeto no Xcode.

    • Seu projeto precisa segmentar o iOS 8 ou versões posteriores.

    • Os projetos do Swift precisam usar a versão 3.0 ou versões posteriores.

  • Configure um dispositivo físico com iOS ou o simulador iOS para executar seu app.

    • Para o Cloud Messaging, você precisará de:

      • um dispositivo físico com iOS;
      • uma chave de autenticação de notificação push da Apple para sua conta de desenvolvedor da Apple;
      • No Xcode, ative as notificações push em App > Recursos.
    • Para todos os outros produtos do Firebase, é possível usar um dispositivo físico com iOS ou o simulador de iOS.

  • Faça login no Firebase usando sua Conta do Google.

Se você ainda não tiver um projeto Xcode, faça o download de uma das nossas amostras de início rápido, se quiser apenas testar um produto do Firebase.

Etapa 1: criar um projeto do Firebase

Antes de adicionar o Firebase ao seu projeto de app para iOS, é preciso criar um projeto do Firebase e conectá-lo ao seu app para iOS. Consulte Noções básicas sobre projetos do Firebase para mais informações.

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 práticas recomendadas e informações sobre como adicionar apps a um projeto, incluindo como lidar com diversas variantes de versão.

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

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

  2. Insira o ID do pacote do seu app no campo ID do pacote do iOS.

    • Para encontrar esse ID, abra seu app no Xcode e acesse a guia Geral no diretório de nível superior Runner. O valor do campo Identificador do pacote é o ID do pacote do iOS (por exemplo, com.yourcompany.yourproject).
  3. (Opcional) Insira outras informações do app conforme solicitado pelo fluxo de trabalho de configuração.

  4. Clique em Registrar aplicativo.

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

  1. Clique em Fazer o download do GoogleService-Info.plist para receber 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. Quando solicitado, selecione adicionar o arquivo de configuração a todos os destinos.

Se você tiver vários IDs de pacote no seu projeto, é preciso associá-los a um app registrado no Console do Firebase para que cada app tenha seu 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 CocoaPods, é possível integrar os frameworks do SDK diretamente.

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

É possível adicionar qualquer um dos produtos do Firebase compatíveis com o app para iOS. Recomendamos começar com o Google Analytics para Firebase.

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

    cd your-project-directory
    pod init
  2. No seu Podfile, adicione os pods que você quer usar no app. Por exemplo, para o Analytics:

    pod 'Firebase/Analytics'

    Esse pod adicionará as bibliotecas de pré-requisitos necessárias para colocar o Firebase em funcionamento no seu app para iOS, juntamente com o Google Analytics para Firebase.

  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 seu app:

    Swift

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

    Objective-C

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

Depois de adicionar o código de inicialização, execute seu aplicativo para enviar ao Console do Firebase a confirmação de que você instalou o Firebase com sucesso.

Pods disponíveis

Os seguintes pods estão disponíveis para vários produtos do Firebase.

Produto Pod
AdMob pod "Firebase/AdMob"
Analytics pod "Firebase/Analytics"
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"
Crashlytics pod "Fabric"
pod "Crashlytics"
Dynamic Links pod "Firebase/DynamicLinks"
Mensagens no app pod "Firebase/InAppMessaging"
Exibição de mensagens no app pod "Firebase/InAppMessagingDisplay"
Kit de ML: APIs Vision pod "Firebase/MLVision"
Kit de ML: modelo de rotulagem de imagens pod "Firebase/MLVisionLabelModel"
Kit de ML: modelo de leitura de código de barras pod "Firebase/MLVisionBarcodeModel"
Kit de ML: modelo de reconhecimento de texto pod "Firebase/MLVisionTextModel"
Kit de ML: modelo de reconhecimento facial pod "Firebase/MLVisionFaceModel"
Kit de ML: modelo de detecção e rastreamento de objetos pod "Firebase/MLVisionObjectDetection"
Kit de ML: APIs Natural Language pod "Firebase/MLNaturalLanguage"
Kit de ML: modelo de identificação de linguagem pod "Firebase/MLNLLanguageID"
Kit de ML: modelo de tradução pod "Firebase/MLNLTranslate"
Kit de ML: modelo de resposta inteligente pod "Firebase/MLNLSmartReply"
Kit de ML: APIs Custom Model pod "Firebase/MLModelInterpreter"
Kit de ML: API AutoML Vision Edge pod "Firebase/MLVisionAutoML"
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 ao importar os frameworks diretamente.

  1. Faça o download do arquivo zip com o SDK do framework. Esse arquivo tem aproximadamente 1 GB e, por isso, o download pode levar algum tempo.

  2. Descompacte o arquivo e analise o README dos frameworks que você quer incluir no seu app.

  3. Adicione o sinalizador do vinculador ObjC (em inglês) a Other Linker Settings nas suas configurações de criação do destino.

Próximas etapas

Saiba mais sobre o Firebase:

Adicione recursos do Firebase ao seu app: