Atualizando React Native em seu projeto: O que você precisa saber

Se você chegou até aqui é provavelmente porque percebeu que as bibliotecas do seu projeto estão desatualizadas, queria instalar uma nova e a versão que está usando não é suportada, ou simplesmente quer acessar novas funcionalidades de versões mais atuais do React Native e melhorar a experiência do usuário e do desenvolvimento.

A atualização para novas versões do React Native lhe dará acesso a mais APIs, novas bibliotecas, melhorias de desempenho, entre outros detalhes positivos. A atualização exige um pouco de esforço, mas com este artigo tentamos prepará-lo para que tudo corra bem.

Vamos focar em projetos desenvolvidos apenas com React Native e darei as recomendações mais importantes para que você atualize seu projeto React Native sem morrer tentando.

Recomendações

1. Leia a documentação oficial do React Native. Sabemos que às vezes não gostamos de ler, mas vamos direto à ação. Muitas vezes isso só gera mais atrasos, pois ao pular uma etapa causamos erros desnecessários. Portanto, devemos tornar a documentação nossa melhor amiga quando quisermos atualizar nosso aplicativo.
   
2. Não atualize para a versão mais recente. Um erro comum é tentar atualizar diretamente para a versão mais recente quando estamos quatro ou mais versões abaixo da atual. Isso faz com que todas as alterações e erros de cada um dos anteriores se acumulem, ou seja, adicionamos erros ao mesmo tempo em que atualizamos. Isso aumenta a complexidade, por isso é sempre melhor fazer as atualizações gradualmente, principalmente se houver mudanças na arquitetura React Native dentro delas.
   
3. Apoie-se na comunidade. A comunidade React Native do GitHub nos permite compartilhar experiências de desenvolvimento e fornecer soluções onde muitos de nós frequentemente precisam de ajuda. Também promove o aprendizado sobre novos recursos. O que mais vai nos ajudar na hora de atualizar nosso projeto é que, com certeza, os erros que você está enfrentando já foram resolvidos nas questões do repositório React Native.
   
4. Aplique o princípio da estrela dos desenvolvedores: divida e conquiste. Assuma o controle de resolver seus conflitos passo a passo. Primeiro, certifique-se de que seu projeto funcione perfeitamente para Android (faça o mesmo para iOS). Atualize, remova ou substitua bibliotecas que não funcionam corretamente, resolva erros de código, corrija quaisquer problemas de interface do usuário que possam aparecer e, finalmente, analise e corrija quaisquer avisos relatados pelo React Native. Isso facilitará muito o trabalho e garantirá que nossa atualização foi executada corretamente.

Projetos React Native típicos são essencialmente compostos por um projeto Android, um projeto iOS e um projeto JavaScript. A atualização pode ser bastante tediosa, mas se você aplicar nossas recomendações, o processo será mais tranquilo.

Atualmente, existem duas maneiras de atualizar nosso projeto React Native: usando o React Native CLI ou manualmente via Upgrade Helper.

O que é a CLI do React Native?

É uma ferramenta de linha de comando que vem via React Native na forma de @react-native-community/clippackage.

Como atualizar com o React Native CLI?

Se você deseja atualizar para a versão mais recente, basta colocar este comando no terminal do seu projeto:

npx react-native upgrade

Porém, muitas vezes não é isso que queremos, principalmente nos casos em que utilizamos mais de quatro versões anteriores, com projetos muito grandes e utilizamos muitas bibliotecas.

Portanto, se você tiver uma versão específica para a qual deseja migrar, deverá executar o seguinte comando:

npx react-native upgrade number_version-upgrade

Em seguida, resolva os conflitos. Os arquivos em conflito incluem delimitadores que deixam muito claro de onde vêm as alterações.

¿Qué es React Native Upgrade Helper?

É um site que nos permite colocar a versão do React Native que temos na qual queremos atualizar e ver quais mudanças ocorreram entre uma versão e outra, com recomendações do que devemos ver antes de atualizar e por que atualizar nosso projeto.

¿Cómo actualizar React Native con React Native Upgrade Helper?

Primeiro, você deve selecionar a versão em que seu projeto está e a versão para a qual deseja atualizar. Por padrão, as versões principais mais recentes são selecionadas. Depois de selecionar, você pode clicar no botão Mostre-me como atualizar e encontrará as informações necessárias para fazer as alterações necessárias em seu projeto.

O primeiro arquivo exibido é o package.json. Minha recomendação sempre será que você atualize todas as dependências que estão aí, junto com as que eles recomendam.

Então atualize. A nova versão pode conter atualizações para outros arquivos que são gerados quando você executa npx react-native init. Esses arquivos estão listados após package.json na web React Native Upgrade Helper. Se não houver outras alterações, você só precisará reconstruir o projeto para continuar o desenvolvimento.

Caso haja alterações, você pode atualizá-las manualmente copiando e colando as alterações da Web do React Native Upgrade Helper ou pode fazê-lo com o comando de atualização do React Native CLI, conforme explicado aqui.

Por fim, certifique-se sempre de que sua versão do React Native use as dependências corretas.

Depois que seu projeto for atualizado e estiver estável, considere atualizar regularmente para minimizar o pesadelo de atualização que muitos desenvolvedores enfrentam quando param de atualizar.

Espero que este conteúdo tenha sido útil e que ajude você a atualizar o React Native sem sofrimento. Até logo!