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.2.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.

  1. Crie um projeto no Firebase console se ainda não tiver um. Se já tiver um projeto do Google associado ao seu app para dispositivos móveis, clique em Importar projeto do Google. Caso contrário, clique em Adicionar projeto.
  2. Clique em Adicionar o Firebase ao app do 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.
  3. Quando solicitado, digite o código do pacote do app. É importante inserir essa informação ao adicionar um app ao projeto do Firebase.
  4. Para terminar, você fará o download de um arquivo GoogleService-Info.plist. Você pode fazer o download desse arquivo novamente a qualquer momento.
  5. Caso ainda não tenha feito isso, adicione esse arquivo à raiz do seu projeto do Xcode usando o utilitário Adicionar arquivos no Xcode (no menu Arquivo, clique em Adicionar arquivos). Confira se o arquivo está incluído no destino da versão do aplicativo.

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. 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 uma das amostras de guia de início rápido, o projeto Xcode e o Podfile já estarão presentes, mas você ainda precisará instalar os pods e fazer o download do arquivo GoogleService-Info.plist. Se você quiser integrar as bibliotecas do Firebase a um dos seus projetos, instale os pods das bibliotecas que deseja 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 deseja 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 do FirebaseApp, geralmente 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

Integração sem CocoaPods

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

  1. Faça o download do arquivo de SDK de biblioteca em .zip. Este arquivo tem cerca de 100 MB, por isso o download dele 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.