Skip to content

Fumaça do app empacotado: separar empacotamento de ausência de WSL - #5

Merged
blackfoxsoftware merged 1 commit into
devfrom
fix/fumaca-sem-wsl
Sep 2, 2026
Merged

Fumaça do app empacotado: separar empacotamento de ausência de WSL#5
blackfoxsoftware merged 1 commit into
devfrom
fix/fumaca-sem-wsl

Conversation

@blackfoxsoftware

Copy link
Copy Markdown
Owner

O que muda

O release da v0.2.0 falhou no job Empacotar — e a proteção funcionou: Publicar foi pulado, nenhuma tag foi criada, nenhuma release saiu pela metade.

A causa foi o teste de fumaça exigir demais. Ele afirmava que o motor nativo estava disponível, o que exige WSL na máquina, e runner de CI não tem.

O log mostra que o empacotamento estava correto:

  • dllPath dentro de resources/vendor/wslcsdk/win-x64/2.9.3/
  • source: bundled
  • a chamada chegou na DLL: voltou 0x80070032 (ERROR_NOT_SUPPORTED), não erro de módulo

Esse HRESULT virou o critério: um código de erro do SDK prova que o koffi carregou de fora do asar e que os bindings casaram — que é exatamente o que esta fumaça existe para verificar. Se o motor nativo funciona de fato é outra pergunta, respondida pelos testes de integração, que só rodam onde o SDK responde.

Também é a mesma lição do commit do guarda dos testes: não afirmar sobre o ambiente o que só vale na máquina de quem desenvolve.

Checklist

  • A PR aponta para a dev
  • npm run check passa — 310 testes
  • Fumaça verificada nesta máquina, com o app empacotado
  • patchnotes.json atualizado na entrada de 0.2.0 (versão ainda não publicada)

O release falhou no job Empacotar, e a proteção funcionou: Publicar foi pulado,
então nenhuma tag foi criada e nenhuma release saiu pela metade.

A causa foi o teste exigir demais. Ele afirmava que o motor nativo estava
disponível, o que exige WSL na máquina — e runner de CI não tem. O log mostra
que o empacotamento estava correto: a DLL foi encontrada dentro de resources/,
a origem era "bundled", e a chamada CHEGOU nela (voltou 0x80070032,
ERROR_NOT_SUPPORTED, não erro de módulo).

Esse HRESULT virou justamente o critério. Um código de erro do SDK prova que o
koffi carregou de fora do asar e que os bindings casaram, que é o que esta
fumaça existe para verificar. Se o motor nativo de fato funciona é outra
pergunta, respondida pelos testes de integração, que só rodam onde o SDK
responde.

É a mesma lição do commit anterior, no guarda dos testes: afirmar sobre o
ambiente o que só vale na máquina de quem desenvolve.
@blackfoxsoftware
blackfoxsoftware merged commit 676393f into dev Sep 2, 2026
3 checks passed
@blackfoxsoftware
blackfoxsoftware deleted the fix/fumaca-sem-wsl branch September 2, 2026 01:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant