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:
Em seu projeto aberto do Unity, navegue até Assets > Import Package > Custom Package .
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:- Gerenciador de dependência externa (
com.google.external-dependency-manager
) - Núcleo do Firebase (
com.google.firebase.app
) - 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.
- Gerenciador de dependência externa (
Após o download, importe arquivos .tgz
para seu projeto usando um dos seguintes métodos:
IU do Gerenciador de Pacotes
- Abra a janela Gerenciador de Pacotes do Unity.
- Clique no ícone
+
no canto superior esquerdo da janela do Gerenciador de Pacotes e selecioneAdd package from tarball
para abrir o navegador de arquivos. - 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á:
- Descompacte o arquivo
.tgz
. - Clique no ícone
+
no canto superior esquerdo da janela do Gerenciador de Pacotes e selecioneAdd package from disk
para abrir o navegador de arquivos. - Selecione a pasta extraída no navegador de arquivos.
manifest.json
- Crie uma nova pasta ao lado da pasta
Packages
do seu projeto e nomeie-a comoGooglePackages
. - Coloque os arquivos
.tgz
nessa pasta. - Use um editor de texto para abrir
Packages/manifest.json
na pasta do projeto do Unity. 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 importandocom.google.firebase.storage
e suas dependências, seumanifest.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... } }
Salve o arquivo
manifest.json
.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:
- Descompacte o arquivo
.tgz
. 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:
Anote as versões atuais do pacote do Firebase em seu projeto e remova-as.
- No menu Janela , selecione Gerenciador de Pacotes . Na janela Gerenciador de Pacotes , certifique-se de que "Packages: In Project" esteja selecionado.
- Observe as versões dos pacotes importados do Firebase.
- 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.
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:
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
- Em seu projeto Unity aberto, navegue até Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages .
- Selecione todos os pacotes do Firebase e o External Dependency Manager.
- 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
Importe pacotes usando o Unity Package Manager, conforme descrito acima nesta página.