获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

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

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.