Ir para o console

Adicionar o Firebase ao projeto do iOS

Pré-requisitos

Antes de começar, é preciso configurar o ambiente com o seguinte:

  • Xcode 10.1 ou versões posteriores
  • Um projeto do Xcode segmentado para iOS 8 ou versões posteriores
  • 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 > Capabilities

Se você ainda não tem um projeto do Xcode e quer apenas testar um recurso do Firebase, pode fazer o download de um de nossos exemplos para início rápido. Caso use 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 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 aplicativo. Se você quiser mais informações, consulte Noções básicas sobre projetos do Firebase.

Agora que você tem um projeto, adicione seu app 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 poderá ocorrer automaticamente. Basta fazer o download do arquivo de configuração.

  2. Quando solicitado, digite o ID do pacote do app. É importante inserir essa informação ao adicionar um app ao projeto do Firebase.

  3. Adicione o arquivo de configuração do Firebase para iOS ao app:

    1. Clique em Fazer o download do GoogleService-Info.plist para receber o arquivo de configuração do Firebase para iOS (GoogleService-Info.plist).

      É possível fazer o download do arquivo de configuração do Firebase para iOS novamente a qualquer momento.

    2. Mova o arquivo de configuração para a raiz do seu projeto Xcode. Quando solicitado, selecione a opção para adicionar o arquivo de configuração a todos os destinos.

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

Consulte Noções básicas sobre projetos do Firebase para ver práticas recomendadas e informações sobre como adicionar apps a um projeto, incluindo como lidar com diversas variantes de criação.

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 do 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/Analytics'
    
    

    Esse procedimento adicionará as bibliotecas de pré-requisitos necessárias para colocar o Firebase em funcionamento no seu aplicativo para iOS, juntamente com o Google Analytics para 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 Console do Firebase 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, que é normalmente encontrada 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/Analytics' Analytics
pod 'Firebase/AdMob' AdMob
pod 'Firebase/Messaging' Cloud Messaging
pod 'Firebase/Database' Realtime Database
pod 'Firebase/DynamicLinks' Dynamic Links
pod 'Fabric'
pod 'Crashlytics'
Crashlytics
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 visão do kit de ML
pod "Firebase/MLVisionLabelModel" Modelo de rotulagem de imagens do kit de ML
pod "Firebase/MLVisionBarcodeModel" Modelo de leitura de código de barras do kit de ML
pod "Firebase/MLVisionTextModel" Modelo de reconhecimento de texto do kit de ML
pod "Firebase/MLVisionFaceModel" Modelo de detecção facial do kit de ML
pod "Firebase/MLNaturalLanguage" APIs de linguagem natural do kit de ML
pod "Firebase/MLNLLanguageID" Modelo de identificação de linguagem do kit de ML
pod "Firebase/MLNLSmartReply" Modelo de resposta inteligente do kit de ML
pod "Firebase/MLModelInterpreter" APIs de modelo personalizado do kit de ML

Integração sem o CocoaPods

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

  1. Faça o download do zip do SDK de biblioteca (é um arquivo de cerca de 1 GB e, por isso, pode levar algum tempo).
  2. Descompacte e leia o arquivo README para saber quais bibliotecas incluir no projeto.
  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: