Instalar pacotes do Google para Unity

Os pacotes do Google para Unity são distribuídos em dois formatos diferentes:

• Pacotes de recursos:
  • Ter uma extensão .unitypackage.
  • Instale no diretório Assets do projeto.
  • Podem ser importadas no Unity 5 e mais recentes.
  • Geralmente, incluem pacotes dependentes.
• Pacotes do Unity Package Manager (UPM):
  • Ter uma extensão .tgz.
  • Instale no diretório Packages do projeto.
  • Pode ser importado no Unity 2018.4 e em versões mais recentes.
  • Faça referência aos pacotes dependentes que precisam ser instalados separadamente.

A página Pacotes contém os arquivos .unitypackage mais recentes para todos os pacotes disponíveis.

A página Arquivo contém os arquivos .unitypackage e .tgz para todas as versões do pacote.

Confira abaixo instruções sobre como instalar os dois tipos de pacotes, além de instruções de migração para fazer a transição de um tipo para o outro.

Quando você estiver familiarizado com essas opções de instalação, consulte as outras instruções específicas do produto para Firebase.

Como importar pacotes de recursos com arquivos .unitypackage

Importe o arquivo .unitypackage selecionando a opção de menu Assets > Import package > Custom Package do Unity e importando todos os itens. Isso adiciona o conteúdo do pacote ao projeto no diretório Assets.

Observação: se você já instalou o pacote usando a janela do Package Manager do Unity, desinstale a versão antiga antes de importar o novo. Confira as instruções abaixo.

Como importar pacotes UPM com arquivos .tgz (2018.4+)

Importe arquivos .tgz para seu projeto usando um dos seguintes métodos:

manifest.json

1. Crie uma nova pasta ao lado da pasta Packages do projeto e dê a ela o nome 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 instalar, mapeando o nome do pacote para o local no disco, relativo ao arquivo Packages/manifest.json. Anexe file: ao caminho do arquivo .tgz. Por exemplo, se você estivesse instalando com.google.firebase.storage e as dependências, 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, você deve:

1. Descompacte os arquivos .tgz.
2. Coloque a pasta extraída na pasta GooglePackages.

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

interface do Package Manager

1. Abra a janela do Unity Package Manager.

2. Clique no ícone + no canto superior esquerdo da janela do Gerenciador de pacotes e selecione Add package from tarball para abrir o navegador de arquivos.

   

3. Selecione o tarball desejado no navegador de arquivos.

Algumas versões mais antigas do Unity não oferecem suporte à adição direta de tarballs. Nesse caso, faça o seguinte:

1. Descompacte o arquivo .tgz.

2. Clique no ícone + no canto superior esquerdo da janela do Gerenciador de pacotes e selecione Add package from disk para abrir o navegador de arquivos.

   

   Observação: o Unity 2018 coloca o ícone + no canto inferior esquerdo do painel da lista de pacotes.

3. Selecione a pasta extraída no navegador de arquivos.

Importe também os arquivos .tgz para as dependências do pacote, que podem ser encontradas na página do arquivo na seção do pacote desejado.

Por exemplo, se você estivesse instalando com.google.firebase.storage, instalaria esses arquivos .tgz na seguinte ordem:

1. Gerenciador de dependências externas (com.google.external-dependency-manager)
2. Firebase Core (com.google.firebase.app)
3. Firebase Auth (com.google.firebase.auth)
4. Armazenamento do Firebase (com.google.firebase.storage)

Se você preferir adicionar todos os arquivos .tgz de uma só vez, sem se preocupar com a ordem, siga as instruções na guia manifesto.json.

Observação: se você já instalou o pacote com um arquivo .unitypackage, exclua essa versão do pacote antes de adicionar um novo. Confira as instruções abaixo.

Controle de versão

Se você estiver usando um software de controle de versões para gerenciar os arquivos do projeto, recomendamos adicionar os arquivos .tgz relevantes ao controle de versões. É possível editar manualmente o manifest.json do projeto (consulte as instruções acima) e referenciar os arquivos .tgz locais usando caminhos relativos.

Se você estiver usando o git, recomendamos o Git Large File Storage (LFS) para gerenciar arquivos .tgz grandes.

Como migrar de pacotes UPM para pacotes de recursos

Em alguns casos, é recomendável usar o Unity Package Manager para gerenciar pacotes do Google para instalar pacotes na pasta "Assets".

Confira se todos os pacotes do Google foram removidos do Unity Package Manager usando um destes métodos:

interface do Package Manager

1. Abra a janela do Unity Package Manager.

2. Selecione In Project no menu suspenso no canto superior esquerdo.

   

3. Digite com.google na barra de pesquisa para filtrar por pacotes do Google.

   

4. Clique no nome de cada pacote e depois em Remove.

manifest.json

1. Use um editor de texto para abrir Packages/manifest.json na pasta do projeto do Unity.
2. Verifique se há algum pacote do Google em "dependências". O nome do pacote precisa começar com "com.google", por exemplo, "com.google.firebase.app".
3. Exclua essas linhas e salve o arquivo JSON.
4. Quando o Unity recuperar o foco, ele recarregará o arquivo manifest.json e removerá os pacotes excluídos.

Depois de desinstalar esses pacotes do Unity Package Manager, você pode fazer o download e importar os arquivos .unitypackage substitutos da página do arquivo.

Como migrar de pacotes de recursos para pacotes UPM

Em alguns casos, recomendamos mudar da instalação de produtos na árvore de recursos para a instalação e o rastreamento de produtos com o Unity Package Manager.

Se você não tiver certeza de qual método de instalação está usando, na interface do Unity, verifique se os pacotes do Google desejados aparecem na guia Project, em Assets.

Se quiser migrar para pacotes UPM, faça o seguinte:

1. Verifique se todos os pacotes do Google foram removidos da pasta "Assets".

   • Para desinstalar pacotes do Firebase, siga estas instruções.
   • Para desinstalar os plug-ins do Google Play para Unity, exclua a pasta GooglePlayPlugins em Assets.

2. Instale pacotes usando o Unity Package Manager, conforme descrito acima.

Instruções de migração para produtos específicos

Consulte aqui as instruções do Firebase.