Adicionar o Firebase ao seu projeto do iOS

Pré-requisitos

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

  • Xcode
    • 7.0 ou posterior para Objective-C
    • 8.0 ou posterior para Swift
  • um projeto do Xcode segmentado para iOS 7 ou posterior
  • para projetos Swift, Swift 3.0 ou posterior
  • o identificador de pacote do seu app
  • CocoaPods 1.0.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, pegue 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. Se você ainda não tem um projeto, crie um no Firebase console. Clique em Importar projeto do Google se você já tem um desses projetos associados ao seu app para dispositivos móveis. Caso contrário, clique em Criar novo projeto.
  2. Clique em Adicionar o Firebase ao seu app iOS e siga as etapas de configuração. Se você está importando um projeto do Google, isso pode ocorrer automaticamente. Basta fazer o download do arquivo de configuração.
  3. Quando solicitado, informe o código de pacote do seu app. Esta é uma configuração importante que só pode ser feita no momento da adição de um app ao seu projeto do Firebase.
  4. Para terminar, você fará o download de um arquivo GoogleService-Info.plist. Você pode fazer o download deste arquivo novamente a qualquer momento.
  5. Se você ainda não fez isso, copie o arquivo na raiz do seu projeto do Xcode.

Adicionar o SDK

Se você estiver configurando um novo projeto, é necessário instalar o SDK. Talvez você tenha feito isso durante a criação de um 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, siga estas instruções e integre as bibliotecas do SDK diretamente.

Se você fizer o download e executar uma das amostras de início rápido, o projeto do Xcode e o Podfile já estarão adicionados, mas você ainda precisará instalar os conjuntos e fazer o download do arquivo GoogleService-Info.plist. Se você quiser integrar as bibliotecas do Firebase a um dos seus projetos, instale os conjuntos 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 conjuntos que deseja instalar. Você pode incluir um pod no 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 app 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 conjuntos 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 do Firebase console e inclua o arquivo 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ê usa um início rápido, isso já foi feito para você.

  1. Importe o módulo do Firebase na subclasse UIApplicationDelegate:

    Swift

    import Firebase
    

    Objective-C

    @import Firebase;
    
  2. Configure uma instância compartilhada 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

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 seu projeto.
  3. Adicione a sinalização de vinculador ObjC em Other Linker Settings nas configurações de criação do 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.