Aprendendo a programar jogos em Unity: migrando um projeto entre versões de mesma família

Experimentaremos na prática a migração de um projeto entre versões diferentes de editores do Unity.

em 25/10/2026
Seja bem-vindo(a) ao GameDev: Aprendendo a programar jogos em Unity de hoje! Após conhecermos, em nosso encontro anterior, as principais características e diferenças entre versões do Unity, realizaremos hoje a migração de um projeto entre versões distintas do editor, observando e entendendo melhor alguns percalços que são comuns em processos desta natureza.


Se hoje for a primeira vez que você tem contato com conteúdos de nossa série, não perca tempo e venha conosco trilhar uma estrada de novos conhecimentos, a respeito do universo de desenvolvimento de jogos digitais.

Elaborando projetos de programação de games de forma prática, aprendemos diferentes conceitos relacionados ao processo de criação de um jogo, tanto no que se refere a seus aspectos visuais e sonoros quanto a respeito de mecânicas de gameplay utilizadas e elaboração de regras e de scripts controladores de comportamentos.

A partir do primeiro tópico da série, é possível acompanhar a elaboração de três jogos distintos, cada um com elementos próprios que definem seus estilos gráficos e de gameplay: Forest Ping Pong, jogo inspirado no clássico Pong (Atari, 1972); Motorista da Pesada, um platformer rodoviário, com aspectos de gameplay baseados nos do arcade japonês City Connection (Jaleco, 1985); e Consultório do Dr. Tratanildo, um puzzle tridimensional ambientado em um excêntrico consultório médico, com elementos inspirados em games dos anos 1980 e 1990, como Dr. Mario (Nintendo, 1990), Pac-Man (Namco, 1980) e Tama (Time Warner Interactive, 1994).


Todas as etapas de desenvolvimento dos jogos são detalhadas em mais de 140 textos, que cobrem desde a instalação e a configuração da ferramenta Unity em nossos computadores até as etapas em que são elaborados os elementos pertencentes a cada uma das aventuras virtuais: cenários, personagens, adversários, itens, regras e fases.

Por meio da elaboração dos três jogos, você poderá entender e experimentar diferentes conceitos utilizados na construção de jogos 2D e 3D, de variados níveis de complexidade, para que possa, posteriormente, aplicá-los a seus projetos pessoais. Os conceitos são abordados utilizando exemplos práticos, que permitem até a quem não teve oportunidade prévias em programação de jogos ou de sistemas tirar do papel os projetos que sempre sonhou.

Se você gostou da ideia de aprender a programar seus próprios jogos, aperte os cintos e junte-se a nós em uma jornada repleta de novos conhecimentos e de muita diversão!

Preparações para migração

Embora as migrações de projetos entre versões diferentes do Unity não costumam ser muito traumáticas, é importante realizar algumas verificações prévias, a fim de não passarmos por dores de cabeça desnecessariamente, devido a alguma incompatibilidade que surja durante o processo.

A primeira recomendação que faço é a de se realizar uma cópia da pasta inteira do projeto, guardando-a como um backup, caso algum problema mais complexo seja identificado. No exemplo a seguir, realizo uma cópia da pasta do projeto de Consultório do Dr. Tratanildo para que possamos migrá-lo para uma versão mais recente do editor.

Em seguida, abriremos o Unity Hub e clicaremos sobre a opção Installs, no canto superior esquerdo da janela. Note a presença da versão 2020.3.48f1, com um indicativo de alerta de segurança; ao posicionarmos o mouse sobre este alerta, nos é indicado a instalação de uma versão atualizada do editor, para mitigar os riscos nos projetos desenvolvidos com esta versão.

Instalaremos e utilizaremos esta nova versão, tanto como boa prática para protegermos nossos projetos, quanto para experimentarmos o processo de migração como um todo, com uma nova versão pertencente à mesma família e linha da utilizada anteriormente.

Clique no botão Install Editor, no canto superior direito da janela (botão azul). Uma nova janela será exibida (Install Unity Editor), selecione a opção Archive e configure as opções conforme segue:
  • Version: 2020;
  • Resease Stream: LTS.
Note a presença da versão 2020.3.48f1 na lista, indicada como já instalada. Clique sobre a opção Install referente à versão 2020.3.49f1.

Selecione a s opções Android Build Support (e subitens), Universal Windows Platform, WebGL e Windows Build Support, antes de prosseguir. Não será necessário selecionarmos desta vez a opção para instalação do Visual Studio Community, pois já temos ele instalado em nossa máquina.

Após a seleção das opções, clique em Continue. Caso alguma opção adicional seja apresentada para confirmação, prossiga selecionando-as.


Ao término do processo, na seção Installs do Unity Hub, as duas versões serão exibidas em tela, conforme podemos observar na imagem a seguir:

Em seguida, voltaremos à seção Projects do Unity Hub. Abra o projeto Consultório do Dr. Tratanildo, ainda configurado para ser editado pela versão antiga do Unity (2020.3.48f1), clicando sobre sua entrada na listagem de projetos.

Após o editor carregar o projeto, vá ao menu Window e, em seguida, abra a opção Package Manager. Selecione a opção Packages: In Project (em destaque, na imagem a seguir) e anote os pacotes que o projeto está utilizando no momento.

Embora não seja estritamente necessária, esta ação nos auxiliará em casos em que o projeto se recuse a ser iniciado após iniciarmos a migração entre versões do editor.

Em seguida, feche a janela Package Manager e o editor do Unity, para começarmos, de fato, o processo de migração do projeto.

Atualizando um projeto na prática

De volta ao Unity Hub, com a tela de projetos em evidência, clique sobre o campo Editor version, referente ao projeto Consultório do Dr. Tratanildo. Na janela que for exibida, selecione a instalação 2020.3.49f1 e, em seguida, no botão Open with 2020.3.49f1.

O Unity Hub irá apresentar um alerta em tela, solicitando uma confirmação para prosseguirmos com o processo. Clique em Change Version para que a migração entre versões seja iniciada.


Com o início do processo, o Unity Hub irá inicializar o editor mais recente. Em seguida, será exibida a seguinte janela de confirmação: após clicarmos em Continue, não será mais possível abrir o projeto na versão antiga do Unity.


O processo de atualização, de fato, será iniciado pelo Unity, cujo andamento pode ser acompanhado por meio de uma pequena janela com uma barra de progresso, similar à reproduzida pela imagem a seguir.


Ao término, se tudo der certo, seu projeto será exibido na interface do editor do Unity, versão 2020.3.49f1.

É recomendável realizar uma bateria de testes no projeto, logo após a migração para uma nova versão, visando observar eventuais mudanças indesejadas de comportamento. Algumas personalizações, como a resolução da simulação na aba Game, devem ser ajustadas manualmente.

Após as devidas simulações, salve a cena (menu File, Save) e o projeto (menu File, Save Project) antes de fechar o Unity.

Próximos passos

Pudemos perceber que, sob condições normais, a migração de um projeto entre versões do editor que pertençam à mesma família e linha normalmente não acaba por trazer grandes dores de cabeça ao desenvolvedor, sobretudo pelo fato de que a maior parte das alterações e correções realizadas no editor nem são visíveis por quem usa a ferramenta, sob essas circunstâncias (mesma família / linha).

Contudo, esse processo nem sempre é “florido”: nos próximos encontros, iremos observar o que pode ocorrer durante a migração entre famílias ou linhas de versões diferentes e, também, na abertura direta de projetos criados em versões anteriores do Unity nas mais recentes.

As ações preventivas que realizamos, como a anotação dos pacotes utilizados e a cópia de segurança da pasta do projeto, serão úteis neste momento.

Nos encontraremos novamente no dia 1 de novembro. Até mais! Fique ligado sempre nas novidades do GameBlast!

Revisão: Ives Boitano
Siga o Blast nas Redes Sociais
Rodrigo Garcia Pontes
Entendo videogames como sendo uma expressão de arte e lazer e, também, como uma impactante ferramenta de educação. No momento, doutorando em Sistemas da Informação pela EACH-USP, desenvolvendo jogos e sistemas desde 2020. Se quiser bater um papo comigo, nas redes sociais procure por @RodrigoGPontes.
Este texto não representa a opinião do GameBlast. Somos uma comunidade de gamers aberta às visões e experiências de cada autor. Você pode compartilhar este conteúdo creditando o autor e veículo original (BY-SA 4.0).