4

Pitch: transformei meu site de PDF num app de Windows que converte arrastando o arquivo e tocando no Shift

Arrastando um PDF e tocando no Shift: a roda de opções abre em volta do mouse

Faz um tempo que eu mantenho o Crow Docs (crowdocs.com.br), um site com 46 ferramentas de PDF que rodam direto no navegador: o arquivo não sai do computador de quem usa. Esta semana saiu a versão para Windows, na Microsoft Store, e eu queria contar como ela foi feita, porque a parte técnica rendeu bastante aprendizado.

Como funciona para quem usa

O app fica quieto perto do relógio. Você arrasta um arquivo e dá um toque no Shift: abre uma roda de opções em volta do mouse. Solta o arquivo numa fatia e o resultado aparece ao lado do original, sem abrir janela e sem perguntar nada.

O arquivo convertido aparece ao lado do original, com o aviso de pronto perto do mouse

Hoje são 13 conversões: PDF para Word, PowerPoint, texto e JPG; comprimir, girar e juntar PDFs; imagem para PDF, JPG, PNG e WebP; Word e Excel para PDF.

A ideia principal: o site virou o motor

Eu não quis reescrever as conversões em C#. O site já fazia tudo em JavaScript e já estava no ar. Então o app carrega os próprios arquivos do site numa WebView2 escondida (o Edge que já vem no Windows), e uma ponte em JavaScript opera a tela do site do jeito que uma pessoa faria: coloca o arquivo, escolhe a opção, aperta o botão e pega o resultado.

  • A página do motor não tem permissão de usar a internet. Tudo acontece no PC.
  • Ferramenta nova no app = uma "receita" na ponte (como operar aquela tela) + uma fatia no catálogo da roda.
  • Para o pacote ficar pequeno, tirei do motor o que nenhuma fatia usa (OCR e OpenCV): 14,6 MB em vez de 71,5 MB. O pacote final tem 6,9 MB.

O gesto: arrastar + Shift

O app é WPF, no .NET Framework 4.8 (que já vem no Windows, então não pede instalar nada). Um "vigia" percebe a combinação "estou arrastando um arquivo do Explorador ou da Área de Trabalho e toquei no Shift" e abre uma janela transparente em volta do mouse. Essa janela é um alvo de soltar normal do Windows, então ela recebe o arquivo como qualquer programa receberia.

A roda também tem a versão branca, escolhida no menu do ícone

Alguns detalhes que deram trabalho:

  • App rodando como administrador não recebe arquivo arrastado do Explorador (o Windows bloqueia). Por isso ele nunca roda elevado.
  • A roda sempre responde "copiar" ao Windows, nunca "mover": o arquivo original não é tocado.
  • Na Área de Trabalho, o Windows coloca o arquivo novo no primeiro espaço livre, que pode ser do outro lado da tela. O app move o ícone do resultado para a casa livre mais perto do original (pela interface IFolderView do Shell).

A roda que avisa antes

Arrastando um PDF com senha: a roda já abre trancada, com o motivo no meio

Eu queria que a pessoa não visse mensagem de erro depois de soltar. Então, quando a roda abre, o app já confere os arquivos: vazio, estragado, em uso por outro programa, tipo que não converte, PDF que pede senha. Se nenhuma fatia resolve, a roda abre trancada, com o motivo e o que fazer.

  • A conferência custa menos de 1 ms por arquivo e a roda espera no máximo 15 ms por ela. Passou disso, abre normal e se corrige quando a resposta chega.
  • O PDF com senha é descoberto sem ligar o motor: o app refaz a conta de verificação do próprio formato PDF com a senha vazia, lendo só o primeiro e o último MB do arquivo.
  • A regra é nunca trancar um arquivo que converteria; na dúvida, ela libera e o motor decide. Testei com 619 arquivos de verdade (nenhum arquivo bom trancado) e com 49 PDFs gerados com cada tipo de proteção (RC4 40/128 e AES 128/256, com e sem senha de abrir): os 49 deram certo.

O que a WebView2 me ensinou

  • Ela se recusa a abrir arquivo que está dentro de AppData, e é ali (na pasta Temp) que o Windows coloca o que você arrasta de dentro de um zip ou de um anexo de e-mail. Também não enxerga caminho com 260 letras ou mais. Nesses casos o app lê o arquivo e entrega o conteúdo por memória compartilhada (CoreWebView2SharedBuffer).
  • A memória acumula de uma conversão para a outra, principalmente no PowerPoint (uns 9 MB por arquivo), e recarregar a página não devolve. A solução foi desligar e ligar o motor sozinho a cada 40 trabalhos, ou quando os processos do navegador passam de 1 GB. Leva cerca de 1 s e a memória volta para uns 250 MB.
  • Limite de tamanho medido, não chutado: num PC de 8 GB, até 200 MB as 6 ferramentas de PDF convertem (a mais lenta levou 63 s, com pico de 1,7 GB de memória). Acima disso, a roda avisa antes.
  • Antes de lançar, rodei uma bateria de umas 2.490 conversões com arquivos de verdade, sem nenhum erro desconhecido no fim.

Microsoft Store

  • Fui pela loja porque ela assina o pacote MSIX de graça. Sem assinatura, o Windows mostra aquele aviso azul de "app desconhecido".
  • O app precisa da permissão runFullTrust (vigiar o mouse e o Shift, ler o arquivo de qualquer pasta e gravar o resultado ao lado), e a loja pede uma justificativa por escrito para isso.
  • Dentro do pacote, a linha de "iniciar com o Windows" no registro não funciona: o certo é a tarefa de inicialização (StartupTask) declarada no manifesto.
  • Mandei para certificação e foi aprovado em menos de um dia.

Testa e me conta

É grátis, sem cadastro e sem anúncio, para Windows 10 e 11. Por enquanto está disponível nos países de língua portuguesa.

Se você testar, me conta o que faltou, que conversão você mais usa e onde a roda te atrapalhou. As críticas aqui vão direto para a próxima versão.

Carregando publicação patrocinada...
4

Caraca, mano, que sacada genial! Tirar o app do navegador e botar direto no Windows com esse esquema de arrastar o arquivo e apertar o Shift ficou bom demais. Muito massa ver a evolução do projeto, parabéns!

2

Valeu, mano! Fico muito feliz que curtiu. Se testar o app, me conta qual conversão faltou na roda. As sugestões daqui vão direto para a minha lista.

2

Muito bom, principalmente a ideia de reaproveitar o site inteiro como motor na WebView2.

Uma dica de quem passou por isso num app WPF que também vigia o teclado o tempo todo: se o "vigia" do Shift usa gancho de teclado de baixo nível (WH_KEYBOARD_LL), cuidado com o LowLevelHooksTimeout. Se a thread que recebe o gancho demorar mais de ~300 ms pra responder (um GC mais longo, a UI ocupada), o Windows remove o gancho sem avisar nada, e o handle antigo continua parecendo válido. O sintoma é o app "parar de funcionar do nada" depois de um tempo, sem erro nenhum. Eu resolvi reinstalando o gancho de tempos em tempos quando o teclado está em repouso.

Se você usa polling com GetAsyncKeyState em vez de gancho, esse problema não existe. Fiquei curioso: como você detecta que tem um arrasto do Explorador em andamento?

1

Valeu pela dica, muito boa! Fui conferir na documentação da Microsoft e é isso mesmo: se o gancho estoura o LowLevelHooksTimeout, a partir do Windows 7 ele é removido em silêncio e o app não fica sabendo (e no Windows 10 1709 em diante o teto é 1 segundo). Guardei aqui pra se um dia eu precisar de gancho.

No Crow Docs eu fui justamente pelo caminho do polling, sem gancho nenhum, também porque antivírus costuma desconfiar de gancho global de teclado. É um DispatcherTimer lendo o GetAsyncKeyState do botão do mouse e do Shift: a cada 30 ms com o mouse solto e a cada 10 ms enquanto o botão está apertado. Fora de um arrasto custa praticamente nada.

Pra detectar o arrasto são duas etapas:

Suspeita (polling): quando o botão principal desce (respeitando o SM_SWAPBUTTON de quem é canhoto), pego a janela embaixo do mouse com WindowFromPoint e vejo se o processo é o explorer.exe (Explorador ou Área de Trabalho). Se o mouse anda mais que o SM_CXDRAG, conta como arrasto. Se o Shift desce durante esse arrasto (Shift que já estava apertado no clique não conta, pra continuar dando pra mover arquivo com Shift), abro uma janela transparente embaixo do cursor, ainda invisível.

Confirmação (OLE): essa janela é um alvo de drop de verdade. Quando o arrasto passa por ela, o próprio Windows manda o DragEnter com o IDataObject. Se tiver lista de arquivos (CF_HDROP), a roda aparece; se não for arquivo, ou se não chegar arrasto nenhum (um retângulo de seleção, por exemplo), ela some sem mostrar nada. Assim eu não preciso ler a seleção do Explorador nem adivinhar: quem diz o que está sendo arrastado é o Windows. E a roda só aceita “Copiar”, nunca “Mover”, então o Explorador nunca mexe no arquivo original.

Quando o botão sobe, o polling avisa que o arrasto acabou, e a roda fecha se ninguém soltou nela.