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.
  • Pode ser importado no Unity 5 e versões 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 versões mais recentes.
  • Referenciar pacotes dependentes que precisam ser instalados separadamente.

A página Packages contém os arquivos .unitypackage mais recentes de todos os pacotes disponíveis e arquivos .tgz de alguns deles.

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

Confira abaixo as instruções para 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.

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

Como importar pacotes usando o OpenUPM

É possível adicionar pacotes externos ao seu projeto do Unity usando o registro do OpenUPM. O OpenUPM hospeda muitos plug-ins e SDKs úteis, como o plug-in de integridade do Google Play, que ajuda a proteger seu app contra fraudes e abusos.

Confira como adicionar, por exemplo, o plug-in da Play Integrity usando o OpenUPM.

OpenUPM-CLI

Se você tiver a CLI do OpenUPM instalada, poderá instalar o registro do OpenUPM com o seguinte comando:

openupm add com.google.play.integrity

OpenUPM

1. Abra as configurações do gerenciador de pacotes selecionando a opção de menu do Unity Edit > Project Settings > Package Manager.

2. Adicione o OpenUPM como um registro de escopo à janela do Gerenciador de pacotes:

   Name: package.openupm.com
   URL: https://package.openupm.com
   Scopes: com.google.external-dependency-manager
    com.google.play.common
    com.google.play.core
    com.google.play.integrity
   

3. Abra o menu do gerenciador de pacotes selecionando a opção de menu do Unity Window > Package Manager.

4. Defina o menu suspenso "Escopo do administrador" para selecionar Meus registros.

   

5. Selecione o pacote Google Play Integrity plugin for Unity na lista de pacotes e pressione Install.

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á tiver instalado o pacote usando a janela do Unity Package Manager, desinstale a versão antiga do pacote antes de importar a nova. Confira as instruções abaixo.

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

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

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 instalar e correlacione o nome deles ao local desejado no disco, em relação ao arquivo Packages/manifest.json. É necessário anexar file: ao caminho do arquivo .tgz. Por exemplo, se você estivesse instalando com.google.firebase.storage e as dependências dele, o arquivo 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 arquivo 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ê precisa:

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

3. Edite o arquivo 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 gerenciador de pacotes

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 são compatíveis com a adição direta de tarballs. Nesse caso, você precisa fazer o seguinte:

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.

   

   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 encontrados na página de 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. External Dependency Manager (com.google.external-dependency-manager)
2. Firebase Core (com.google.firebase.app)
3. Firebase Auth (com.google.firebase.auth)
4. Firebase Storage (com.google.firebase.storage)

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

Observação: se você já instalou o pacote com um arquivo .unitypackage, exclua essa versão do pacote antes de adicionar uma nova. 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 instruções acima) e fazer referência a arquivos .tgz locais usando caminhos relativos.

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

Migrar de pacotes do UPM para pacotes de recursos

Em alguns casos, recomendamos trocar o uso do Unity Package Manager para gerenciar pacotes do Google e instalar pacotes na pasta "Assets".

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

Interface do gerenciador de pacotes

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 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á pacotes 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 arquivos .unitypackage de substituição na página de arquivo.

Migrar de pacotes de recursos para pacotes do UPM

Em alguns casos, recomendamos trocar a instalação de produtos na árvore de recursos pela instalação e o rastreamento do Unity Package Manager.

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

Para migrar para os pacotes do 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 os plug-ins do Google Play para Unity, exclua a pasta GooglePlayPlugins em Assets.

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

Instruções de migração específicas do produto

Consulte este link para ver as instruções do Firebase.