Adicionar o Firebase ao projeto do iOS

Pré-requisitos

Antes de começar, é preciso que seu ambiente tenha as seguintes configurações:

  • Xcode 8.0 ou posterior
  • um projeto do Xcode segmentado para iOS 8 ou posterior
  • para projetos do Swift, Swift 3.0 ou posterior
  • o identificador de pacote do seu app
  • CocoaPods 1.4.0 ou posterior
  • para Cloud Messaging:
    • 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

Se você ainda não tem um projeto de Xcode e quer apenas testar um recurso do Firebase, pode fazer o download de um de nossos exemplos para início rápido. Se você usa um exemplo para início rápido, anote o identificador do pacote nas configurações do projeto. Você precisará dele na próxima etapa.

Adicionar o Firebase ao seu app

Adicione o Firebase ao seu app. Para isso, serão necessários um projeto e um arquivo de configuração do Firebase para o app.

Para criar um projeto do Firebase:

  1. Crie um projeto no Firebase console se ainda não tiver um. Clique em Adicionar projeto. Se você já tiver um projeto do Google associado ao seu aplicativo para dispositivos móveis, selecione-o no menu suspenso Nome do projeto. Caso contrário, insira um nome de projeto para criar um novo.
  2. Opcional: edite o Código do projeto. Seu projeto recebe automaticamente um código exclusivo que é usado em recursos do Firebase visíveis publicamente, como URLs de bancos de dados e seu subdomínio do Firebase Hosting. Você pode alterá-lo agora se quiser usar um subdomínio específico.
  3. Siga as demais etapas de configuração e clique em Criar projeto, ou Adicionar Firebase se você estiver usando um projeto existente, para começar a provisionar recursos para o projeto. Isso costuma levar alguns minutos. Quando o processo for concluído, você será levado à visão geral do projeto.

Agora que você tem um projeto, adicione seu aplicativo para iOS a ele:

  1. Clique em Adicionar o Firebase ao app para iOS e siga as etapas de configuração. Se você estiver importando um projeto do Google, isso pode ocorrer automaticamente. Basta fazer o download do arquivo de configuração.
  2. Quando solicitado, digite o código do pacote do app. É importante inserir essa informação ao adicionar um app ao projeto do Firebase.
  3. Durante o processo, você fará o download de um arquivo GoogleService-Info.plist. Você pode fazer o download desse arquivo novamente a qualquer momento.
  4. Depois de adicionar o código de inicialização, execute seu aplicativo para enviar ao Firebase console a confirmação de que você instalou o Firebase com sucesso.

Adicionar o SDK

Se você estiver configurando um novo projeto, é necessário instalar o SDK. Talvez você tenha feito isso durante a criação do projeto do Firebase.

Recomendamos o uso do CocoaPods para a instalação das bibliotecas. Você pode instalar o CocoaPods seguindo as instruções de instalação (em inglês). Se você prefere não usar o CocoaPods, é possível integrar as bibliotecas do SDK diretamente sem precisar dele.

Se você fizer o download e executar um dos exemplos de guia de início rápido, o projeto Xcode e o Podfile já estarão adicionados, mas você ainda precisará instalar os pods e fazer o download do arquivo GoogleService-Info.plist. Se quiser integrar as bibliotecas do Firebase a um de seus projetos, adicione os pods das bibliotecas que quer usar.

  1. Se você ainda não tiver um projeto do Xcode, crie um agora.

  2. Crie um Podfile se ainda não tiver um:

    $ cd your-project directory
    $ pod init
    
  3. Inclua os pods que quer instalar. Você pode incluir um pod em seu Podfile como este:

    pod 'Firebase/Core'
    
    

    Esse procedimento adicionará as bibliotecas de pré-requisitos necessárias para colocar o Firebase em funcionamento no seu aplicativo iOS, juntamente com o Google Analytics for Firebase. Os pods e as subespecificações disponíveis no momento estão listados a seguir. Essas informações também estão nos guias de configuração específicos dos recursos.

  4. Instale os pods e abra o arquivo .xcworkspace para ver o projeto no Xcode.

    $ pod install
    $ open your-project.xcworkspace
    
  5. Faça o download de um arquivo GoogleService-Info.plist no Firebase console e inclua-o no seu app.

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ê usar um 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 de FirebaseApp, normalmente no método application:didFinishLaunchingWithOptions: do aplicativo:

    Swift

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

    Objective-C

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

Conjuntos disponíveis

Estes conjuntos estão disponíveis para os diferentes recursos do Firebase.

Pod Serviço
pod 'Firebase/Core' Bibliotecas de pré-requisito e Analytics
pod 'Firebase/AdMob' AdMob
pod 'Firebase/Messaging' Cloud Messaging
pod 'Firebase/Database' Realtime Database
pod 'Firebase/Invites' Invites
pod 'Firebase/DynamicLinks' Dynamic Links
pod 'Firebase/Crash' Crash Reporting
pod 'Firebase/RemoteConfig' Configuração Remota
pod 'Firebase/Auth' Authentication
pod 'Firebase/Storage' Storage
pod 'Firebase/Performance' Monitoramento de desempenho
pod 'Firebase/Firestore' Cloud Firestore
pod 'Firebase/Functions' SDK de cliente do Cloud Functions para Firebase
pod "Firebase/MLVision" APIs de kit de aprendizado de máquina (visão)
pod "Firebase/MLVisionLabelModel" Kit de aprendizado de máquina (detecção de rótulos no dispositivo)
pod "Firebase/MLVisionBarcodeModel" Kit de aprendizado de máquina (leitura de código de barras no dispositivo)
pod "Firebase/MLVisionTextModel" Kit de aprendizado de máquina (reconhecimento de texto no dispositivo)
pod "Firebase/MLVisionFaceModel" Kit de aprendizado de máquina (detecção de rosto no dispositivo)

Integração sem CocoaPods

Se não quiser usar o CocoaPods, você ainda pode aproveitar os SDKs do Firebase importando as bibliotecas diretamente.

  1. Faça o download do arquivo de SDK de biblioteca compactado. Este arquivo tem cerca de 500 MB e o download pode demorar.
  2. Descompacte e leia o arquivo README para saber quais bibliotecas incluir no projeto.
  3. Adicione a sinalização de vinculador ObjC a Other Linker Settings nas configurações de criação de destino.

Próximas etapas

Saiba mais sobre o Firebase:

Adicione recursos do Firebase ao seu app:

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.