Instalação e solução de problemas

Instalação e solução de problemas do Lichii Emulator

Do download à primeira execução, configure os controles, adicione seus jogos e resolva os problemas que estiverem no caminho.

Controles separados, conexões USB-C e uma tela que ilustra o mapeamento de botões na configuração do Lichii Emulator
Ilustração · Guia de instalação do Lichii Emulator
Latest recorded build build-94 Pre-release Published November 7, 2026

Três plataformas

Como instalar o Lichii Emulator

Escolha sua plataforma para seguir a instalação passo a passo.

Instalar o Lichii no Windows

  1. Baixe os arquivos para Windows (lichii-windows-x86_64.zip (x86_64)) da versão oficial build-94 e mantenha os nomes originais.
  2. Extraia o arquivo em uma pasta na qual você tenha permissão de gravação. Não execute o programa diretamente do arquivo compactado.
  3. Execute lichii.exe na pasta onde você extraiu os arquivos. Se o Windows exibir um aviso de segurança, confira se o arquivo veio do link oficial da versão antes de decidir se vai continuar.

Orientações da versão

  • On Windows hybrid Intel CPUs with P/E cores, time-critical threads stay on performance cores by default; set EDEN_HYBRID_CORES=0 to turn this off.

Precisa de outro pacote? Ver downloads para windows.

Instalar o Lichii no Linux

  1. Entre os arquivos publicados para Linux (lichii-linux-aarch64.AppImage (arm64), lichii-linux-aarch64.tar.gz (arm64), lichii-linux-x86_64.AppImage (x86_64), lichii-linux-x86_64.tar.gz (x86_64)), escolha o que corresponde à arquitetura do seu sistema e baixe-o pelo link da versão.
  2. Para lichii-linux-aarch64.AppImage, execute chmod +x 'lichii-linux-aarch64.AppImage' na pasta onde está o download e, em seguida, abra o AppImage.
  3. Para lichii-linux-aarch64.tar.gz, primeiro extraia o arquivo e execute o programa na pasta da extração. Se o programa indicar que falta uma dependência do glibc ou do Qt, consulte as notas da versão selecionada e a issue original para ver qual versão da dependência é necessária.
  4. Guarde a URL e a tag da versão junto com o arquivo instalado para poder associar um resultado de compatibilidade futuro à mesma versão.

Orientações da versão

  • Linux AppImages require glibc 2.39 or newer.
  • Linux tar.gz packages use system libraries and require Qt 6 and the usual runtime libraries.

Precisa de outro pacote? Ver downloads para linux.

Instalar o Lichii no macOS

  1. Entre os arquivos publicados para macOS (lichii-macos-arm64.dmg (arm64), lichii-macos-arm64.zip (arm64)), escolha o que corresponde à arquitetura do seu sistema e baixe-o pelo link da versão.
  2. Para lichii-macos-arm64.dmg, abra o DMG e mova o aplicativo para uma pasta que você possa gerenciar, como Aplicativos.
  3. Para lichii-macos-arm64.zip, abra o ZIP e mova o aplicativo para uma pasta que você possa gerenciar. Se o macOS pedir confirmação na primeira execução, clique no aplicativo com o botão direito e escolha Abrir.
  4. Se o macOS exibir um aviso de segurança, confira o download com a versão oficial antes de continuar. Mantenha as proteções normais do sistema ativadas.
  5. Execute o Lichii na pasta onde você colocou o aplicativo.

Orientações da versão

  • The macOS build requires macOS 15 or newer.

Precisa de outro pacote? Ver downloads para macos.

Primeira execução

Configuração inicial

Personalize a primeira execução: escolha um mapeamento de botões confortável, ajuste os gráficos e monte sua biblioteca de jogos.

Gráficos

Comece com as configurações gráficas descritas nas notas da sua versão. Altere uma opção de cada vez e anote a tag da versão junto com os resultados.

Para ter um ponto de partida para um jogo específico, consulte o relato de compatibilidade.

Dispositivos de entrada

Conecte o controle, mapeie os botões e salve o perfil. Se algum botão não funcionar, procure o modelo do controle e a versão do Lichii na seção de solução de problemas.

Seus arquivos de jogo

Adicione os jogos que você obteve legalmente pela biblioteca ou pela opção de abrir arquivos de jogo no Lichii. Jogos, chaves e firmware são fornecidos separadamente.

Orientações oficiais de instalação atuais

  • Back up saves before testing experimental builds.
  • For issue reports, provide the exact build, game version, CPU, GPU, driver version, relevant settings, reproduction steps, and (if useful) a screenshot and session log checked for personal information. Do not upload game files, keys, firmware, or private account information.
  • Desktop compatibility reporting requires a build containing PR #303 and is unavailable in build 88. In supported builds, play and stop a Switch 2 game, then right-click it and select Submit compatibility report. Review the prefilled details and public preview, and explicitly consent before submission; nothing uploads automatically, and the native v1 reporter does not read or upload logs or files.
  • The handbook advises trying games with stock settings before changing options.

Volte ao jogo

Erros comuns no Lichii e como resolvê-los

276 registros de problemas

GitHub issue · open

[GBug] Orbitals (040004F027560000): black screen, GPU deadlock after unsupported native QMD compute dispatch

Jogo: Orbitals Sistema: Windows 11 (25H2, build 26200) Versão: Lichii nx2 build 93 (09b78bd)

Black screen and GPU deadlock after an unsupported native QMD compute dispatch; GPU channels wait on the semaphore the QMD was supposed to release.

Consulta de jogos

Verificar a compatibilidade de um jogo

Dúvidas sobre a instalação

Perguntas frequentes sobre a instalação

Devo remover a versão antiga primeiro?

Mantenha a versão que funciona até instalar e testar a nova. Faça backup dos dados salvos e da configuração antes de trocar de versão.

O que verificar se o Windows indicar que falta uma dependência?

Mantenha todos os arquivos auxiliares da mesma versão na mesma pasta que lichii.exe. Procure a mensagem exata sobre a dependência nas notas da versão ou na lista de issues.

O controle funciona nos menus, mas não no jogo. O que fazer?

Confira o perfil de entrada e o mapeamento dos botões. Depois, procure o modelo do controle ou o jogo na seção de solução de problemas.

Por que uma issue fechada ainda aparece aqui?

“Fechada” é o status na lista de issues. Leia a discussão para saber se o problema foi resolvido, movido ou se a issue foi fechada por outro motivo, e qual versão é afetada.

Que informações devo incluir ao pedir ajuda?

Informe a versão do Lichii, o sistema operacional, a GPU e o driver, o texto completo do erro e os passos que o causam. Diga se o erro também ocorre em uma versão que funcionava antes.