Instale o Firebase em seu aplicativo da Apple

Gerenciador de Pacotes Swift

Começando com V8.0.0 do Firebase a Apple SDK, da Firebase Swift Package Manager suporte está fora de beta e é geralmente disponíveis para uso. O CocoaPods não é necessário para usuários do Swift Package Manager.

Para as versões 12.5 e superior do Xcode, o Swift Package Manager é o método de instalação recomendado.

Via Xcode

O suporte do Swift Package Manager requer Xcode 12.5 ou superior.

  1. Se migrar de um projeto baseado em CocoaPods, execute pod deintegrate para remover CocoaPods de seu projeto Xcode. O CocoaPods-gerados .xcworkspace arquivo pode ser excluído com segurança depois. Se você estiver adicionando o Firebase a um projeto pela primeira vez, esta etapa pode ser ignorada.

  2. No Xcode, instalar as bibliotecas Firebase navegando até Arquivo> Pacotes Swift> Adicionar pacote de dependência ...

  3. No prompt que aparece, selecione o repositório Firebase GitHub:

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

  5. Escolha as bibliotecas do Firebase que você deseja incluir em seu aplicativo.

Assim que terminar, o Xcode começará a resolver as dependências do seu pacote e a baixá-las em segundo plano.

via Package.swift

Para integrar Firebase a um pacote Swift através de um Package.swift manifesto, você pode adicionar Firebase à dependencies variedade de seu pacote. Para mais detalhes, consulte a documentação Swift Package Manager .

dependencies: [

  .package(name: "Firebase",
           url: "https://github.com/firebase/firebase-ios-sdk.git",
           from: "8.0"),
  // ...

],

Então, em qualquer alvo que depende de um produto Firebase, adicioná-lo à dependencies variedade desse alvo.

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

Considerações específicas do produto

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

Google Analytics

Google Analytics requer a adição do -ObjC sinalizador do ligador para configurações de compilação do seu alvo se incluído transitively.

Crashlytics

O Crashlytics requer que você carregue símbolos de depuração.

Você pode usar uma fase de construção de script de execução para Xcode para carregar automaticamente os 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 símbolos de upload é usar o upload-symbols script. Coloque o script em um subdiretório do seu arquivo de projeto (por exemplo, scripts/upload-symbols ), então certifique-se de que o script é executável:

chmod +x scripts/upload-symbols

Este script pode ser usado para carregar manualmente os arquivos dSYM. Para notas de uso e instruções adicionais para o script, execute upload-symbols sem nenhum parâmetro.

CocoaPods

Firebase suporta a instalação com CocoaPods além de Swift Package Manager.

A distribuição CocoaPods do Firebase requer Xcode 12.5 e CocoaPods 1.10.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. Para o seu Podfile, adicione os pods do Firebase que você deseja usar no seu aplicativo.

    Você pode adicionar qualquer um dos produtos Firebase suportados para a sua aplicação.

    Analytics habilitado

    # Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
    # 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 'Firebase/Auth'
    pod 'Firebase/Firestore'

    Saiba mais sobre IDFA, o identificador de publicidade no nível do dispositivo, no da Apple a privacidade do usuário e utilizar dados e App Rastreamento Transparência documentação.

    Analytics não habilitado

    # Add the pods for the Firebase products you want to use in your app
    # For example, to use Firebase Authentication and Cloud Firestore
    pod 'Firebase/Auth'
    pod 'Firebase/Firestore'
  3. Instalar as vagens, em seguida, abra o seu .xcworkspace arquivo para ver o projeto no Xcode:

    pod install --repo-update
    open your-project.xcworkspace

Considerações específicas do produto

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

Crashlytics

O Crashlytics requer que você carregue símbolos de depuração.

Você pode usar uma fase de construção de script de execução para Xcode para carregar automaticamente os símbolos de depuração pós-construção. Encontre o script de execução aqui:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Cartago

O suporte a Cartago é experimental. Veja as instruções sobre GitHub para incluir Firebase em seu aplicativo através de Cartago.

Integrar manualmente

O Firebase fornece uma distribuição XCFramework binária pré-construída para usuários que desejam integrar o Firebase sem usar um gerenciador de dependência. Para instalar o Firebase:

  1. Baixe o zip quadro SDK . 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 fazer o download.

  2. Descompacte o arquivo, em seguida, analisar o README para os quadros que você deseja incluir no seu aplicativo.

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