Instale o Firebase no seu app da Apple

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.

  1. 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.

  2. No Xcode, instale as bibliotecas Firebase navegando até Arquivo > Adicionar Pacotes

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

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

  5. 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:

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

    Análise ativada

    # 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 .

    Análise não ativada

    # 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 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:

  1. 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.

  2. Descompacte o arquivo e revise o README das estruturas que você deseja incluir em seu aplicativo.

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