Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

Instale o Firebase no seu app da Apple

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Gerenciador de Pacotes Swift

A partir da v8.0.0 do Firebase Apple SDK, o suporte ao Swift Package Manager do Firebase está fora da versão beta e geralmente está disponível para uso. CocoaPods não é necessário para usuários do Swift Package Manager.

Para Firebase versões 8 e superiores, o Swift Package Manager é o método de instalação recomendado.

Via Xcode

O suporte ao Swift Package Manager requer 13.3.1 ou superior.

  1. Se estiver migrando de um projeto baseado em CocoaPods, execute pod deintegrate para remover CocoaPods de 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, essa etapa poderá ser ignorada.

  2. No Xcode, instale as bibliotecas do Firebase navegando até File > Add Packages

  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 você quer usar. Para novos projetos, recomendamos usar a versão mais recente do Firebase.

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

Quando terminar, o Xcode começará a resolver suas dependências de pacotes e baixá-los em segundo plano.

Via Package.swift

Para integrar o Firebase a um pacote Swift por meio de um manifesto Package.swift , você pode adicionar o Firebase à matriz de 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 do 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 de vinculador -ObjC às configurações de compilação de seu destino, se incluído de forma transitiva.

Crashlytics

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

Você pode usar uma fase de compilação de script de execução para o Xcode para carregar automaticamente símbolos de depuração após a compilaçã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 seu arquivo de 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 carregar manualmente os 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 o Xcode 13.3.1 e o CocoaPods 1.10.0 ou superior. Veja como instalar o Firebase usando o CocoaPods:

  1. Crie um Podfile se você 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 compilação de script de execução para o Xcode para carregar automaticamente símbolos de depuração após a compilação. Encontre o script de execução aqui:

"${PODS_ROOT}/FirebaseCrashlytics/run"

Cartago

O apoio a Cartago é experimental. Veja as instruções no GitHub para incluir o Firebase em seu aplicativo via Carthage.

Integrar manualmente

O Firebase fornece uma distribuição XCFramework binária pré-criada 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 fazer o download.

  2. Descompacte o arquivo e revise o README para as estruturas que deseja incluir em seu aplicativo.

  3. Adicione o sinalizador de vinculador -ObjC em suas Other Linker Settings de compilação do seu destino.