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 seu projeto.
    • Eles podem ser importados no Unity 5 e para 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 seu projeto.
    • Eles podem ser importados no Unity 2018.4 e mais recentes.
    • Faça referência a pacotes dependentes que precisam ser instalados separadamente.

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

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

Veja 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 outro.

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

Como importar pacotes de recursos com arquivos .unitypackage

Para importar o arquivo .unitypackage, selecione a opção de menu do Unity Assets > Import package > Custom Package e importe todos os itens. Isso adiciona o conteúdo do pacote ao seu projeto no diretório Assets.

Importação de pacotes UPM com arquivos .tgz (2018.4+)

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

Manifesto.json

  1. Crie uma nova pasta ao lado da pasta 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, mapeando o nome do pacote para o local no disco, relativo 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, seu manifest.json seria 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 recupera o foco, ele recarrega o manifest.json e importa 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 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...
      }
    }
    

IU do Package Manager

  1. Abrir a janela do Package Manager do Unity.
  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.

    Captura de tela da janela do Unity Package Manager com o

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

    Captura de tela da janela do Unity Package Manager com o

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

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

Por exemplo, se você estiver 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. Firebase Storage (com.google.firebase.storage)

Caso prefira adicionar todos os arquivos .tgz de uma vez, sem se preocupar com a ordem, siga as instruções na guia manifest.json.

Controle de versão

Se você estiver usando 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 editar manualmente manifest.json do projeto (consulte as instruções acima) e fazer referência a arquivos .tgz locais usando caminhos relativos.

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

Como migrar de pacotes do UPM para pacotes de recursos

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

Verifique se todos os pacotes do Google foram removidos do Unity Package Manager usando um dos métodos a seguir:

IU do Package Manager

  1. Abrir a janela do Package Manager do Unity.
  2. Selecione In Project na lista suspensa no canto superior esquerdo.

    Captura de tela da janela do Unity Package Manager com o

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

    Captura de tela da janela do Unity Package Manager com

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

Manifesto.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 "quot;dependencies". O nome do pacote precisa começar com "quoquo;com.google", por exemplo, "quot;com.google.firebase.app".
  3. Exclua essas linhas e salve o arquivo json.
  4. Quando o Unity recupera o foco, ele recarrega o arquivo manifest.json e remove os pacotes excluídos.

Depois de desinstalar esses pacotes do Unity Package Manager, é possível fazer o download e importar arquivos .unitypackage substitutos da página de arquivo.

Como migrar de pacotes de recursos para pacotes UPM

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

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

Se você quiser migrar para pacotes do UPM, siga estas etapas:

  1. Confira 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 pacotes usando o Unity Package Manager, conforme descrito acima.

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

Veja instruções do Firebase.