Pré-requisitos
Instalar o seguinte:
- Xcode 15.2 ou versões mais recentes
Verifique se o projeto atende a estes requisitos:
- O projeto precisa ser direcionado a estas versões da plataforma ou versões mais recentes:
- iOS 13
- macOS 10.15
- tvOS 13
- watchOS 7
- O projeto precisa ser direcionado a estas versões da plataforma ou versões mais recentes:
Configure um dispositivo físico da Apple ou use um simulador para executar seu app.
Quer usar o Cloud Messaging?
Para o Cloud Messaging em plataformas da Apple, confira os pré-requisitos:
- Configure um dispositivo físico da Apple.
- Consiga uma chave de autenticação de notificação push da Apple para sua conta do Apple Developer.
- Ative as notificações push no Xcode em App > Capabilities.
- Faça login no Firebase usando sua Conta do Google.
Se você ainda não tem um projeto do Xcode e quer testar um produto do Firebase, faça o download de uma das nossas amostras introdutórias.
Etapa 1: criar um projeto do Firebase
Antes de adicionar o Firebase ao seu app da Apple, crie um projeto do Firebase para conectá-lo ao seu aplicativo. Acesse Noções básicas sobre projetos do Firebase para saber mais.
Criar um projeto do Firebase
-
No console do Firebase, clique em Adicionar projeto.
-
Para adicionar recursos do Firebase a um projeto do Google Cloud existente, digite o nome dele ou selecione-o no menu suspenso.
-
Para criar um novo projeto, digite o nome dele. Também é possível editar o ID do projeto exibido abaixo do nome dele.
-
-
Se solicitado, leia e aceite os Termos do Firebase.
-
Clique em Continuar.
-
(Opcional) Configure o Google Analytics para o projeto e tenha uma experiência ideal quando usar qualquer um destes produtos do Firebase:
Selecione uma conta do Google Analytics ou crie uma nova.
Se você criar uma nova conta, selecione seu local do relatório do Analytics e aceite as configurações de compartilhamento de dados e os termos do Google Analytics no projeto.
-
Clique em Criar projeto ou Adicionar Firebase se você estiver usando um projeto do Google Cloud.
O Firebase provisiona recursos automaticamente para seu projeto. Quando o processo for concluído, vamos direcionar você para a página de visão geral do seu projeto no console do Firebase.
Etapa 2: registrar seu app com o Firebase
Para usar o Firebase no seu app Apple, é necessário registrá-lo no projeto do Firebase. Registrar o app também quer dizer "adicionar" o app ao 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 app ao seu projeto do Firebase, clique em Adicionar app para exibir as opções da plataforma.
Insira o ID do pacote do seu app no campo ID do pacote.
O que é um ID do pacote e onde ele pode ser encontrado?
Um ID do pacote identifica exclusivamente um aplicativo no ecossistema da Apple.
Encontre o ID do pacote: abra o projeto no Xcode, selecione o app na parte superior do navegador do projeto e escolha a guia Geral.
O valor do campo Identificador do pacote é o ID do pacote (por exemplo,
com.yourcompany.yourproject
).Saiba que o valor do ID do pacote diferencia maiúsculas de minúsculas e não pode ser alterado no app do Firebase depois de ser registrado no projeto.
(Opcional) Insira outras informações do aplicativo: apelido do aplicativo e ID da App Store.
Como o apelido do app e o ID da App Store são usados no Firebase?
Apelido do app: um prático identificador interno que só é visível para você no Console do Firebase.
ID da app store: usado por Firebase Dynamic Links para redirecionar os usuários para sua página da App Store e por Google Analytics para importar eventos de conversão para Google Ads Caso seu app ainda não tenha um ID da App Store, adicione o ID posteriormente nas suas configurações do projeto.
Clique em Register app.
Etapa 3: adicionar um arquivo de configuração do Firebase
Clique em Fazer o download do GoogleService-Info.plist para solicitar o arquivo de configuração das plataformas Apple do Firebase (
GoogleService-Info.plist
).O que é preciso saber sobre esse 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, acesse Noções básicas sobre projetos do Firebase.
É possível fazer o download do arquivo de configuração do Firebase novamente a qualquer momento.
Verifique se outros caracteres, como
(2)
, não foram adicionados ao final do nome do arquivo de configuração.
Mova o arquivo de configuração para a raiz do seu projeto XCode. Se solicitado, selecione a opção para adicionar o arquivo de configuração a todos os destinos.
Se o projeto tiver vários IDs de pacotes, associe cada ID com um app registrado no Console do Firebase para que tenha o próprio arquivo GoogleService-Info.plist
.
Etapa 4: adicionar SDKs do Firebase ao seu app
Use o Swift Package Manager para instalar e gerenciar as dependências do Firebase.
- No Xcode, com seu projeto do app aberto, navegue até File > Add Packages.
- Quando solicitado, adicione o repositório do SDK do Firebase para as plataformas da Apple:
- Selecione a versão do SDK que você quer usar.
Escolha as bibliotecas do Firebase que você quer usar.
Se o Google Analytics estiver ativado no seu projeto do Firebase, adicione
FirebaseAnalytics
. Para o Analytics sem o recurso de coleção de IDFAs, adicioneFirebaseAnalyticsWithoutAdId
em vez da outra opção.
https://github.com/firebase/firebase-ios-sdk
Quando terminar, o Xcode começará a resolver e fazer o download das dependências em segundo plano automaticamente.
Etapa 5: 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ê estiver usando um projeto de amostra do guia de início rápido, isso já foi feito.
- Importe o módulo
FirebaseCore
noUIApplicationDelegate
, assim como qualquer outro módulo do Firebase usado pelo delegado do app. Por exemplo, para usar Cloud Firestore, Authentication e:import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configure uma
instância compartilhada do
FirebaseApp
no métodoapplication(_:didFinishLaunchingWithOptions:)
do delegado do app:// Use Firebase library to configure APIs FirebaseApp.configure()
// Use Firebase library to configure APIs FirebaseApp.configure()
// Use Firebase library to configure APIs [FIRApp configure];
- Se você estiver usando a SwiftUI, crie um delegado do aplicativo e o anexe
ao struct
App
viaUIApplicationDelegateAdaptor
ouNSApplicationDelegateAdaptor
. Também é necessário desativar o swizzling do delegado do app. Para mais informações, consulte as instruções da 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, poderá executar seu app para enviar a verificação ao console do Firebase informando que a instalação foi um sucesso.
Pronto. Pule para as próximas etapas.
Se você estiver com problemas para definir a configuração, acesse a Solução de problemas e perguntas frequentes sobre as plataformas da Apple.
Bibliotecas disponíveis
Nesta seção, listamos os produtos do Firebase compatíveis com as plataformas da Apple. Saiba mais sobre estas bibliotecas da plataforma Apple do Firebase:
Repositório do GitHub do SDK do Firebase para as plataformas Apple
Serviço ou produto | Pods | Bibliotecas do SwiftPM | Google Analytics.">Adicionar Analytics? |
---|---|---|---|
AdMob | pod 'Google-Mobile-Ads-SDK' |
N/A | |
Analytics | pod 'FirebaseAnalytics' |
FirebaseAnalytics |
|
App Check | pod 'FirebaseAppCheck' |
FirebaseAppCheck |
|
App Distribution | pod 'FirebaseAppDistribution' |
FirebaseAppDistribution |
|
Authentication | pod 'FirebaseAuth' |
FirebaseAuth |
|
Cloud Firestore | pod 'FirebaseFirestore' |
FirebaseFirestore |
|
Cloud Functions for Firebase Client SDK | pod 'FirebaseFunctions' |
FirebaseFunctions |
|
Cloud Messaging | pod 'FirebaseMessaging' |
FirebaseMessaging |
|
Cloud Storage | pod 'FirebaseStorage' |
FirebaseStorage |
|
Crashlytics | pod 'FirebaseCrashlytics' |
FirebaseCrashlytics |
|
Dynamic Links | pod 'FirebaseDynamicLinks' |
FirebaseDynamicLinks |
|
In-App Messaging | pod 'FirebaseInAppMessaging' |
FirebaseInAppMessaging |
(obrigatório) |
Firebase Instalações | pod 'FirebaseInstallations' |
FirebaseInstallations |
|
Firebase ML APIs de modelo personalizado | pod 'FirebaseMLModelDownloader' |
FirebaseMLModelDownloader |
|
Performance Monitoring | pod 'FirebasePerformance' |
FirebasePerformance |
|
Realtime Database | pod 'FirebaseDatabase' |
FirebaseDatabase |
|
Remote Config | pod 'FirebaseRemoteConfig' |
FirebaseRemoteConfig |
|
Vertex AI in Firebase | pod 'FirebaseVertexAI' |
FirebaseVertexAI |
Integração sem usar o Gerenciador de pacotes do Swift
Se você não quiser usar o Gerenciador de pacotes do Swift, ainda vai poder aproveitar os SDKs do Firebase com o CocoaPods ou importando os frameworks diretamente.
CocoaPods
Para mais detalhes sobre a integração do CocoaPods, consulte nosso guia.
Frameworks
Além de oferecer suporte para a plataforma iOS, o zip agora inclui arquivos .xcframework
. Para detalhes, consulte no GitHub o arquivo
README do SDK do Firebase para as plataformas
da Apple (em inglês).
Faça o download do arquivo zip com o SDK do framework. Esse arquivo tem aproximadamente 200 MB e o download pode levar algum tempo.
Descompacte o arquivo e integre os frameworks que você quer incluir no app.
As instruções de integração podem ser encontradas em um dos seguintes locais:
- No repositório do GitHub do SDK do Firebase para iOS.
- No arquivo
README.md
da distribuição zip que você fez o download.
Para informações sobre versões ou dependências do framework, consulte o arquivo
METADATA.md
na distribuição zip que você fez o download.Adicione a flag
-ObjC
do vinculador aOther Linker Settings
nas configurações do build do destino.
Próximas etapas
Saiba mais sobre o Firebase:
Para ver projetos do Firebase e práticas recomendadas, consulte Noções básicas sobre projetos do Firebase.
Conheça os aplicativos de amostra do Firebase.
Aprenda a usar o Firebase iOS Codelab na prática.
Confira o código aberto no GitHub (em inglês).
Prepare-se para lançar seu aplicativo:
- Configure os alertas de orçamento para seu projeto no console Google Cloud.
- Monitore o painel Uso e faturamento no console do Firebase para ter uma visão geral do uso do projeto em vários serviços do Firebase.
- Consulte a lista de verificação de lançamento do Firebase.
Problemas com o Firebase e o seu projeto da Apple? Acesse a página de solução de problemas e perguntas frequentes sobre as plataformas da Apple.
Adicione serviços do Firebase ao seu app:
Receba insights sobre o comportamento dos usuários com o Analytics.
Configure a autenticação do usuário com o Authentication.
Armazene dados, como informações do usuário, usando o Cloud Firestore ou o Realtime Database.
Armazene arquivos, como fotos e vídeos, usando Cloud Storage.
Acione o código de back-end que é executado em um ambiente seguro com o Cloud Functions.
Envie notificações com Cloud Messaging.
Use o Crashlytics e descubra quando e por que seu app apresenta falhas.