Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Em vez de baixar um grande arquivo .zip 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 .NET 4.X .unitypackage 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 ativos

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

  • Se você estiver usando vários produtos Firebase em seu projeto, deverá baixar e atualizar 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 Firebase com o fluxo de pacote Asset e usando o fluxo Unity Package Manager.

Após o download, para importar:

  1. Em seu projeto Unity aberto, 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 Firebase de arquivos .tgz baixados do arquivo 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, deverá baixar e atualizar 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 Firebase com o fluxo de pacote Asset e com o fluxo Unity Package Manager.

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

    1. Gerenciador de dependência externa ( com.google.external-dependency-manager )
    2. Firebase Core ( com.google.firebase.app )
    3. Produtos Firebase usados ​​em seu projeto. Se você usar o Realtime Database ou o Cloud Storage, importe Authentication ( com.google.firebase.auth ) primeiro.

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

interface do usuário 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 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 mudar de usar o Unity Package Manager para rastrear produtos 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 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. Observe as versões atuais do pacote Firebase em seu projeto e remova-as.

    1. No menu Janela , selecione Gerenciador de Pacotes . Na janela Gerenciador de pacotes , certifique-se de que "Pacotes: no projeto" esteja selecionado.
    2. Observe as versões dos pacotes Firebase importados.
    3. Clique no nome de cada pacote e clique em Remover . Certifique-se de remover o pacote do 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 atualizar para a versão mais recente de cada pacote, baixe o arquivo zip do Firebase Unity SDK e importe-o conforme descrito em Adicionar Firebase ao seu projeto Unity .
    • Se 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 alternar da importação de produtos na pasta Assets para a 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 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 Firebase e o pacote External Dependency Manager sejam removidos da pasta Assets , usando um dos seguintes métodos.

    interface do usuário 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 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.