Adicionar o Firebase ao seu projeto do Unity

Melhore seus jogos do Unity com nossos SDKs do Firebase.

Para mostrar como é fácil conectar o Firebase ao seu projeto do Unity, criamos um jogo de exemplo, o MechaHamster. Se você quiser testar a adição do Firebase a um jogo, use a versão inicial que está no GitHub. Se quiser uma versão completa, confira as versões na App Store ou na Google Play Store.

MechaHamster (GitHub)

MechaHamster (App Store)

MechaHamster (Play Store)


Veja mais informações sobre como turbinar seus jogos com o Firebase na nossa página do Firebase para jogos.

Já adicionou o Firebase ao seu projeto do Unity? Verifique se você está usando a versão mais recente do SDK do Firebase para Unity.

Pré-requisitos

  • Instale o Unity 2019.1 ou uma versão mais recente. As versões anteriores também podem ser compatíveis, mas não terão um amplo suporte. O suporte ao Unity 2019.1 foi descontinuado e não será mais oferecido após o lançamento da próxima versão principal.

  • (Somente em plataformas da Apple) Instale o seguinte:

    • Xcode 13.3.1 ou versões mais recentes
    • CocoaPods 1.12.0 ou versões mais recentes

  • Verifique se o projeto do Unity atende aos requisitos a seguir:

    • Para iOS: voltado ao iOS 11 ou versões mais recentes
    • Para tvOS: voltado ao tvOS 12 ou versões mais recentes
    • Para Android: voltado ao nível 19 da API (KitKat) ou versões mais recentes

  • Configure um dispositivo físico ou use um emulador para executar seu app.

    • Para plataformas da Apple: configure um dispositivo físico ou use um simulador do iOS ou do tvOS.

    • Para Android: os emuladores precisam usar uma imagem de emulador no Google Play.

Se você ainda não tem um projeto do Unity e quer testar um produto do Firebase, faça o download de uma das nossas amostras introdutórias.

Etapa 1: criar um projeto do Firebase

Antes de adicionar o Firebase ao seu projeto Unity, crie um projeto do Firebase. Depois, conecte os dois projetos. Para mais informações, consulte Noções básicas sobre projetos do Firebase.

Etapa 2: registrar seu app com o Firebase

É possível registrar um ou mais apps ou jogos para conectar ao seu projeto do Firebase.

  1. Acesse o Console do Firebase.

  2. No centro da página de visão geral do projeto, clique no ícone do Unity () para iniciar o fluxo de trabalho de configuração.

    Se você já adicionou um app ao seu projeto do Firebase, clique em Adicionar app para exibir as opções da plataforma.

  3. Selecione qual destino de build do seu projeto do Unity você quer registrar ou opte por registrar os dois destinos agora.

  4. Digite os IDs específicos da plataforma do seu projeto do Unity.

    • Para iOS: insira o ID do iOS do seu projeto do Unity no campo ID do pacote do iOS.

    • Para Android: insira o ID do Android do seu projeto do Unity no campo Nome do pacote Android.
      Os termos nome do pacote e ID do aplicativo geralmente são usados de maneira intercambiável.

  5. (Opcional) Digite os apelidos específicos da plataforma do seu projeto do Unity.
    Esses apelidos são identificadores de conveniência internos e só são visíveis para você no Console do Firebase.

  6. Clique em Registrar app.

Etapa 3: adicionar arquivos de configuração do Firebase

  1. Receba seus arquivos de configuração do Firebase específicos da plataforma no fluxo de trabalho de configuração do Console do Firebase.

    • Para iOS: clique em Download GoogleService-Info.plist.

    • Para Android: clique em Download google-services.json.

  2. Abra a janela Projeto do seu projeto do Unity e mova seus arquivos de configuração para a pasta Assets.

  3. De volta ao fluxo de trabalho de configuração no Console do Firebase, clique em Avançar.

Etapa 4: adicionar SDKs do Firebase para Unity

  1. No Console do Firebase, clique em Fazer o download do SDK do Firebase para Unity e descompacte o SDK em algum lugar conveniente.

    • É possível fazer o download do SDK do Firebase para Unity novamente a qualquer momento.

    • O SDK do Firebase para Unity não é específico da plataforma.

  2. No seu projeto aberto do Unity, acesse Assets > Import Package > Custom Package.

  3. No SDK descompactado, selecione os produtos compatíveis do Firebase que você quer usar no seu aplicativo.

    Analytics ativado

    • Adicione o pacote do Firebase para o Google Analytics: FirebaseAnalytics.unitypackage
    • Adicione os pacotes de qualquer outro produto do Firebase que quiser usar no seu aplicativo. Por exemplo, para usar o Firebase Authentication e o Firebase Realtime Database:
      FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

    Analytics não ativado

    Adicione os pacotes dos produtos do Firebase que você quer usar no seu app. Por exemplo, para usar o Firebase Authentication e o Firebase Realtime Database:
    FirebaseAuth.unitypackage e FirebaseDatabase.unitypackage

  4. Na janela Import Unity Package, clique em Import.

  5. De volta ao fluxo de trabalho de configuração no Console do Firebase, clique em Avançar.

Etapa 5: confirmar os requisitos da versão do Google Play Services

O SDK do Firebase para Unity no Android requer a plataforma Google Play Services, que precisa estar atualizada antes que o SDK possa ser usado.

Adicione a instrução using e o código de inicialização abaixo no início do aplicativo. É possível verificar e, como opção, atualizar o Google Play Services para a versão exigida pelo SDK do Firebase para Unity antes de chamar outros métodos no SDK.

using Firebase.Extensions;

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWithOnMainThread(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp,
    // where app is a Firebase.FirebaseApp property of your application class.
       app = Firebase.FirebaseApp.DefaultInstance;

    // Set a flag here to indicate whether Firebase is ready to use by your app.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

Tudo pronto! Seu projeto do Unity está registrado e configurado para usar o Firebase.

Se você estiver com problemas para configurar, acesse as Solução de problemas e perguntas frequentes sobre o Unity.

Configurar um fluxo de trabalho para computadores (Beta)

Ao criar um jogo, geralmente é mais fácil fazer os testes no editor do Unity e nas plataformas de computador primeiro e depois implantar e testar em dispositivos móveis durante o desenvolvimento. Para oferecer suporte a esse fluxo de trabalho, fornecemos um subconjunto de SDKs do Firebase para Unity que pode ser executado no Windows, macOS, Linux e no editor do Unity:

  1. Configure um projeto do Unity na plataforma de computadores seguindo as mesmas instruções de uma plataforma de dispositivos móveis. Primeiro conclua a etapa Registrar seu app com o Firebase acima.

  2. Execute seu projeto do Unity no ambiente de desenvolvimento integrado do Unity ou selecione a opção de criar seu projeto para computadores.

  3. (Opcional) Execute seu projeto do Unity no modo de edição.

    O SDK do Firebase para Unity também pode ser executado no modo de edição do Unity. Isso permite que ele seja usado em plug-ins de editor.

    1. Ao criar um FirebaseApp usado pelo editor, não use a instância padrão.

    2. Em vez disso, forneça um nome exclusivo para a chamada FirebaseApp.Create().

      Isso é importante para evitar um conflito nas opções entre a instância usada pelo ambiente de desenvolvimento integrado do Unity e a instância usada pelo seu projeto.

Produtos do Firebase com suporte

Saiba mais sobre as bibliotecas do Firebase para Unity na documentação de referência.

Bibliotecas do Firebase disponíveis para dispositivos móveis

O SDK do Firebase para Unity oferece suporte aos seguintes produtos do Firebase na Apple e no Android:

Produto do Firebase Pacote do Unity
AdMob Distribuído separadamente no plug-in do Unity da AdMob
Analytics FirebaseAnalytics.unitypackage
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Messaging FirebaseMessaging.unitypackage
(recomendado) FirebaseAnalytics.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Crashlytics FirebaseCrashlytics.unitypackage
(recomendado) FirebaseAnalytics.unitypackage
Dynamic Links FirebaseDynamicLinks.unitypackage
(recomendado) FirebaseAnalytics.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Configuração remota FirebaseRemoteConfig.unitypackage
(recomendado) FirebaseAnalytics.unitypackage

Bibliotecas do Firebase disponíveis para computador

O SDK do Firebase para Unity inclui suporte a fluxo de trabalho em computadores para um subconjunto de produtos. Isso permite que determinadas partes do Firebase sejam usadas no editor do Unity e em versões independentes para computadores no Windows, macOS e Linux.

Produto do Firebase (computador) Pacote do Unity
App Check FirebaseAppCheck.unitypackage
Authentication FirebaseAuth.unitypackage
Cloud Functions FirebaseFunctions.unitypackage
Cloud Firestore FirebaseFirestore.unitypackage
Cloud Storage FirebaseStorage.unitypackage
Realtime Database FirebaseDatabase.unitypackage
Configuração remota FirebaseRemoteConfig.unitypackage

O Firebase fornece as bibliotecas para computador restantes como implementações stub (não funcionais) para sua comodidade durante a criação de projetos para Windows, macOS e Linux. Por causa disso, não é preciso compilar código de modo condicional para segmentar computadores.

Próximas etapas