Instalar o Firebase no seu app da Apple

Gerenciador de pacotes do Swift

O Firebase recomenda o Gerenciador de pacotes do Swift para novos projetos.

Via Xcode

Para ter suporte ao Gerenciador de Pacotes do Swift, é necessária a versão 14.1 ou mais recente.

  1. Se você estiver migrando de um projeto baseado em CocoaPods, execute pod deintegrate para remover o CocoaPods do seu projeto do Xcode. Depois disso, o arquivo .xcworkspace gerado pelo CocoaPods pode ser excluído com segurança. Se você estiver adicionando o Firebase a um projeto pela primeira vez, ignore esta etapa.

  2. No Xcode, instale as bibliotecas do Firebase acessando File > Add Packages.

  3. No prompt exibido, selecione o repositório do Firebase no GitHub:

    https://github.com/firebase/firebase-ios-sdk.git
    
  4. Selecione a versão do Firebase que você quer usar. Para novos projetos, recomendamos a versão mais recente do Firebase.

  5. Escolha as bibliotecas do Firebase que você quer incluir no seu app.

Depois disso, o Xcode vai começar a resolver as dependências do pacote e fazer o download delas em segundo plano.

Via Package.swift

Para integrar o Firebase a um pacote do Swift com um manifesto Package.swift, adicione o Firebase à matriz dependencies do pacote. Para mais detalhes, consulte a documentação do Gerenciador de pacotes do Swift.

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 do Firebase, adicione-o à matriz dependencies desse destino.

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "FirebaseAuth", package: "Firebase"),
    // ...
  ]
),

Considerações específicas de produtos

Alguns produtos do Firebase exigem etapas de integração extras para funcionar corretamente.

Google Analytics

Se for incluído transitivamente, o Google Analytics vai exigir a adição da sinalização do vinculador -ObjC às configurações do build do destino.

Crashlytics

O Crashlytics exige o upload de símbolos de depuração.

Você pode usar uma fase do build do script de execução para que o Xcode faça upload automático dos símbolos de depuração após a criaçã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 projeto (por exemplo, scripts/upload-symbols) e verifique se o script é executável:

chmod +x scripts/upload-symbols

Esse script pode ser usado para fazer upload manual de arquivos dSYM. Para observações sobre o uso e outras instruções do script, execute upload-symbols sem nenhum parâmetro.

CocoaPods

O Firebase suporta a instalação usando o CocoaPods, além do Gerenciador de pacotes do Swift.

Para fazer a distribuição do Firebase com o CocoaPods, é preciso usar o Xcode 14.1 e o CocoaPods 1.10.0 ou versões mais recentes. Veja como instalar o Firebase usando o CocoaPods:

  1. Crie um Podfile se ainda não tiver um. Na raiz do diretório do seu projeto, execute o seguinte comando:

    pod init
  2. No seu Podfile, adicione os pods do Firebase que você quer usar no app.

    É possível adicionar qualquer um dos produtos do Firebase que app suporta.

    Analytics ativado

    # 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 do dispositivo, na documentação da Apple Privacidade do usuário e uso de dados e Transparência no rastreamento de apps.

    Analytics não ativado

    # 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'
  3. 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 de produtos

Alguns produtos do Firebase exigem mais etapas de integração para funcionar corretamente.

Crashlytics

O Crashlytics exige o upload de símbolos de depuração.

Você pode usar uma fase do build do script de execução para que o Xcode faça upload automático dos símbolos de depuração após a criação. Encontre o script de execução aqui:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Carthage

O suporte ao Carthage é experimental. Consulte as instruções no GitHub (em inglês) para incluir o Firebase no seu app usando o Carthage.

Integrar manualmente

O Firebase fornece uma distribuição XCFramework binária e pré-criada para usuários que querem integrar o Firebase sem usar um gerenciador de dependências. Para instalar o Firebase, siga estas instruções:

  1. Faça o download do arquivo zip com o SDK do framework. Esse arquivo contém frações de todas as arquiteturas de destino disponíveis para todos os SDKs do Firebase. Por isso, o download pode levar algum tempo.

  2. Descompacte o arquivo e confira o documento README para ver quais frameworks você vai querer incluir no seu app.

  3. Adicione a sinalização -ObjC do vinculador a Other Linker Settings nas configurações de compilação do destino.