Outras opções de instalação do Unity

Em vez de fazer o download de um arquivo .zip grande, que contém todos os arquivos .unitypackage para .NET 3.X e .NET 4.X, é possível fazer o download de pacotes individuais no site de APIs do Google para o Unity.

Nessa página da Web, você encontra as seguintes opções:

  • Arquivos .NET 4.X .unitypackage individuais que podem ser importados como pacotes de recursos.
  • Arquivos .tgz individuais que podem ser importados usando o Unity Package Manager.

Isso pode ser útil principalmente se o seu app usar um único produto do Firebase, já que os arquivos .unitypackage individuais contêm todas as dependências necessárias, e os arquivos .tgz são listados junto aos arquivos .tgz dos quais dependem.

Nesta página, você verá instruções sobre o Unity Package Manager. Por isso, recomendamos que você confira a documentação do Unity para saber mais detalhes sobre a ferramenta.

Importar pacotes do Firebase como recursos

Veja a seguir algumas dicas importantes para importar produtos do Firebase com arquivos .unitypackage do site de APIs do Google para o Unity:

  • Se você estiver usando vários produtos do Firebase no projeto, precisará fazer o download e o upgrade de todos eles para a mesma versão.

  • Não misture métodos de importação em um projeto. Ou seja, não importe produtos do Firebase com o fluxo de pacotes de recursos e o fluxo do Unity Package Manager.

Após fazer o download, siga estas instruções para fazer a importação:

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

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

Importar pacotes do Firebase usando o Unity Package Manager

Veja a seguir algumas dicas importantes para importar produtos do Firebase com arquivos .tgz do site de APIs do Google para Unity:

  • Esse método está disponível apenas a partir da versão 2018.3.

  • Se você estiver usando vários produtos do Firebase no projeto, precisará fazer o download e o upgrade de todos eles para a mesma versão.

  • Não misture métodos de importação em um projeto. Ou seja, não importe produtos do Firebase com o fluxo de pacotes de recursos e o fluxo do Unity Package Manager.

  • As dependências dos arquivos .tgz de cada produto são vinculadas junto aos próprios arquivos .tgz. É preciso fazer o download e a importação do arquivo .tgz do produto e dos arquivos .tgz de dependência nesta ordem:

    1. External Dependency Manager (com.google.external-dependency-manager)
    2. Firebase Core (com.google.firebase.app)
    3. Produtos do Firebase usados no seu projeto. Se você usa Realtime Database ou Cloud Storage, importe Authentication (com.google.firebase.auth) primeiro.

Depois de fazer o download, importe os arquivos .tgz para seu projeto usando um destes métodos:

IU do Package Manager

  1. Abra a janela do Unity Package Manager.
  2. Clique no ícone + no canto superior esquerdo e selecione Add package from tarball para abrir o navegador de arquivos.
  3. Selecione o tarball desejado.

Algumas versões mais antigas do Unity 2019 não são compatíveis com a adição direta de tarballs. Nesse caso, você precisará seguir estas etapas:

  1. Descompacte o arquivo .tgz.
  2. Clique no ícone + no canto superior esquerdo da janela do Package Manager e selecione Add package from disk para abrir o navegador de arquivos.
  3. Selecione a pasta extraída.

manifest.json

  1. Crie uma nova pasta ao lado da Packages do projeto e nomeie-a como GooglePackages.
  2. Coloque os arquivos .tgz nessa pasta.
  3. Use um editor de texto para abrir Packages/manifest.json na pasta do projeto do Unity.

  4. Adicione uma entrada para cada pacote que você quer importar e correlacione o nome deles ao local desejado no disco. É necessário anexar file: ao caminho do arquivo .tgz. Por exemplo, se você estivesse importando com.google.firebase.storage e a dependência dele, seu manifest.json ficaria assim:

    {
  "dependencies": {
    "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164.tgz",
    "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0.tgz",
    "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0.tgz",
    "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0.tgz",
    // com.unity package entries...
  }
}

  5. Salve o arquivo manifest.json.

  6. Quando o Unity recuperar o foco, ele recarregará o manifest.json e importará os pacotes recém-adicionados.

Algumas versões mais antigas do Unity não são compatíveis com arquivos .tgz no manifest.json. Nesse caso, siga estas instruções:

  1. Descompacte o arquivo .tgz.

  2. Edite seu manifest.json para usar o caminho para a pasta extraída, em vez do arquivo .tgz, da seguinte maneira:

    {
  "dependencies": {
    "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164",
    "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0",
    "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0",
    "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0",
    // com.unity package entries...
  }
}

Migrar do Unity Package Manager para os pacotes de recursos

Em alguns casos, recomendamos usar o Unity Package Manager para rastrear produtos do Firebase e fazer a importação deles na pasta Assets.

Se você não souber qual método de importação está usando, abra o arquivo Packages/manifest.json na pasta do projeto do Unity. Se ele tiver entradas começando com com.google.firebase, o projeto usou o Unity Package Manager para a importação.

Se você quiser migrar para pacotes de recursos, siga estas instruções:

  1. Anote as versões atuais dos pacotes do Firebase no seu projeto e depois as remova.

    1. No menu Window, selecione Package Manager. Na janela Package Manager, verifique se a opção "Packages: In Project" está selecionada.
    2. Anote as versões dos pacotes do Firebase importados.
    3. Clique no nome de cada pacote e depois em Remove. Remova o pacote External Dependency Manager (.com.google.external-dependency-manager) e os pacotes do Firebase.

  2. Faça o download e importe os arquivos .unitypackage substitutos. Você tem duas opções:

    • Se você puder fazer upgrade para a versão mais recente de cada pacote, faça o download e a importação do arquivo ZIP do SDK do Firebase para Unity conforme descrito em Adicionar o Firebase ao seu projeto do Unity.
    • Se você precisar preservar as versões .unitypackage atuais, faça o download e a importação de pacotes individuais, conforme descrito acima nesta página.

Migrar de pacotes de recursos para o Unity Package Manager

Em alguns casos, recomendamos trocar a importação de produtos na pasta Assets pela importação e o rastreamento do Unity Package Manager.

Se você não souber qual método de importação está usando, abra o arquivo Packages/manifest.json na pasta do projeto do Unity. Se o arquivo tiver entradas começando com com.google.firebase, o projeto já está usando o Unity Package Manager para a importação.

Se você quiser migrar para o Unity Package Manager, siga estas instruções:

  1. Confira se todos os pacotes do Firebase e o pacote External Dependency Manager foram removidos da pasta Assets usando um dos métodos a seguir.

    Interface do EDM4U

    1. No seu projeto aberto do Unity, clique em Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages.
    2. Selecione todos os pacotes do Firebase e o External Dependency Manager.
    3. Clique em Uninstall Selected Package.

    Remoção manual

    Usando as ferramentas do sistema de arquivos, exclua manualmente as seguintes pastas:

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase

  2. Importe os pacotes usando o Unity Package Manager, conforme descrito acima nesta página.