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
- Seu projeto deve ser direcionado a estas versões de plataforma ou posteriores:
Configure um dispositivo Apple físico ou use um simulador para executar seu aplicativo.
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.
Acesse o console do Firebase .
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.
Digite o ID do pacote do seu aplicativo no campo ID do pacote .
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.
(Opcional) Insira outras informações do aplicativo: Apelido do aplicativo e ID da App Store .
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 .
Clique em Registrar aplicativo .
Etapa 3 : adicionar um arquivo de configuração do Firebase
Clique em Baixar GoogleService-Info.plist para obter o arquivo de configuração das plataformas Firebase Apple (
GoogleService-Info.plist
).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)
.
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.
- No Xcode, com seu projeto de aplicativo aberto, navegue até File > Add Packages .
- Quando solicitado, adicione o repositório Firebase Apple Platform SDK:
- Selecione a versão do SDK que deseja usar.
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, adicioneFirebaseAnalyticsWithoutAdId
.
https://github.com/firebase/firebase-ios-sdk
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ê.
- Importe o módulo
FirebaseCore
em seuUIApplicationDelegate
, 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; // ...
- Configure uma instância compartilhada do
FirebaseApp
no métodoapplication(_: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];
- Se você estiver usando SwiftUI, deverá criar um delegado de aplicativo e anexá-lo à sua estrutura de
App
por meio deUIApplicationDelegateAdaptor
ouNSApplicationDelegateAdaptor
. 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() } } } }
- 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:
Repositório do GitHub do SDK das plataformas da Apple do Firebase
Serviço ou Produto | cápsulas | Bibliotecas SwiftPM | Adicionar análises? |
---|---|---|---|
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 .
Faça o download do SDK do framework zip . Este é um arquivo de aproximadamente 200 MB e pode levar algum tempo para ser baixado.
Descompacte o arquivo e revise o
README
para as estruturas que deseja incluir em seu aplicativo.Adicione o sinalizador de vinculador
-ObjC
em suasOther 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
- Seu projeto deve ser direcionado a estas versões de plataforma ou posteriores:
Configure um dispositivo Apple físico ou use um simulador para executar seu aplicativo.
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.
Acesse o console do Firebase .
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.
Digite o ID do pacote do seu aplicativo no campo ID do pacote .
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.
(Opcional) Insira outras informações do aplicativo: Apelido do aplicativo e ID da App Store .
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 .
Clique em Registrar aplicativo .
Etapa 3 : adicionar um arquivo de configuração do Firebase
Clique em Baixar GoogleService-Info.plist para obter o arquivo de configuração das plataformas Firebase Apple (
GoogleService-Info.plist
).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)
.
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.
- No Xcode, com seu projeto de aplicativo aberto, navegue até File > Add Packages .
- Quando solicitado, adicione o repositório Firebase Apple Platform SDK:
- Selecione a versão do SDK que deseja usar.
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, adicioneFirebaseAnalyticsWithoutAdId
.
https://github.com/firebase/firebase-ios-sdk
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ê.
- Importe o módulo
FirebaseCore
em seuUIApplicationDelegate
, 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; // ...
- Configure uma instância compartilhada do
FirebaseApp
no métodoapplication(_: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];
- Se você estiver usando SwiftUI, deverá criar um delegado de aplicativo e anexá-lo à sua estrutura de
App
por meio deUIApplicationDelegateAdaptor
ouNSApplicationDelegateAdaptor
. 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() } } } }
- 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:
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 .
Faça o download do SDK do framework zip . Este é um arquivo de aproximadamente 200 MB e pode levar algum tempo para ser baixado.
Descompacte o arquivo e revise o
README
para as estruturas que deseja incluir em seu aplicativo.Adicione o sinalizador de vinculador
-ObjC
em suasOther 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 .