Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Adicione o Firebase ao seu projeto da Apple

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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.

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 .

  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 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:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. Selecione a versão do SDK que deseja usar.
  5. 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:

    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:

    Rápido

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

    Objective-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 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

Serviço ou Produto cápsulas Bibliotecas SwiftPM Adicionar análise?
AdMob pod 'Google-Mobile-Ads-SDK' N / D
Análise pod 'FirebaseAnalytics' FirebaseAnalytics
Verificação de aplicativo pod 'FirebaseAppCheck' FirebaseAppCheck
Distribuição de aplicativos pod 'FirebaseAppDistribution' FirebaseAppDistribution
Autenticação pod 'FirebaseAuth' FirebaseAuth
Cloud Firestore pod 'FirebaseFirestore' FirebaseFirestore
Cloud Functions para Firebase Client SDK 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 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:

Adicione serviços do Firebase ao seu aplicativo: