Guia de notas de versão
Lançamentos do Citron: notas de versão e guia de builds
Use as páginas oficiais do GitHub para identificar uma versão estável, ler as mudanças, escolher o arquivo da sua plataforma e manter um ponto de retorno.
O que verificar em um lançamento do Citron?
Os lançamentos do Citron ficam divididos entre uma tag datada no repositório citron-neo/emulator e builds de plataforma que avançam no citron-neo/CI. A página estável mostra atualmente a tag 2026-04-27. Uma página CI pode publicar um commit upstream mais novo sem mudar essa tag. Registre repositório, tag ou commit, plataforma e data de publicação.
A descrição oficial explica o que mudou e o que pode ter sido movido. Leia antes de substituir um build que funciona: uma correção de renderer, invalidação de cache, mudança de configuração ou regressão de plataforma pode alterar a decisão de atualização. O título sozinho não é evidência.
Em 23 de outubro de 2026, as páginas oficiais mostravam um build CI de Linux baseado no commit 598b700 e datado de 16 de outubro. É um exemplo com data, não uma promessa de que todas as plataformas usem o mesmo commit. Os canais CI avançam separadamente; abra novamente a página da sua plataforma antes de instalar.
Mapa atual de versões
Lançamentos do Citron verificados em 23 de outubro de 2026
Estas identidades explicam o objetivo de cada página. As datas são registros de verificação e devem ser conferidas novamente antes da instalação.
Tag estável: 2026-04-27
A tag com data é a melhor base para um teste repetível. Ela muda menos que um canal CI e oferece um ponto de restauração claro.
Fonte: github.com/citron-neo/emulator/releasesBuilds CI usam commits upstream
O repositório CI publica builds para Windows, Linux, macOS e Android. Um commit curto é mais útil que um rótulo genérico como latest.
Fonte: github.com/citron-neo/CI/releasesExemplo CI Linux: 598b700
A versão Linux consultada listava o commit 598b700 e a data 2026-10-16. Confira novamente a tag atual.
Página CI oficial verificada em 23/10/2026Notas de release não são arquivos de jogos
Um release do GitHub contém arquivos e notas do projeto, não jogos protegidos, arquivos privados de console ou chaves.
Separe os arquivos do emulador dos seus arquivos legais
Leia a identidade antes do changelog
Um registro curto evita tratar cada tag móvel como a mesma versão. Salve primeiro a identidade e depois interprete as notas.
| Canal | Identidade a salvar | O que as notas indicam | Ação prática |
|---|---|---|---|
| Estável | Tag 2026-04-27 | Notas e arquivos datados | Usar como base |
| CI Linux | 598b700, 16/10/2026 | Commit upstream e formatos | Testar se o ajuste for necessário |
| CI Windows, Android, macOS | Tag e commit da plataforma | Estado específico do sistema | Conferir cada página |
| Arquivo de código-fonte | ZIP gerado pelo GitHub | Snapshot de desenvolvimento | Não usar como instalador |
A página oficial do release é o destino do download. Evite CDN inventada, links encurtados, instaladores reempacotados e espelhos sem contexto.
Leitura das notas
Quatro sinais úteis nas notas do Citron
As notas são mais úteis quando respondem a uma decisão concreta. Procure estes sinais antes de baixar uma atualização.
Escopo de compatibilidade ou regressão
Procure menções a jogo, renderer, controle, sistema operacional ou firmware. Uma correção local não melhora todas as plataformas automaticamente.
- Registre o subsistema ou a plataforma.
- Diferencie corrigido, alterado, experimental e problema conhecido.
- Mantenha o build atual se a nota não tratar do seu problema.
Mudanças de configuração e cache
Uma versão pode invalidar shader cache, mover uma pasta de usuário, alterar padrões ou exigir uma primeira execução limpa.
- Faça backup da sua configuração.
- Não copie cache antigo sem motivo.
- Siga a migração indicada na nota.
Pistas do arquivo e da arquitetura
Os nomes podem distinguir x64, x86_64_v3, aarch64, Android ou macOS. Escolha o pacote que corresponde ao dispositivo.
- Confirme sistema e arquitetura.
- Trate AppImage, ZIP, DMG e APK como formatos diferentes.
- Leia a descrição quando o sufixo for incomum.
Pistas para retorno e relatório
Commit, data e notas deixam um relatório de regressão mais útil. Salve esses detalhes antes do teste.
- Mantenha o build anterior.
- Anote cenário e configurações.
- Informe a identidade, não apenas latest.
Escolha o arquivo da plataforma sem adivinhar
As notas explicam a mudança e a lista de assets mostra o que pode rodar no aparelho. Use as duas informações.
Confirme o proprietário
O endereço deve estar em github.com/citron-neo/ e corresponder ao repositório esperado.
Copie tag ou commit
Salve a tag estável ou o commit completo mostrado na descrição antes do download.
Combine o sistema
ZIP do Windows, AppImage/tar.zst do Linux, DMG do macOS e APK do Android são formatos diferentes.
Combine a arquitetura
Escolha x86_64, x86_64_v3, aarch64 ou Apple silicon somente quando corresponder ao dispositivo.
Preserve o contexto
Baixe pela lista de Assets para manter nome, data, notas e repositório visíveis.
Decisão de atualização
Quando testar novos lançamentos do Citron
Mais recente não significa automaticamente melhor. Relacione o update a um problema específico e compare com a base.
Use a tag estável como controle
Escolha a versão datada para primeira configuração, comparação repetível ou verificação de uma regressão CI.
- Faça o primeiro início com stable.
- Registre renderer, controle e conteúdo.
- Mantenha stable durante o teste de outro canal.
Use CI quando uma mudança justificar
Um build CI faz sentido quando as notas correspondem ao bug ou ajuste de plataforma procurado. O resultado melhor não é garantido.
- Mude uma variável por vez.
- Guarde commit e plataforma.
- Volte para stable se o resultado piorar.
Fluxo seguro de atualização
Teste um novo release de forma repetível
Esta sequência mantém a comparação clara e cria evidência suficiente para desfazer uma mudança.
Descreva o problema primeiro
Anote o que falha, em qual plataforma, com qual conteúdo e se stable já apresenta o problema.
Leia as notas correspondentes
Abra a tag oficial ou o release CI e procure correção, regressão, cache ou migração.
Registre a identidade
Salve repositório, tag ou commit, data, nome do arquivo e arquitetura antes de baixar.
Faça backup da configuração
Preserve configuração, saves e build funcional. O novo arquivo não é backup.
Teste uma variável
Use o mesmo aparelho, ajustes e caso de teste. Não mude build e renderer juntos.
Mantenha ou reverta
Compare com a base e mantenha o novo somente se resolver o problema sem regressão bloqueante.
Plano de retorno
Mantenha uma versão conhecida antes do update
O retorno mais simples usa pastas separadas. Mantenha stable 2026-04-27 em uma pasta, teste CI em outra e não misture cache ou configuração até concluir o teste.
Se o novo build não iniciar, mostrar tela preta, mudar controles ou ficar mais lento, abra primeiro a pasta stable. Não altere drivers, firmware e gráficos ao mesmo tempo.
Se foi necessário substituir o build, restaure seu backup e repita o mesmo teste. Registre o commit que causou a regressão e o que recuperou o resultado.
- Mantenha stable e CI em pastas separadas.
- Faça backup da configuração e dos saves antes de substituir.
- Restaure a base antes de mudar ajustes.
- Guarde URL, commit, nome do asset e notas juntos.
Problemas ligados aos lançamentos
Use a identidade da versão para limitar a causa antes de mudar configurações sem relação.
| Sintoma | Verifique primeiro | Próximo passo |
|---|---|---|
| A página diz latest, mas não há tag clara | Leia repositório, tag ou commit e data. | Registre a identidade e evite espelhos. |
| O novo build não inicia | Confirme sistema, arquitetura, formato e pasta limpa. | Volte ao build conhecido antes de ajustar. |
| O jogo mudou de comportamento | Procure mudanças de renderer, cache ou compatibilidade. | Repita o teste em stable com as duas identidades. |
| ZIP de fonte parece instalador | Leia o rótulo do asset e o contexto. | Escolha o pacote pronto para a plataforma. |
FAQ
FAQ sobre os lançamentos do Citron
Onde estão os lançamentos oficiais do Citron?
Use Releases de citron-neo/emulator para tags datadas e Releases de citron-neo/CI para builds por plataforma. Confirme o proprietário na URL.
Qual é a versão stable verificada?
A tag estável verificada em 23 de outubro de 2026 é 2026-04-27. Reabra a página oficial antes de instalar.
Um commit CI é uma versão stable?
Não. Um commit CI identifica um build automatizado que pode ser mais novo e ter mudanças ou regressões próprias da plataforma.
Como ler as notas de um release Citron?
Comece pela identidade e procure compatibilidade, renderer, cache, migração de configuração, problemas conhecidos e observações do asset.
Um release fornece jogos, firmware ou chaves?
Não. Ele fornece arquivos e notas do projeto. Use apenas arquivos que você possa obter legalmente por suas próprias fontes.
O que fazer se uma versão nova quebrar o setup?
Volte para stable, mantenha o novo build separado e anote commit, asset, cenário e regressão antes de relatar.
Fontes oficiais
Fatos e links de versões
Os exemplos de lançamentos do Citron vêm de páginas oficiais verificadas em 23/10/2026. Confira-as de novo para obter um asset atual.
- Releases de citron-neo/emulatorTags datadas, descrições e assets estáveis.
- Releases de citron-neo/CIBuilds de Windows, Linux, macOS e Android.
- Citron NEO all buildsÍndice que devolve a verificação ao GitHub.