获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

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 ter como alvo 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.

Se você ainda não tem um projeto Xcode e quer apenas experimentar um produto Firebase, faça 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 app da Apple, você precisa criar um projeto do Firebase para se conectar ao seu app. Acesse Entender os projetos do Firebase para saber mais sobre os projetos do Firebase.

Etapa 2 : registrar seu aplicativo no Firebase

Para usar o Firebase em seu aplicativo da Apple, você precisa registrá-lo no projeto do 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 do Firebase, clique em Adicionar aplicativo para exibir as opções da plataforma.

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

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

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

  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 códigos de pacote em seu projeto, deverá associar cada código de pacote a um aplicativo registrado no console do Firebase 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 as 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 do SDK das plataformas Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Selecione a versão do SDK que você deseja usar.
  5. Escolha as bibliotecas do Firebase que você quer usar.

    Se o Google Analytics estiver ativado em seu projeto do Firebase, certifique-se de adicionar FirebaseAnalytics . Para o Analytics sem recurso 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 como parte da adição do Firebase ao seu aplicativo. Se você 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 qualquer outro módulo Firebase usado pelo delegado do aplicativo. Por exemplo, para usar o Cloud Firestore e a autenticação:

    Rápido

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objetivo-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Configure uma instância compartilhada do FirebaseApp no ​​método application(_:didFinishLaunchingWithOptions:) do representante do seu aplicativo:

    Rápido

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

    Objetivo-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. 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 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 das plataformas Apple .

Bibliotecas disponíveis

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

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

  • Repositório GitHub do SDK das plataformas Firebase Apple

Serviço ou Produto Pods Bibliotecas SwiftPM Adicionar análise?
AdMob pod 'Google-Mobile-Ads-SDK' N / D
Análise pod 'FirebaseAnalytics' FirebaseAnalytics
Verificação do aplicativo pod 'FirebaseAppCheck' FirebaseAppCheck
Distribuição de aplicativos pod 'FirebaseAppDistribution' FirebaseAppDistribution
Autenticação pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
SDK de cliente do Cloud Functions para Firebase pod 'FirebaseFunctions' FirebaseFunctions
Mensagens na nuvem pod 'FirebaseMessaging' FirebaseMessaging
Armazenamento na núvem pod 'FirebaseStorage' FirebaseStorage
Crashlytics pod 'FirebaseCrashlytics' FirebaseCrashlytics
Links dinâmicos pod 'FirebaseDynamicLinks' FirebaseDynamicLinks
Mensagens no aplicativo pod 'FirebaseInAppMessaging' FirebaseInAppMessaging
(requeridos)
Instalações do Firebase pod 'FirebaseInstallations' FirebaseInstallations
APIs de modelo personalizado do Firebase ML pod 'FirebaseMLModelDownloader' FirebaseMLModelDownloader
Monitoramento de desempenho pod 'FirebasePerformance' FirebasePerformance
Banco de dados em tempo real pod 'FirebaseDatabase' FirebaseDatabase
Configuração remota pod 'FirebaseRemoteConfig' FirebaseRemoteConfig

Integre sem usar o Swift Package Manager

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

CocoaPods

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

Estruturas

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

  1. Baixe o zip do SDK da estrutura . Este é um arquivo de ~ 200 MB e pode levar algum tempo para baixar.

  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

Saiba mais sobre o Firebase:

Adicione os serviços do Firebase ao seu aplicativo: