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:

No seu projeto aberto do Unity, acesse Assets > Import Package > Custom Package.
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ê utiliza o Realtime Database ou o Cloud Storage, importe primeiro o arquivo Authentication (com.google.firebase.auth).

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

IU do Package Manager

Abra a janela do Unity Package Manager.
Clique no ícone + no canto superior esquerdo e selecione Add package from tarball para abrir o navegador de arquivos.
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:

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

manifest.json

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

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

Salve o arquivo manifest.json.
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:

Descompacte o arquivo .tgz.

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:

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

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
Importe os pacotes usando o Unity Package Manager, conforme descrito acima nesta página.