Check out what’s new from Firebase at Google I/O 2022. Learn more

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

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

O site fornece:

  • Arquivos .unitypackage .NET 4.X individuais 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, pois os arquivos .unitypackage individuais contêm todas as dependências necessárias e os arquivos .tgz são listados ao lado dos arquivos .tgz relacionados dos quais dependem.

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

Importar pacotes do Firebase como recursos

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

  • Se você estiver usando vários produtos Firebase em seu projeto, faça o download e atualize todos os produtos 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 usando o fluxo do 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 .

Importar 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 Firebase em seu projeto, faça o download e atualize todos os produtos 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 para cada arquivo .tgz do produto são vinculadas em seus próprios arquivos .tgz . Você deve baixar e importar o arquivo .tgz do produto e os arquivos .tgz de 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 ​​em seu projeto. Se você usa o Realtime Database ou o Cloud Storage, importe a autenticação ( com.google.firebase.auth ) primeiro.

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

IU do Gerenciador de Pacotes

  1. Abra a janela 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 de tarballs diretamente. 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.

manifest.json

  1. Crie uma nova pasta ao lado da pasta Packages do seu 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 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 oferecem suporte a 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 mudar do uso do Unity Package Manager para rastrear produtos do Firebase para importar produtos na pasta Assets .

Se você não tiver certeza de qual método de importação está usando, na pasta do projeto do Unity, abra o arquivo Packages/manifest.json . Se o arquivo contiver entradas que começam 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 do Firebase em seu projeto e remova-as.

    1. No menu Janela , selecione Gerenciador de Pacotes . Na janela Gerenciador de Pacotes , certifique-se de que "Packages: In Project" esteja selecionado.
    2. Observe as versões dos pacotes importados do Firebase.
    3. Clique no nome de cada pacote e, em seguida, clique em Remover . Certifique-se de remover o pacote External Dependency Manager ( .com.google.external-dependency-manager ), bem como os pacotes do Firebase.
  2. Baixe e importe arquivos .unitypackage substituição. Você tem duas opções:

    • Se você puder fazer upgrade para a versão mais recente de cada pacote, faça o download do arquivo zip do SDK do Firebase Unity e importe conforme descrito em Adicionar o Firebase ao seu projeto do Unity .
    • Se você precisar preservar as versões atuais do .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 importação e rastreamento de 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 do 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 External Dependency Manager sejam removidos da pasta Assets , usando um dos métodos a seguir.

    IU do Gerenciador de Pacotes

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

    Remoção manual

    Usando as 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.