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 do .unitypackage.
  • Instale no diretório Assets do projeto.
  • Pode ser importado para o Unity 5 e versões mais recentes.
  • Geralmente, incluem pacotes dependentes.
• Pacotes do Unity Package Manager (UPM):
  • Ter uma extensão do .tgz.
  • Instale no diretório Packages do projeto.
  • Pode ser importado para o Unity 2018.4 e 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 e arquivos .tgz para alguns dos pacotes.

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

Abaixo você encontra instruções sobre como instalar os dois tipos de pacotes, junto com instruções de migração para fazer a transição do tipo para o outro.

Depois de se familiarizar com essas opções de instalação, consulte instruções adicionais específicas do produto para o Firebase.

Importação de pacotes de recursos com arquivos .unitypackage

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

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

Como importar pacotes do 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ê um nome a ela GooglePackages.
2. Coloque os arquivos .tgz nessa pasta.
3. Use um editor de texto para abrir Packages/manifest.json no seu projeto do Unity do Compute Engine.

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. Lembre-se de anexar file: ao caminho do arquivo .tgz. Para Por exemplo, se você estivesse instalando o com.google.firebase.storage e os dependências, o manifest.json será semelhante a este:

   {
     "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, faça o seguinte:

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

3. Edite o arquivo manifest.json para usar o caminho da pasta extraída. do arquivo .tgz, assim:

   {
     "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 Package Manager 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 são compatíveis com a adição direta de tarballs. Nesse caso, você precisará:

1. Descompacte o arquivo .tgz.

2. Clique no ícone + no canto superior esquerdo do Package Manager. e selecione Add package from disk para abrir o navegador de arquivos.

   

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

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

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

Por exemplo, se você estivesse instalando com.google.firebase.storage, instale 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 sobre o pedido, siga as instruções no guia manifest.json.

Observação: se você já instalou o pacote com um .unitypackage do pacote, exclua essa versão do pacote antes adicionar uma nova. Confira abaixo. para mais instruções.

Controle de versão

Se você usa um software de controle de versões para gerenciar os arquivos do seu projeto, recomendamos adicionar os arquivos .tgz relevantes ao controle de versões. É possível fazer isso manualmente editar o manifest.json do projeto (consulte instruções acima) e faça referência a arquivos .tgz locais usando caminhos relativos.

Se você estiver usando o git, recomendamos Armazenamento de arquivos grandes do Git (LFS) para gerenciar arquivos .tgz grandes.

Como migrar de pacotes UPM para pacotes de recursos

Em alguns casos, convém deixar de usar Gerenciador de pacotes do Unity (link em inglês) para gerenciar pacotes do Google ou instalar pacotes na pasta "Assets".

Confira se todos os pacotes do Google foram removidos do Unity Package Manager usando o um dos seguintes 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 os pacotes do Google.

   

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

manifest.json

1. Use um editor de texto para abrir Packages/manifest.json no seu projeto do Unity do Compute Engine.
2. Verifique se há pacotes do Google em "dependências". O pacote deve 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, será possível faça o download e importe os arquivos .unitypackage substitutos do arquivo página.

Como migrar de pacotes de recursos para pacotes do UPM

Em alguns casos, é melhor deixar de instalar produtos no Árvore de recursos para instalar e rastrear produtos com o Unity Package Manager.

Se você não souber qual método de instalação está usando, na interface do Unity, verifique se os pacotes do Google desejados aparecem na guia "Projeto", em Recursos.

Para migrar para pacotes UPM:

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

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

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

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

Clique aqui para ver as instruções do Firebase.