Desktop Linux e Windows
Implementado: aplicativo híbrido Tauri 2, mantendo HTML/CSS/JavaScript na WebView e o núcleo Rust compartilhado com a CLI. A interface anterior pelo navegador e o comando serve foram removidos. Os alvos iniciais são Linux x86_64 e Windows x86_64.
Instalação
Baixe os artefatos da versão atual em GitHub Releases. A 0.4.0 é a release atual e contém:
| Sistema | Artefato | Dependência de execução |
|---|---|---|
| Linux Debian/Ubuntu | .deb |
WebKitGTK 4.1; instalado pelo gerenciador de pacotes |
| Linux | .AppImage |
Sistema compatível com Ubuntu 22.04 ou posterior; pode exigir FUSE |
| Windows 10/11 | instalador NSIS .exe |
WebView2, instalado pelo instalador quando necessário |
O arquivo SHA256SUMS acompanha a release. Não há assinatura de código nem atualização automática nesta etapa.
A 0.4.0 foi publicada em 2026-11-02 na tag v0.4.0; o workflow remoto passou em Linux e Windows e publicou os três instaladores e o SHA256SUMS. Consulte as notas da 0.4.0 para o escopo, os assets e as limitações de validação.
Desenvolvimento
Requisitos: Rust estável recente, Node.js 22 com npm e as dependências oficiais do Tauri. A CLI do núcleo pode ser compilada sem dependências gráficas.
Ubuntu/Debian, com privilégios administrativos:
sudo apt-get update
sudo apt-get install -y build-essential curl wget file libssl-dev libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf xdg-utils
No Windows, instale Visual Studio Build Tools com a carga de trabalho C++ para desktop e o SDK Windows, Rust com toolchain MSVC, Node.js 22 e WebView2. Execute os comandos abaixo no diretório do repositório:
npm ci
npm run desktop:dev
Para abrir uma coleção existente:
npm run desktop:dev -- -- --collection examples/demo
Sem argumento, o aplicativo reabre a última pasta escolhida em Abrir coleção. Se ela não estiver disponível, usa uma coleção inicial em app_data_dir()/colecao. O caminho selecionado fica em app_data_dir()/last-collection.txt. Uma pasta inválida escolhida pelo diálogo mantém a coleção anterior aberta. Se a coleção exigir migração, o app não migra sozinho: mostra o diálogo de inspeção e mantém a coleção anterior ativa até confirmar ou cancelar.
Use Abrir coleção para trocar a pasta. O guardião de navegação pede confirmação antes de descartar um rascunho ou fechar uma janela com alterações; Manter rascunho preserva a edição em .reqlivo/drafts/. Para criar uma coleção em outra pasta, use reqlivo --collection minha-api init --name "Minha API" e selecione a pasta no aplicativo. Exportações de conteúdo usam diálogo nativo de salvamento.
Arquitetura e permissões
src-tauri/: janela, diálogos nativos, seleção da coleção e empacotamento.src/assets/: interface empacotada porfrontendDist, sem servidor de desenvolvimento frontend.src/desktop.rs: ponte testável que executa operações/api/*em memória porRouter::oneshot.src/server.rs: contratos de CRUD, execução, cancelamento, importação e exportação preservados; nenhum listener ou asset HTTP.- O comando Tauri
api_requestaceita somente caminhos internos e GET/POST/PUT/DELETE. Não é um proxy HTTP. APIs de destino continuam no transporte Rust. - O envio interativo usa
api_request_with_progresse umtauri::ipc::Channelpara receber headers e blocos. O canal é opcional e não abre listener; sem ele, a interface usaapi_requeste não mostra progresso. - A capability é restrita à janela local
main, sem origens remotas nem plugins de shell/filesystem. Diálogos são chamados pelo Rust. A CSP permite IPC e assets locais. - A troca de coleção reinicia cookies e cancela operações do estado anterior. A UI exige concluir/cancelar execuções antes da troca.
Build e verificações
cargo fmt --all -- --check
cargo test --locked
cargo test --workspace --locked
python3 scripts/check-version.py
cargo test --locked testa somente o núcleo e a ponte IPC, sem GTK/WebKit. O comando com --workspace também compila o desktop e exige as dependências gráficas.
# Linux
npm run desktop:build -- --bundles deb,appimage -- --locked
# Windows
npm run desktop:build -- --bundles nsis -- --locked
Instaladores ficam em target/release/bundle/. O AppImage preserva caminhos relativos de --collection usando o diretório original OWD ou o PWD preservado pelo shell, mesmo quando o launcher altera o diretório de trabalho. O build não exige um servidor Node.js e o aplicativo instalado não depende de Node.js.
Releases no GitHub
- PRs e pushes para
mainexecutam testes do workspace e geram instaladores Linux/Windows como artifacts da execução. O disparo manual faz o mesmo, sem publicar release. - Uma tag
v*verifica que as versões emCargo.toml,src-tauri/Cargo.toml,src-tauri/tauri.conf.json,package.jsonepackage-lock.jsoncoincidem com a tag. - Somente após os dois builds passarem, o job com
contents: writepublica uma release com os três instaladores e checksums SHA-256. Uma reexecução substitui os assets da mesma tag. - Usa o
GITHUB_TOKENautomático; não exige token pessoal ou certificado em secrets.
Para publicar uma versão posterior, depois de integrar e validar o código:
git tag v0.5.0
git push origin v0.5.0
Antes da tag, atualize os cinco manifestos (Cargo.toml, src-tauri/Cargo.toml, src-tauri/tauri.conf.json, package.json e package-lock.json) e as entradas dos pacotes próprios em Cargo.lock; gere o lock npm com npm install --package-lock-only quando necessário. Confira a consistência antes de criar a tag. A 0.4.0 foi publicada em 2026-11-02 na tag v0.4.0: o workflow remoto passou em Linux e Windows, publicou os três instaladores e o SHA256SUMS, e a release foi verificada. A 0.3.0 foi publicada em 2026-10-27 na tag v0.3.0. A instalação manual em máquinas limpas e a matriz manual no Windows continuam pendentes; a matriz automatizada Linux em WebView real da 0.3.0 foi executada e está descrita abaixo.
Validação e lacunas
Os testes da ponte IPC verificam criação/persistência/reabertura/exclusão, erros estruturados e rejeição de caminhos externos. Os testes de progresso usam dispatch_with_progress com um sink em memória e cobrem ordem dos eventos, UTF-8 dividido, truncamento e cancelamento. Os testes HTTP existentes continuam verificando o transporte e o cancelamento. O CI compila e empacota o desktop em Linux e Windows, inicia o AppImage no Linux e aguarda até trinta segundos por uma janela visível; no Windows, verifica o executável após dez segundos. No Linux, usa D-Bus e Openbox em uma sessão X11 isolada no Xvfb, exige janela visível e rejeita captura uniforme e registra a imagem como artifact desktop-smoke-linux.
Observado em execução na 0.2.0: 64 testes locais aprovados; cargo check -p reqlivo-desktop --locked e build debug aprovados. Os builds Linux e Windows geraram os três instaladores e abriram os executáveis. O .deb produzido pelo GitHub foi extraído e executado localmente.
Observado em execução na 0.3.0: 107 testes locais aprovados em Linux; cargo fmt --check, cargo test --locked, cargo test --workspace --locked, cargo check --manifest-path src-tauri/Cargo.toml, node --check e o verificador de versão passaram. A demonstração CLI passou com o servidor sintético, e o cenário de migração/rollback foi executado em cópia temporária. Um harness de teste em Chrome headless exercitou 11 fluxos de interface (rascunhos, guardião, autosave, alterações externas, comparação, YAML inválido, ID duplicado, manifesto e teclado/foco); ele usa um exemplo separado e não cria listener no produto. Evidências: checks, UI headless, capturas, demonstração e migração. Os testes automatizados novos cobrem rascunhos, gerações, conflitos, lixeira, migração e a rota IPC de recuperação. O workflow remoto passou em ubuntu-22.04 e windows-latest na pré-validação e na publicação da tag v0.3.0; a release contém .deb, .AppImage, .exe e SHA256SUMS.
Observado em execução na 0.4.0 (Linux e workflow remoto): 110 testes aprovados em cargo test --locked e no workspace; cargo fmt --all -- --check, cargo check --workspace --locked, node --check, python3 -m py_compile, scripts/check-version.py e git diff --check passaram. O build de release reqlivo-desktop foi gerado. O harness headless passou 12/12 fluxos, incluindo S-01 para a renderização incremental; ele não exercita o Channel da WebView real. O caso D-12 foi adicionado ao roteiro de desktop, mas não foi executado porque WebKitWebDriver não está instalado no ambiente. O workflow remoto passou em ubuntu-22.04 e windows-latest na execução da tag v0.4.0 e publicou os três instaladores e o SHA256SUMS na release v0.4.0. Evidências: checks, UI headless, capturas e publicação.

Validação manual ainda necessária em cada plataforma: primeiro uso, seleção/cancelamento de pasta, importar/exportar por diálogo, fechar janela com rascunho, inspeção visual do instalador e auditoria com leitor de tela. A matriz automatizada abaixo já cobre abertura/envio, autosave e recuperação após reinício, guardião, alteração externa e comparação, YAML inválido, lixeira, manifesto de ambiente, cursor antigo, foco/teclado, cancelamento de envio e migração/rollback. O progresso incremental da 0.4.0 ainda depende de D-12 em WebView real. Build automatizado não equivale a teste visual ou execução de instalador. A execução local do desktop depende da instalação de GTK/WebKit no ambiente de desenvolvimento.
Matriz automatizada em WebView real (Linux)
O script desktop-acceptance.mjs abre o binário de release target/release/reqlivo-desktop em uma WebView WebKitGTK real, por tauri-driver e WebKitWebDriver, sem servidor de desenvolvimento. Ele cria cópias descartáveis de examples/demo, sobe um servidor HTTP sintético em loopback, executa os casos e, por padrão, grava relatório, JSON e capturas em ../evidencias/reqlivo-v0.4.0/desktop/. A execução histórica da 0.3.0 está em ../evidencias/reqlivo-v0.3.0/desktop/.
Pré-requisitos locais: Linux com Xvfb/X11, tauri-driver, WebKitWebDriver, xwininfo, dbus-run-session, Python com ligações X11/XTest e o binário de release compilado (cargo build --release -p reqlivo-desktop). O driver e o servidor são iniciados e encerrados pelo próprio script. A variável DESKTOP_ONLY permite executar um caso isolado, por exemplo DESKTOP_ONLY=D-01.
WEBKIT_WEBDRIVER=/caminho/WebKitWebDriver \
DESKTOP_WEBKIT_VERSION=2.52.6 \
node scripts/desktop-acceptance.mjs
A execução de 2026-10-27 usou Ubuntu 26.04.1, tauri-driver 2.0.6, WebKitWebDriver 2.52.6 e Xvfb :99 (1600×1000×24, sem gerenciador de janelas), com o binário SHA-256 a34ded160203dcd5a27cfadc57f19e5ee491b80e38eecff652f414cb52e98919. Resultado: 11/11 casos aprovados (D-01 a D-11), sem falhas. O helper x11-dialog-ok.py clica no “OK” dos diálogos nativos GTK via X11/XTest; ele é ferramenta de teste e não substitui uma auditoria de acessibilidade.
Para a 0.4.0, o script inclui D-12 — visualização incremental de resposta HTTP, com o endpoint sintético /stream. O caso verifica a prévia parcial, o contador de bytes, o botão de cancelamento ativo e a substituição pela resposta final. Ele não foi executado porque WebKitWebDriver não está instalado/localizado no ambiente; tauri-driver existe, mas sozinho não inicia a sessão. A execução de 11/11 acima é histórica da 0.3.0 e não cobre o recurso novo. A release 0.4.0 foi publicada com essa lacuna explicitada.
Evidências da 0.3.0: relatório, JSON e capturas.
A matriz não cobre: seleção/cancelamento de pasta pelo diálogo nativo, importação/exportação por diálogo, fechamento da janela com rascunho, troca real entre coleções pelo seletor nativo, leitor de tela/WCAG, Windows e instalação em máquina limpa. D-08 usa um cursor de geração simulado, não uma troca real de coleção.
Referências consultadas
Documentação local: uso, MVP, Tauri, bibliotecas Rust. Consulta Context7: /websites/tauri_app, tópicos de comandos/estado/IPC e distribuição GitHub.
Documentação oficial: comandos Rust, configuração, capabilities, diálogos, GitHub Actions.