Adicione o Firebase ao seu projeto da Apple

Pré-requisitos

• Instale o seguinte:

  • Xcode 13.3.1 ou posterior

• Certifique-se de que seu projeto atenda a estes requisitos:

  • Seu projeto deve ser direcionado a estas versões de plataforma ou posteriores:
    • iOS 11
    • macOS 10.13
    • tvOS 12
    • watchOS 6

• Configure um dispositivo Apple físico ou use um simulador para executar seu aplicativo.

  Deseja usar o Cloud Messaging?

  Para Cloud Messaging em plataformas Apple, aqui estão os pré-requisitos:

  • Configure um dispositivo Apple físico .
  • Obtenha uma chave de autenticação de notificação por push da Apple para sua conta de desenvolvedor da Apple .
  • Ative as notificações por push no Xcode em App > Capabilities .

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

Se você ainda não tem um projeto Xcode e deseja apenas experimentar um produto Firebase, pode fazer o download de um de nossos exemplos de início rápido .

Etapa 1 : criar um projeto do Firebase

Antes de adicionar o Firebase ao seu aplicativo Apple, você precisa criar um projeto do Firebase para se conectar ao seu aplicativo. Acesse Entenda os projetos do Firebase para saber mais sobre os projetos do Firebase.

Etapa 2 : registre seu aplicativo no Firebase

Para usar o Firebase em seu aplicativo Apple, você precisa registrar seu aplicativo com seu projeto Firebase. Registrar seu aplicativo geralmente é chamado de "adicionar" seu aplicativo ao seu projeto.

1. Acesse o console do Firebase .

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

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

3. Digite o ID do pacote do seu aplicativo no campo ID do pacote .

   O que é um ID de pacote e onde encontrá-lo?

   • Um ID de pacote identifica exclusivamente um aplicativo no ecossistema da Apple.

   • Encontre o ID do seu pacote: abra seu projeto no Xcode, selecione o aplicativo de nível superior no navegador do projeto e selecione a guia Geral .

     O valor do campo Bundle Identifier é o ID do pacote (por exemplo, com.yourcompany.yourproject ).

   • Esteja ciente de que o valor do ID do pacote diferencia maiúsculas de minúsculas e não pode ser alterado para este aplicativo Firebase depois de registrado com seu projeto Firebase.

4. (Opcional) Insira outras informações do aplicativo: Apelido do aplicativo e ID da App Store .

   Como o apelido do aplicativo e o ID da App Store são usados ​​no Firebase?

   • Apelido do aplicativo : um identificador de conveniência interno que só é visível para você no console do Firebase

   • ID da App Store : usado pelo Firebase Dynamic Links para redirecionar os usuários para sua página da App Store e pelo Google Analytics para importar eventos de conversão para o Google Ads . Se seu aplicativo ainda não tiver um ID da App Store, você poderá adicionar o ID mais tarde nas configurações do seu projeto .

5. Clique em Registrar aplicativo .

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

1. Clique em Baixar GoogleService-Info.plist para obter o arquivo de configuração das plataformas Firebase Apple ( GoogleService-Info.plist ).

   O que você precisa saber sobre este arquivo de configuração?

   • O arquivo de configuração do Firebase contém identificadores exclusivos, mas não secretos, para seu projeto. Para saber mais sobre esse arquivo de configuração, visite Entenda os projetos do Firebase .

   • Você pode baixar o arquivo de configuração do Firebase novamente a qualquer momento.

   • Certifique-se de que o nome do arquivo de configuração não contenha caracteres adicionais, como (2) .

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

Se você tiver vários IDs de pacote em seu projeto, deverá associar cada ID de pacote a um aplicativo registrado no Firebase console para que cada aplicativo possa ter seu próprio arquivo GoogleService-Info.plist .

Etapa 4 : adicionar SDKs do Firebase ao seu aplicativo

Use o Swift Package Manager para instalar e gerenciar dependências do Firebase.

1. No Xcode, com seu projeto de aplicativo aberto, navegue até File > Add Packages .
2. Quando solicitado, adicione o repositório Firebase Apple Platform SDK:

  https://github.com/firebase/firebase-ios-sdk

3. Selecione a versão do SDK que deseja usar.

4. Escolha as bibliotecas do Firebase que você deseja usar.

   Se o Google Analytics estiver ativado em seu projeto Firebase, certifique-se de adicionar FirebaseAnalytics . Para Analytics sem capacidade de coleta de IDFA, adicione FirebaseAnalyticsWithoutAdId .

Quando terminar, o Xcode começará automaticamente a resolver e baixar suas dependências em segundo plano.

Etapa 5 : inicializar o Firebase em seu aplicativo

A etapa final é adicionar o código de inicialização ao seu aplicativo. Você já deve ter feito isso ao adicionar o Firebase ao seu aplicativo. Se estiver usando um projeto de amostra de início rápido , isso foi feito para você.

1. Importe o módulo FirebaseCore em seu UIApplicationDelegate , bem como quaisquer outros módulos Firebase usados ​​pelo delegado do aplicativo. Por exemplo, para usar Cloud Firestore e autenticação:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Rápido

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Configure uma instância compartilhada do FirebaseApp no ​​método application(_:didFinishLaunchingWithOptions:) do delegado do seu aplicativo:

   SwiftUI

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

   Rápido

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

   Objective-C

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

3. Se você estiver usando SwiftUI, deverá criar um delegado de aplicativo e anexá-lo à sua estrutura de App por meio de UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor . Você também deve desativar o swizzling de delegado de aplicativo. Para obter mais informações, consulte as instruções do SwiftUI .

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. Se você incluiu o SDK do Firebase para Google Analytics, pode executar seu aplicativo para enviar ao console do Firebase a verificação de que você instalou o Firebase com sucesso.

É isso! Você pode pular para as próximas etapas .

No entanto, se você estiver com problemas para configurar, visite a solução de problemas e perguntas frequentes sobre plataformas da Apple .

Bibliotecas disponíveis

Esta seção lista os produtos Firebase compatíveis com plataformas Apple. Saiba mais sobre essas bibliotecas da plataforma Firebase Apple:

• Documentação de referência ( Swift | Obj-C )

• Repositório do GitHub do SDK das plataformas da Apple do Firebase

Integre sem usar o Swift Package Manager

Se você não quiser usar o Swift Package Manager, ainda pode aproveitar os Firebase SDKs usando CocoaPods ou importando os frameworks diretamente.

CocoaPods

Saiba mais sobre a integração do CocoaPods em nosso guia .

Estruturas

Além de suportar a plataforma iOS, o zip agora inclui arquivos .xcframework . Para obter detalhes, consulte o README do SDK das plataformas Firebase Apple no GitHub .

1. Faça o download do SDK do framework zip . Este é um arquivo de aproximadamente 200 MB e pode levar algum tempo para ser baixado.

2. Descompacte o arquivo e revise o README para as estruturas que deseja incluir em seu aplicativo.

3. Adicione o sinalizador de vinculador -ObjC em suas Other Linker Settings de compilação do seu destino.

Próximos passos

Conheça o Firebase:

• Acesse Entenda os projetos do Firebase para saber mais sobre os projetos do Firebase e as práticas recomendadas para projetos.

• Explore exemplos de aplicativos do Firebase .

• Obtenha experiência prática com o Firebase iOS Codelab .

• Explore o código-fonte aberto no GitHub .

• Prepare-se para lançar seu aplicativo:

  • Configure alertas de orçamento para seu projeto no Console do Google Cloud.
  • Monitore o painel de uso e cobrança no console do Firebase para obter uma visão geral do uso do seu projeto em vários serviços do Firebase.
  • Revise a lista de verificação de lançamento do Firebase .

• Está tendo problemas com o Firebase e seu projeto da Apple? Visite a solução de problemas e perguntas frequentes sobre as plataformas Apple .

Adicione serviços do Firebase ao seu aplicativo:

• Obtenha informações sobre o comportamento do usuário com o Analytics .

• Configure a autenticação do usuário com Authentication .

• Armazene dados, como informações do usuário, com Cloud Firestore ou Realtime Database .

• Armazene arquivos, como fotos e vídeos, com Cloud Storage .

• Acione o código de back-end executado em um ambiente seguro com o Cloud Functions .

• Envie notificações com Cloud Messaging .

• Descubra quando e por que seu aplicativo está travando com o Crashlytics .

Pré-requisitos

• Instale o seguinte:

  • Xcode 13.3.1 ou posterior

• Certifique-se de que seu projeto atenda a estes requisitos:

  • Seu projeto deve ser direcionado a estas versões de plataforma ou posteriores:
    • iOS 11
    • macOS 10.13
    • tvOS 12
    • watchOS 6

• Configure um dispositivo Apple físico ou use um simulador para executar seu aplicativo.

  Deseja usar o Cloud Messaging?

  Para Cloud Messaging em plataformas Apple, aqui estão os pré-requisitos:

  • Configure um dispositivo Apple físico .
  • Obtenha uma chave de autenticação de notificação por push da Apple para sua conta de desenvolvedor da Apple .
  • Ative as notificações por push no Xcode em App > Capabilities .

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

Se você ainda não tem um projeto Xcode e deseja apenas experimentar um produto Firebase, pode fazer o download de um de nossos exemplos de início rápido .

Etapa 1 : criar um projeto do Firebase

Antes de adicionar o Firebase ao seu aplicativo Apple, você precisa criar um projeto do Firebase para se conectar ao seu aplicativo. Acesse Entenda os projetos do Firebase para saber mais sobre os projetos do Firebase.

Etapa 2 : registre seu aplicativo no Firebase

Para usar o Firebase em seu aplicativo Apple, você precisa registrar seu aplicativo com seu projeto Firebase. Registrar seu aplicativo geralmente é chamado de "adicionar" seu aplicativo ao seu projeto.

1. Acesse o console do Firebase .

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

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

3. Digite o ID do pacote do seu aplicativo no campo ID do pacote .

   O que é um ID de pacote e onde encontrá-lo?

   • Um ID de pacote identifica exclusivamente um aplicativo no ecossistema da Apple.

   • Encontre o ID do seu pacote: abra seu projeto no Xcode, selecione o aplicativo de nível superior no navegador do projeto e selecione a guia Geral .

     O valor do campo Bundle Identifier é o ID do pacote (por exemplo, com.yourcompany.yourproject ).

   • Esteja ciente de que o valor do ID do pacote diferencia maiúsculas de minúsculas e não pode ser alterado para este aplicativo do Firebase depois de registrado com seu projeto do Firebase.

4. (Opcional) Insira outras informações do aplicativo: Apelido do aplicativo e ID da App Store .

   Como o apelido do aplicativo e o ID da App Store são usados ​​no Firebase?

   • Apelido do aplicativo : um identificador de conveniência interno que só é visível para você no console do Firebase

   • ID da App Store : usado pelo Firebase Dynamic Links para redirecionar os usuários para sua página da App Store e pelo Google Analytics para importar eventos de conversão para o Google Ads . Se seu aplicativo ainda não tiver um ID da App Store, você poderá adicionar o ID mais tarde nas configurações do seu projeto .

5. Clique em Registrar aplicativo .

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

1. Clique em Baixar GoogleService-Info.plist para obter o arquivo de configuração das plataformas Firebase Apple ( GoogleService-Info.plist ).

   O que você precisa saber sobre este arquivo de configuração?

   • O arquivo de configuração do Firebase contém identificadores exclusivos, mas não secretos, para seu projeto. Para saber mais sobre esse arquivo de configuração, visite Entenda os projetos do Firebase .

   • Você pode baixar o arquivo de configuração do Firebase novamente a qualquer momento.

   • Certifique-se de que o nome do arquivo de configuração não contenha caracteres adicionais, como (2) .

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

Se você tiver vários IDs de pacote em seu projeto, deverá associar cada ID de pacote a um aplicativo registrado no Firebase console para que cada aplicativo possa ter seu próprio arquivo GoogleService-Info.plist .

Etapa 4 : adicionar SDKs do Firebase ao seu aplicativo

Use o Swift Package Manager para instalar e gerenciar dependências do Firebase.

1. No Xcode, com seu projeto de aplicativo aberto, navegue até File > Add Packages .
2. Quando solicitado, adicione o repositório Firebase Apple Platform SDK:

  https://github.com/firebase/firebase-ios-sdk

3. Selecione a versão do SDK que deseja usar.

4. Escolha as bibliotecas do Firebase que você deseja usar.

   Se o Google Analytics estiver ativado em seu projeto Firebase, certifique-se de adicionar FirebaseAnalytics . Para Analytics sem capacidade de coleta de IDFA, adicione FirebaseAnalyticsWithoutAdId .

Quando terminar, o Xcode começará automaticamente a resolver e baixar suas dependências em segundo plano.

Etapa 5 : inicializar o Firebase em seu aplicativo

A etapa final é adicionar o código de inicialização ao seu aplicativo. Você já deve ter feito isso ao adicionar o Firebase ao seu aplicativo. Se estiver usando um projeto de amostra de início rápido , isso foi feito para você.

1. Importe o módulo FirebaseCore em seu UIApplicationDelegate , bem como quaisquer outros módulos Firebase usados ​​pelo delegado do aplicativo. Por exemplo, para usar Cloud Firestore e autenticação:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Rápido

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Configure uma instância compartilhada do FirebaseApp no ​​método application(_:didFinishLaunchingWithOptions:) do delegado do seu aplicativo:

   SwiftUI

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

   Rápido

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

   Objective-C

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

3. Se você estiver usando SwiftUI, deverá criar um delegado de aplicativo e anexá-lo à sua estrutura de App por meio de UIApplicationDelegateAdaptor ou NSApplicationDelegateAdaptor . Você também deve desativar o swizzling de delegado de aplicativo. Para obter mais informações, consulte as instruções do SwiftUI .

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

4. Se você incluiu o SDK do Firebase para Google Analytics, pode executar seu aplicativo para enviar ao console do Firebase a confirmação de que instalou o Firebase com sucesso.

É isso! Você pode pular para as próximas etapas .

No entanto, se você estiver com problemas para configurar, visite a solução de problemas e perguntas frequentes sobre plataformas da Apple .

Bibliotecas disponíveis

Esta seção lista os produtos Firebase compatíveis com plataformas Apple. Saiba mais sobre essas bibliotecas da plataforma Firebase Apple:

• Documentação de referência ( Swift | Obj-C )

• Repositório do GitHub do SDK das plataformas da Apple do Firebase

Integre sem usar o Swift Package Manager

Se você não quiser usar o Swift Package Manager, ainda pode aproveitar os Firebase SDKs usando CocoaPods ou importando os frameworks diretamente.

CocoaPods

Saiba mais sobre a integração do CocoaPods em nosso guia .

Estruturas

Além de suportar a plataforma iOS, o zip agora inclui arquivos .xcframework . Para obter detalhes, consulte o README do SDK das plataformas Firebase Apple no GitHub .

1. Faça o download do SDK do framework zip . Este é um arquivo de aproximadamente 200 MB e pode levar algum tempo para ser baixado.

2. Descompacte o arquivo e revise o README para as estruturas que deseja incluir em seu aplicativo.

3. Adicione o sinalizador de vinculador -ObjC em suas Other Linker Settings de compilação do seu destino.

Próximos passos

Conheça o Firebase:

• Acesse Entenda os projetos do Firebase para saber mais sobre os projetos do Firebase e as práticas recomendadas para projetos.

• Explore exemplos de aplicativos do Firebase .

• Obtenha experiência prática com o Firebase iOS Codelab .

• Explore o código-fonte aberto no GitHub .

• Prepare-se para lançar seu aplicativo:

  • Configure alertas de orçamento para seu projeto no Console do Google Cloud.
  • Monitore o painel de uso e faturamento no console do Firebase para obter uma visão geral do uso do seu projeto em vários serviços do Firebase.
  • Revise a lista de verificação de lançamento do Firebase .

• Está tendo problemas com o Firebase e seu projeto da Apple? Visite a solução de problemas e perguntas frequentes sobre as plataformas Apple .

Adicione serviços do Firebase ao seu aplicativo:

• Obtenha informações sobre o comportamento do usuário com o Analytics .

• Configure a autenticação do usuário com Authentication .

• Armazene dados, como informações do usuário, com Cloud Firestore ou Realtime Database .

• Armazene arquivos, como fotos e vídeos, com Cloud Storage .

• Acione o código de back-end executado em um ambiente seguro com o Cloud Functions .

• Envie notificações com Cloud Messaging .

• Descubra quando e por que seu aplicativo está travando com o Crashlytics .