Como atualizar o Dusklight com segurança

Verifique a release oficial do Dusklight antes de atualizar

Comece pela fonte da release, não por um resultado de busca ou um botão de download com destino oculto. A release oficial do GitHub verificada para esta página é a v1.4.1 e lista pacotes separados para Windows, Linux, macOS, Android e iOS. Compare nome do arquivo, tipo do pacote e arquitetura com o dispositivo que será atualizado.

Um número de versão não basta. Leia as notas da release para identificar mudanças em gráficos, controles, texturas, caminhos de arquivos e assinatura mobile. Se uma versão nova for mais recente que a citada em um guia antigo, atualize os fatos e os passos antes de copiar qualquer arquivo.

Não misture um aplicativo novo com arquivo de jogo aleatório, pasta de configuração antiga ou arquivo de mod não verificado. Dusklight é o aplicativo de código aberto; os dados de Twilight Princess continuam sendo responsabilidade do usuário. Teste o novo build com os mesmos dados compatíveis antes de adicionar outra variável.

1. Abra a release oficialUse o site da TwilitRealm ou a release oficial do GitHub e anote a tag e a data de publicação.
2. Escolha o pacote certoConfira sistema operacional, formato e arquitetura para Windows, Linux, macOS, Android ou iOS.
3. Leia as notasProcure mudanças em gráficos, entrada, texturas, saves, armazenamento e assinatura.
4. Preserve uma cópia funcionalNão sobrescreva o build antigo antes do primeiro início bem-sucedido do novo pacote.

Faça backup dos saves, configurações e do build atual

Feche o Dusklight antes de copiar os dados do usuário. Quando possível, faça backup da pasta de dados completa em vez de escolher apenas o arquivo que parece ser um salvamento. Os locais de desktop documentados pelo projeto são %APPDATA%/TwilitRealm/Dusklight no Windows, ~/Library/Application Support/TwilitRealm/Dusklight no macOS e ~/.local/share/TwilitRealm/Dusklight no Linux. No mobile, o armazenamento depende do sistema e do método de instalação.

Nomeie o backup com data, versão, plataforma e região. Mantenha-o fora da pasta ativa para que extrair um novo arquivo ou desinstalar o aplicativo não remova a única cópia. Para transferir um salvamento com o Dolphin, use o guia específico e confirme região e formato antes de substituir os dados.

Um backup só ajuda quando seu conteúdo é identificável e pode ser lido. Confira se existem arquivos reais, preserve o original e anote o local de restauração. Não limpe o armazenamento do Android, não apague o app do iOS e não remova a pasta funcional do desktop como primeira tentativa de corrigir um erro.

• Feche o Dusklight e copie saves e configurações.
• Guarde a cópia fora da pasta da release ativa.
• Registre versão, plataforma, backend gráfico e região.
• Mantenha o pacote ou a pasta anterior até concluir os testes.
• Confira se o backup contém arquivos e pode ser lido.
• Não misture o backup com ROM, ISO, RVZ, chaves ou outros dados protegidos.

Como atualizar o Dusklight em cada plataforma

A atualização mais segura instala o novo build ao lado do antigo e faz um primeiro início limpo. No desktop, extraia os arquivos em uma nova pasta para não confundir um arquivo ausente com um arquivo antigo. Depois de testar, você pode arquivar ou remover a versão anterior.

No Android, instale o APK ARM64 verificado da mesma fonte confiável da release. O Android pode mostrar um aviso de fonte desconhecida quando o pacote vem de fora da Google Play. Não desinstale o pacote que funciona apenas para resolver um erro de assinatura ou de pacote; confirme primeiro fonte, arquitetura e identidade do pacote.

No iOS, atualize usando o mesmo fluxo de assinatura utilizado no app atual, como o caminho AltStore ou iloader documentado pelo projeto. Renovar uma assinatura é diferente de substituir um ZIP de desktop. O acesso ao contêiner e o rollback dependem do sistema e da ferramenta de sideloading.

No Steam Deck, use o AppImage Linux x86_64, dê permissão de execução ao novo arquivo e mantenha o AppImage conhecido como funcional até o novo iniciar no mesmo local. O guia Linux trata de armazenamento noexec e atalhos da Steam; esta página trata da troca da release.

Teste a nova versão e faça rollback com segurança

O primeiro início é um teste, não o fim do processo. Abra o novo build sem pacotes de textura, overrides, wrappers de controle ou configurações experimentais. Confirme que o Dusklight abre, reconhece os dados compatíveis, chega ao menu, aceita um controle, carrega uma cena repetível, salva e fecha normalmente.

Compare a mesma cena e o mesmo backend gráfico registrados antes da atualização. Mudanças no ritmo de quadros, texturas da interface, foco de entrada ou descoberta de arquivos são mais fáceis de classificar quando computador, dados, configurações e cena permanecem iguais. Depois, restaure as alterações uma por vez.

Se a atualização falhar, não apague o backup. Feche o programa, preserve os detalhes do erro e da versão, restaure a pasta ou AppImage anterior e teste os mesmos dados. O rollback ajuda a distinguir uma mudança no aplicativo de um problema de driver, permissão ou arquivo de terceiros.

Depois de uma atualização ou restauração bem-sucedida, registre a versão e o motivo da mudança. Para relatar um problema reproduzível ao projeto oficial, informe plataforma, arquitetura, backend gráfico, passos exatos e logs curtos, sem enviar dados de jogo protegidos ou saves pessoais.

1. Inicie limpoTeste o novo aplicativo sem mods ou texturas e com os mesmos dados de jogo compatíveis.
2. Confira o essencialTeste menu, controle, uma cena repetível, salvar, carregar e fechar normalmente.
3. Restaure uma coisa por vezAtive configurações e pacotes individualmente para manter a causa clara.
4. Volte ao build anteriorSe necessário, feche o app e use a versão preservada sem apagar o backup de dados.
5. Registre o resultadoGuarde versão, plataforma, backend, erro e correção para a próxima atualização.

FAQ: como atualizar o Dusklight