Gerenciador de pacotes Swift
O Firebase recomenda o Swift Package Manager para novos projetos.
Através do Xcode
O suporte do Swift Package Manager requer 14.1 ou superior.
Se estiver migrando de um projeto baseado em CocoaPods, execute
pod deintegrate
para remover CocoaPods do seu projeto Xcode. O arquivo.xcworkspace
gerado pelo CocoaPods pode ser excluído com segurança posteriormente. Se você estiver adicionando o Firebase a um projeto pela primeira vez, esta etapa poderá ser ignorada.No Xcode, instale as bibliotecas Firebase navegando até Arquivo > Adicionar Pacotes
No prompt exibido, selecione o repositório GitHub do Firebase:
https://github.com/firebase/firebase-ios-sdk.git
Selecione a versão do Firebase que deseja usar. Para novos projetos, recomendamos usar a versão mais recente do Firebase.
Escolha as bibliotecas do Firebase que você deseja incluir no seu aplicativo.
Quando terminar, o Xcode começará a resolver as dependências do seu pacote e baixá-los em segundo plano.
Através do Package.swift
Para integrar o Firebase a um pacote Swift por meio de um manifesto Package.swift
, você pode adicionar o Firebase à matriz dependencies
do seu pacote. Para obter mais detalhes, consulte a documentação do Swift Package Manager .
dependencies: [
.package(name: "Firebase",
url: "https://github.com/firebase/firebase-ios-sdk.git",
from: "8.0"),
// ...
],
Em seguida, em qualquer destino que dependa de um produto Firebase, adicione-o à matriz de dependencies
desse destino.
.target(
name: "MyTargetName",
dependencies: [
.product(name: "FirebaseAuth", package: "Firebase"),
// ...
]
),
Considerações específicas do produto
Alguns produtos do Firebase exigem etapas extras de integração para funcionar corretamente.
Google Analytics
O Google Analytics requer a adição do sinalizador do vinculador -ObjC
às configurações de compilação do seu destino, se incluído transitivamente.
Crashlytics
O Crashlytics exige que você carregue símbolos de depuração.
Você pode usar uma fase de construção de script de execução para o Xcode para carregar automaticamente símbolos de depuração pós-construção. Encontre o script de execução aqui:
${BUILD_DIR%Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run
Outra opção para fazer upload de símbolos é usar o script upload-symbols
. Coloque o script em um subdiretório do arquivo do seu projeto (por exemplo scripts/upload-symbols
) e certifique-se de que o script seja executável:
chmod +x scripts/upload-symbols
Este script pode ser usado para fazer upload manualmente de arquivos dSYM. Para notas de uso e instruções adicionais para o script, execute upload-symbols
sem nenhum parâmetro.
CocoaPods
O Firebase oferece suporte à instalação com CocoaPods , além do Swift Package Manager.
A distribuição CocoaPods do Firebase requer Xcode 14.1 e CocoaPods 1.12.0 ou superior. Veja como instalar o Firebase usando CocoaPods:
Crie um Podfile se ainda não tiver um. Na raiz do diretório do seu projeto, execute o seguinte comando:
pod init
Ao seu Podfile, adicione os pods do Firebase que você deseja usar no seu aplicativo.
Você pode adicionar qualquer um dos produtos compatíveis do Firebase ao seu aplicativo.
# Add the Firebase pod for Google Analytics
pod 'FirebaseAnalytics'
# For Analytics without IDFA collection capability, use this pod instead
# pod ‘Firebase/AnalyticsWithoutAdIdSupport’
# Add the pods for any other Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'FirebaseAuth'
pod 'FirebaseFirestore'Saiba mais sobre o IDFA, o identificador de publicidade no nível do dispositivo, na documentação da Apple sobre privacidade do usuário e uso de dados e transparência no rastreamento de aplicativos .
# Add the pods for the Firebase products you want to use in your app
# For example, to use Firebase Authentication and Cloud Firestore
pod 'FirebaseAuth'
pod 'FirebaseFirestore'Instale os pods e abra seu arquivo
.xcworkspace
para ver o projeto no Xcode:pod install --repo-update
open
your-project .xcworkspace
Considerações específicas do produto
Alguns produtos do Firebase exigem etapas extras de integração para funcionar corretamente.
Crashlytics
O Crashlytics exige que você carregue símbolos de depuração.
Você pode usar uma fase de construção de script de execução para o Xcode para carregar automaticamente símbolos de depuração pós-construção. Encontre o script de execução aqui:
"${PODS_ROOT}/FirebaseCrashlytics/run"
Cartago
O apoio de Cartago é experimental. Consulte as instruções no GitHub para incluir o Firebase em seu aplicativo via Carthage.
Integrar manualmente
O Firebase fornece uma distribuição binária XCFramework pré-construída para usuários que desejam integrar o Firebase sem usar um gerenciador de dependências. Para instalar o Firebase:
Baixe o zip do SDK da estrutura . Este arquivo contém fatias de arquitetura para todas as arquiteturas de destino disponíveis para todos os SDKs do Firebase e, portanto, pode levar algum tempo para ser baixado.
Descompacte o arquivo e revise o
README
das estruturas que você deseja incluir em seu aplicativo.Adicione o sinalizador do vinculador
-ObjC
emOther Linker Settings
nas configurações de compilação do seu destino.