Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

O site oferece:

  • Individual .NET 4.X .unitypackage arquivos para instalar como pacotes de ativos.
  • Individuais .tgz arquivos para instalar usando Unity Package Manager.

Isto é especialmente útil quando o aplicativo usa um único produto Firebase, desde os individuais .unitypackage arquivos contêm todas as dependências necessárias, e os .tgz arquivos são listados ao lado relacionados .tgz arquivos dos quais dependem.

Esta página fornece instruções envolvendo Unidade Package Manager, por isso é uma boa idéia para aprender sobre a ferramenta a partir da documentação Unity .

Instale os pacotes do Firebase como ativos

Ao instalar produtos Firebase de .unitypackage arquivos baixados do Google APIs para o site Unity , mantenha em mente o seguinte:

  • Se estiver usando vários produtos Firebase em seu projeto, você deve baixar e atualizar todos os produtos Firebase para a mesma versão.

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

Após o download, para instalar:

  1. Em seu projeto aberto Unidade, navegar para o Ativo> Importar pacote> pacote personalizado.

  2. Na janela Importar Unidade Package, clique em Importar.

Instale os pacotes do Firebase usando o Unity Package Manager

Ao instalar produtos Firebase de .tgz arquivos baixados os APIs do Google para arquivamento Unity , mantenha em mente o seguinte:

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

  • Se estiver usando vários produtos Firebase em seu projeto, você deve baixar e atualizar todos os produtos Firebase para a mesma versão.

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

  • Dependências para cada produto .tgz arquivo estão ligados em paralelo com os seus próprios .tgz arquivos. Você deve baixar e instalar o produto .tgz arquivo e dependência .tgz arquivos, na ordem correta:

    1. Dependência gestor externo ( com.google.external-dependency-manager )
    2. Firebase Núcleo ( com.google.firebase.app )
    3. Produtos do Firebase usados ​​em seu projeto. Se você usar Realtime banco de dados ou armazenamento em nuvem, instale Authentication ( com.google.firebase.auth ) em primeiro lugar.

Após o download, importação .tgz arquivos em seu projeto usando um dos seguintes métodos:

Interface do usuário 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 são compatíveis com a adição direta de tarballs. Nesse caso, você precisará:

  1. Descompacte o .tgz arquivo.
  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 do seu projeto Packages de pasta e nomeá-la GooglePackages .
  2. Coloque as .tgz arquivos para essa pasta.
  3. Use um editor de texto para abrir Packages/manifest.json sob sua pasta de projeto Unity.
  4. Adicione uma entrada para cada pacote que deseja instalar, mapeando o nome do pacote para o local no disco. Certifique-se de anexar file: ao .tgz caminho de arquivo. Por exemplo, se você estava instalando com.google.firebase.storage e seus de dependência, o 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 manifest.json arquivo.

  6. Quando Regains Unidade concentrar ele vai recarregar o manifest.json e importar os pacotes recém-adicionados.

Algumas versões mais antigas do Unity não suportam .tgz arquivos na manifest.json . Nesse caso, você deve:

  1. Descompacte o .tgz arquivo.
  2. Editar seu manifest.json de usar o caminho para a pasta extraída, em vez do .tgz arquivo, 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 os pacotes de ativos

Em alguns casos, você pode querer mudar de usar Unity Package Manager para rastrear produtos Firebase, para a instalação de produtos sob a Assets pasta.

Se você não tiver certeza de qual método de instalação que você está usando, na pasta do projeto Unidade, abra o arquivo Packages/manifest.json . Se o arquivo contém entradas começando com com.google.firebase , seu projeto utilizou Unidade Package Manager para a instalação.

Para migrar para pacotes de ativos:

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

    1. A partir do menu Janela, selecione Package Manager. Na janela do Gerenciador de Pacotes, certifique-se de "Pacotes: No Project" é selecionado.
    2. Observe as versões dos pacotes do Firebase instalados.
    3. Clique em cada nome de pacote, clique em Remover. Certifique-se de remover o pacote externo Dependência Manager ( .com.google.external-dependency-manager ), bem como pacotes Firebase.
  2. Faça o download e de substituição de importação .unitypackage arquivos. Você tem duas opções:

    • Se você pode atualizar para a versão mais recente de cada pacote, baixe o arquivo zip Firebase Unidade SDK e instalar conforme descrito em Add Firebase ao seu projeto Unity .
    • Se você precisa para preservar atuais .unitypackage versões, você pode baixar e instalar pacotes individuais, como descrito acima nesta página.

Migrar de pacotes de ativos para o Unity Package Manager

Em alguns casos, você pode querer mudar de instalação de produtos sob os Assets pasta para a instalação e acompanhamento de produtos Unidade Package Manager.

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

Para migrar para o Unity Package Manager:

  1. Certifique-se de todos os pacotes Firebase e o pacote externo Dependência Manager são removidos do Assets pasta, usando um dos seguintes métodos.

    Interface do usuário do gerenciador de pacotes

    1. Em seu projeto aberto Unidade, navegar para o Ativo> Externo Dependência Manager> Versão Handler> Desinstalar Managed Packages.
    2. Selecione todos os pacotes do Firebase e o Gerenciador de dependência externa.
    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. Instalar pacotes usando Unity Package Manager, conforme descrito acima nesta página.