Como configurar atualizações web automáticas

O XLS Padlock inclui um recurso de atualização web que pode baixar e instalar automaticamente novas versões da sua aplicação. Isso permite que seus usuários finais atualizem facilmente o aplicativo da sua planilha sempre que você lançar uma nova versão.

Nenhum software de terceiros é necessário, mas você precisa ter um servidor web ou um espaço de hospedagem web para hospedar os arquivos de atualização.

A aplicação baixa primeiro um pequeno arquivo de controle (.inf) do seu servidor. Esse arquivo informa à aplicação se há uma nova versão disponível. Se houver, a aplicação baixa os arquivos de atualização necessários (.cab), fecha-se, instala a atualização e reinicia.

A partir do XLS Padlock 2026.3, a atualização web é autenticada. Na primeira vez que você protege um projeto que usa atualização web, o XLS Padlock cria uma chave de assinatura exclusiva desse projeto e exibe um aviso. A chave é armazenada no arquivo do seu projeto, que o XLS Padlock salva logo após essa primeira proteção bem-sucedida. Todo arquivo de controle (.inf) gerado a partir daí é assinado com essa chave e lista uma impressão digital SHA-256 de cada arquivo de atualização.

As aplicações compiladas com o XLS Padlock 2026.3 ou posterior verificam ambos antes de instalar qualquer coisa. Elas recusam um arquivo de controle sem assinatura, assinado com outra chave ou modificado de qualquer forma, e recusam um arquivo baixado cuja impressão digital não corresponda. Um servidor de atualização comprometido ou falsificado, ou um arquivo alterado em trânsito, não pode mais enviar seu próprio código aos seus usuários finais. As aplicações compiladas com versões anteriores do XLS Padlock não são afetadas e continuam usando o mecanismo anterior.

Três regras decorrem disso:

1. Proteja primeiro, depois gere. Clique em Protect antes de Generate Web Update Files. Se a aplicação compilada não contiver a chave de assinatura atual do projeto, o XLS Padlock pede que você proteja (compile) a planilha novamente em vez de gerar os arquivos.
2. Envie os arquivos gerados sem alterações. Qualquer edição no arquivo de controle invalida sua assinatura. Uma transferência FTP em modo texto que apenas reescreve as quebras de linha é tolerada.
3. Lance cada atualização a partir do mesmo arquivo de projeto. Restaurar configurações a partir de um modelo mantém a chave de assinatura do próprio projeto.

Quando uma verificação falha, nada é instalado. O assistente de atualização informa que não consegue se conectar e que nenhuma atualização está disponível. Se o usuário final iniciou a atualização com o parâmetro de linha de comando -webupdate, a aplicação exibe “The update information could not be verified, so no update was installed. Please contact the publisher of this application.” Um arquivo baixado cuja impressão digital não corresponde é relatado como uma falha de download.

Você pode configurar sua aplicação para verificar automaticamente atualizações na inicialização ou adicionar um botão “Check for Updates” (verificar atualizações) à tela de boas-vindas. Quando uma nova versão é detectada, os usuários são guiados por um assistente de atualização web. O assistente é exibido no idioma selecionado na página Localização do seu projeto (XLS Padlock 2026.2 ou posterior; versões anteriores o exibiam em inglês), usando as traduções já incorporadas ao seu aplicativo.

Os usuários também podem iniciar uma atualização por meio do parâmetro de linha de comando -webupdate.

O número de File Version (versão do arquivo), especificado na página EXE Version Info do XLS Padlock, é usado para determinar se uma atualização é necessária. Você deve aumentar esse número de versão toda vez que lançar uma atualização.

• Base URL: A URL no seu servidor web onde os arquivos de atualização web serão hospedados (por exemplo, https://www.yourwebsite.com/myfolder). HTTPS é recomendado.
• Web Update INF Control Filename: O nome do arquivo de controle que contém as informações de atualização.
• Local Destination Folder: Uma pasta local no seu computador onde o XLS Padlock gerará os arquivos de atualização. Em seguida, você deve enviar todo o conteúdo dessa pasta para o seu servidor web.
• “What’s new” text (opcional): Texto a ser exibido no assistente de atualização, informando aos usuários sobre as mudanças na nova versão.

Clicar em Generate Web Update Files no XLS Padlock criará os arquivos necessários (um arquivo de controle .inf e um arquivo compactado .cab) na pasta local que você especificou. Em seguida, você pode enviar esses arquivos para o seu servidor web.

Proteja a planilha primeiro: os arquivos de atualização são criados a partir da aplicação compilada, que deve conter a chave de assinatura atual do projeto (consulte Atualizações autenticadas).

Para resolver problemas com o recurso de atualização web, ative a opção “Enable WebUpdate Log” (habilitar log de atualização web) em Opções avançadas. Isso criará um arquivo WUPDATE.LOG no diretório Documentos do usuário com informações detalhadas sobre o processo de atualização.

Se uma aplicação compilada com o XLS Padlock 2026.3 ou posterior informar que nenhuma atualização está disponível embora você tenha enviado uma nova versão, verifique primeiro se os arquivos no seu servidor são exatamente os gerados pelo XLS Padlock (sem edição e sem envio parcial) e se você os gerou depois de proteger a planilha com o mesmo arquivo de projeto.