Opções adicionais de instalação do Unity

Em vez de fazer download de um arquivo .zip grande contendo todos os arquivos .unitypackage para .NET 3.X e .NET 4.X, você pode fazer download de pacotes individuais no site APIs do Google para Unity .

O site fornece:

  • Arquivos .unitypackage individuais do .NET 4.X para importar como pacotes de ativos.
  • Arquivos .tgz individuais para importar usando o Unity Package Manager.

Isso é especialmente útil quando seu aplicativo usa um único produto Firebase, já que os arquivos .unitypackage individuais contêm todas as dependências necessárias, e os arquivos .tgz são listados junto com os arquivos .tgz relacionados dos quais dependem.

Esta página fornece instruções envolvendo o Unity Package Manager, por isso é uma boa ideia aprender sobre a ferramenta na documentação do Unity .

Importe pacotes do Firebase como ativos

Ao importar produtos Firebase de arquivos .unitypackage baixados do site APIs do Google para Unity , lembre-se do seguinte:

  • Se você estiver usando vários produtos do Firebase no seu projeto, deverá fazer download e atualizar todos os produtos do Firebase para a mesma versão.

  • Não misture métodos de importação em um projeto. Ou seja, não importe produtos Firebase com o fluxo de pacote Asset e usando o fluxo Unity Package Manager.

Após o download, para importar:

  1. Em seu projeto aberto do Unity, navegue até Assets > Import Package > Custom Package .

  2. Na janela Importar pacote do Unity , clique em Importar .

Importe pacotes do Firebase usando o Unity Package Manager

Ao importar produtos do Firebase de arquivos .tgz baixados do arquivo de APIs do Google para Unity , lembre-se do seguinte:

  • Este método está disponível apenas em 2018.3+.

  • Se você estiver usando vários produtos do Firebase no seu projeto, deverá fazer download e atualizar todos os produtos do Firebase 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 do pacote Asset e com o fluxo do Unity Package Manager.

  • As dependências de cada arquivo .tgz do produto são vinculadas em seus próprios arquivos .tgz . Você deve fazer download e importar o arquivo .tgz do produto e os arquivos .tgz dependência, na ordem correta:

    1. Gerenciador de dependência externa ( com.google.external-dependency-manager )
    2. Núcleo do Firebase ( com.google.firebase.app )
    3. Produtos do Firebase usados ​​no seu projeto. Se você usa o Realtime Database ou o Cloud Storage, importe primeiro a autenticação ( com.google.firebase.auth ).

Após o download, importe os arquivos .tgz para o seu projeto usando um dos seguintes métodos:

IU do gerenciador de pacotes

  1. Abra a janela do Gerenciador de Pacotes do Unity.
  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 2019 não suportam a adição direta de tarballs. Neste caso, você precisará:

  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.
  3. Selecione a pasta extraída no navegador de arquivos.

manifesto.json

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

  4. Adicione uma entrada para cada pacote que deseja importar, mapeando o nome do pacote para o local no disco. Certifique-se de anexar file: ao caminho do arquivo .tgz . Por exemplo, se você estivesse importando com.google.firebase.storage e suas 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 suportam arquivos .tgz no manifest.json . Neste caso, você deve:

  1. Descompacte o arquivo .tgz .

  2. Edite seu manifest.json para usar o caminho para a pasta extraída, em vez 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...
  }
}

Migrar do Unity Package Manager para pacotes de ativos

Em alguns casos, você pode querer deixar de usar o Unity Package Manager para rastrear produtos Firebase e passar a importar produtos na pasta Assets .

Se você não tiver certeza de qual método de importação está usando, na pasta do projeto Unity, abra o arquivo Packages/manifest.json . Se o arquivo contiver entradas começando com com.google.firebase , seu projeto usou o Unity Package Manager para importação.

Para migrar para pacotes de ativos:

  1. Anote as versões atuais do pacote Firebase em seu projeto e remova-as.

    1. No menu Janela , selecione Gerenciador de Pacotes . Na janela do Gerenciador de Pacotes , certifique-se de que "Pacotes: No Projeto" esteja selecionado.
    2. Observe as versões dos pacotes importados do Firebase.
    3. Clique no nome de cada pacote e clique em Remover . Certifique-se de remover o pacote do Gerenciador de dependência externa ( .com.google.external-dependency-manager ), bem como os pacotes do Firebase.

  2. Baixe e importe arquivos .unitypackage de substituição. Você tem duas opções:

    • Se você puder atualizar para a versão mais recente de cada pacote, faça download do arquivo zip do Firebase Unity SDK e importe conforme descrito em Adicionar o Firebase ao seu projeto Unity .
    • Se precisar preservar as versões atuais .unitypackage , você pode baixar e importar pacotes individuais conforme descrito acima nesta página.

Migrar de pacotes de ativos para o Unity Package Manager

Em alguns casos, você pode querer mudar da importação de produtos na pasta Assets para importar e rastrear produtos com o Unity Package Manager.

Se você não tiver certeza de qual método de importação está usando, na pasta do projeto Unity, abra o arquivo Packages/manifest.json . Se o arquivo contiver entradas começando com com.google.firebase seu projeto já está usando o Unity Package Manager para importação.

Para migrar para o Unity Package Manager:

  1. Certifique-se de que todos os pacotes do Firebase e o pacote do Gerenciador de Dependências Externas sejam removidos da pasta Assets , usando um dos métodos a seguir.

    Interface do usuário EDM4U

    1. Em seu projeto aberto do Unity, navegue até Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages .
    2. Selecione todos os pacotes do Firebase e o Gerenciador de Dependências Externas.
    3. Clique em Desinstalar pacote selecionado .

    Remoção manual

    Usando 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

  2. Importe pacotes usando o Unity Package Manager, conforme descrito acima nesta página.