React conta com uma próspera comunidade de código aberto para registrar relatórios de bugs, abrir pull requests e enviar RFCs. Para incentivar feedback, às vezes compartilhamos builds especiais do React que incluem recursos não lançados.
\n\n\nEste documento será mais relevante para desenvolvedores que trabalham em frameworks, bibliotecas, ou ferramentas de desenvolvedor. Os desenvolvedores que usam React principalmente para criar aplicações voltadas para o usuário final não precisam se preocupar com nossos canais de prerelease.
\n
Cada um dos canais de release do React foram projetados para um caso de uso distinto:
\nTodos os releases são publicados no npm, mas apenas os Latest usam versionamento semântico. Os prereleases (aqueles nos canais Next e Experimental) têm versões geradas a partir de um hash de seu conteúdo, por exemplo 0.0.0-1022ee0ec para Next e 0.0.0-experimental-1022ee0ec para Experimental.
O único canal de release oficialmente suportado para aplicações voltadas para o usuário final é o Latest. Next e Experimental releases são fornecidos apenas para fins de teste e não fornecemos garantias de que o comportamento não seja alterado entre as versões. Eles não seguem o protocolo semver que usamos para releases no Latest.
\nPor publicar prereleases no mesmo registro que usamos para releases estáveis, podemos tirar proveito das muitas ferramentas que suportam o fluxo de trabalho no npm, como unpkg e CodeSandbox.
\nLatest é o canal usado para releases estáveis do React. Corresponde à tag latest no npm. É o canal recomendado para todos os apps React que são enviados para usuários reais.
Se você não tem certeza de qual canal deve usar, é o Latest. Se você é um desenvolvedor React, é isso que você já está usando.
\nVocê pode esperar que as atualizações do Latest sejam extremamente estáveis. As versões seguem o esquema de versão semântica. Saiba mais sobre nosso compromisso com a estabilidade e a migração incremental em nossa política de versão.
\nO canal Next é um canal de prerelease que acompanha a branch master do repositório React. Usamos as prereleases no canal Next como release candidates para o canal Latest. Você pode pensar em Next como um superconjunto de Latest que é atualizado com mais frequência.
\nO grau de alteração entre o release mais recente do Next e a versão mais recente do Latest é aproximadamente o mesmo que você encontraria entre dois releases de minor semver. No entanto, o canal Next não está de acordo com o controle de versão semântico. Você deve esperar breaking changes ocasionais durante sucessivos releases no canal Next.
\nNão use prereleases em aplicações voltadas para o usuário final.
\nReleases no Next são publicadas com a tag next no npm. As versões são geradas a partir de um hash do conteúdo do build, por exemplo 0.0.0-1022ee0ec.
O canal Next foi projetado para dar suporte aos testes de integração entre React e outros projetos.
\nTodas as alterações no React passam por extensos testes internos antes de serem lançadas para o público. No entanto, há uma infinidade de ambientes e configurações usados em todo o ecossistema React, e não é possível testar cada um deles.
\nSe você é o autor de um projeto de terceiros como um framework, biblioteca, ferramenta de desenvolvedor, ou qualquer tipo de infraestrutura semelhante, você pode nos ajudar a manter o React estável para seus usuários e para toda a comunidade React executando periodicamente sua suíte de testes nas alterações mais recentes. Se você estiver interessado, siga estas etapas:
\nNo cron job, atualize seus pacotes React para o release mais recente do React no canal Next, usando a tag next no npm. Usando o npm cli:
npm update react@next react-dom@nextOu yarn:
\nyarn upgrade react@next react-dom@nextUm projeto que usa esse fluxo de trabalho é Next.js. (Sem trocadilhos! Sério!) Você pode consultar a sua configuração do CircleCI como exemplo.
\nComo o Next, o canal Experimental é um canal de prerelease que acompanha a branch master do repositório React. Ao contrário do Next, os releases Experimental incluem recursos e APIs adicionais que não estão prontas para release maior.
\nGeralmente, uma atualização para Next é acompanhada por uma atualização correspondente para Experimental. Eles são baseados na mesma revisão de origem, mas são criados usando um conjunto diferente de flags de recursos.
\nOs releases Experimental podem ser significativamente diferentes dos releases Next e Latest. Não use releases Experimental em aplicações voltadas para o usuário final. Você deve esperar breaking changes frequentes entre releases no canal Experimental.
\nReleases no Experimental são publicados com a tag experimental no npm. As versões são geradas a partir de um hash do conteúdo do build, por exemplo 0.0.0-experimental-1022ee0ec.
Recursos experimentais são aqueles que não estão prontos para serem liberados ao público em geral e podem sofrer alterações drásticas antes de serem finalizados. Alguns experimentos podem nunca ser finalizados - a razão pela qual temos experimentos é testar a viabilidade das alterações propostas.
\nPor exemplo, se o canal Experimental existisse quando anunciamos Hooks, teríamos lançado Hooks no canal Experimental semanas antes de estarem disponíveis no Latest.
\nVocê pode achar valioso executar testes de integração no Experimental. Isso é com você. No entanto, saiba que o Experimental é ainda menos estável que o Next. Não garantimos estabilidade entre releases Experimental.
\nRecursos Experimentais podem ou não ser documentados. Geralmente, os experimentos não são documentados até que estejam perto de serem lançados no Next ou no Latest.
\nSe um recurso não estiver documentado, ele poderá ser acompanhado por um RFC.
\nPublicaremos no blog React quando estivermos prontos para anunciar novos experimentos, mas isso não significa que divulgaremos cada experimento.
\nVocê sempre pode consultar o histórico do repositório público do GitHub para obter uma lista abrangente de alterações.
","frontmatter":{"title":"Canais de Release","next":"hello-world.html","prev":"cdn-links.html"},"fields":{"path":"content/docs/release-channels.md","slug":"docs/release-channels.html"}}},"pageContext":{"slug":"docs/release-channels.html"}},"staticQueryHashes":[]}