¶ 
Guia de Lançamento — SoftparkUpdater
Este guia ensina o passo a passo completo para lançar uma nova versão do atualizador Softpark.
Siga cada etapa na ordem para garantir que nada seja esquecido.
Git: https://gitlab.tail18e9b.ts.net/softpark-desktop/softparkupdater
¶ 
Visão Geral do Processo
O lançamento de uma nova versão envolve duas partes principais:
| Etapa | O que fazer |
|---|---|
 Arquivos do Sistema |
Recompilar o Softpark, copiar os arquivos para Resources\SystemFiles e marcar como Embedded Resource |
 Banco de Dados |
Atualizar o .dacpac, o post_script.sql com a nova versão, e marcar como Embedded Resource |
¶ Parte 1 — Arquivos do Sistema (Softpark)
¶ 1.1 Compilar a Solution do Softpark
- Abra a solution do Softpark no Visual Studio
- Selecione a configuração Debug (ou Release, conforme o padrão da equipe)
- Faça o Rebuild Solution (
Ctrl+Shift+Bou menuBuild > Rebuild Solution) - Aguarde a compilação finalizar sem erros
Importante: Sempre faça Rebuild (não apenas Build) para garantir que todos os arquivos estejam atualizados.
¶ 1.2 Copiar os Arquivos Compilados
- Navegue até a pasta de saída do build do Softpark:
Softpark\bin\Debug\ - Selecione todos os arquivos dessa pasta
NÃO copie as pastas — apenas os arquivos soltos (.dll,.exe,.pdb,.xml,.config, etc.)- Cole os arquivos na pasta do atualizador:
SoftparkUpdater\SoftparkUpdater\Resources\SystemFiles\ - Quando perguntado, escolha Substituir os arquivos existentes
Dica: Ordene por tipo de arquivo para facilitar a seleção. Lembre-se: apenas arquivos, sem pastas!
¶ 1.3 Marcar como Embedded Resource no Projeto
Após copiar os arquivos, é necessário garantir que todos estejam marcados como Embedded Resource:
- No Visual Studio, abra o projeto SoftparkUpdater
- No Solution Explorer, expanda a pasta
Resources > SystemFiles - Verifique se os arquivos novos/alterados aparecem no projeto
- Se algum arquivo novo não aparecer, clique com o botão direito na pasta
SystemFiles> Add > Existing Item e selecione os arquivos faltantes
- Se algum arquivo novo não aparecer, clique com o botão direito na pasta
- Para cada arquivo novo adicionado:
- Selecione o arquivo no Solution Explorer
- Na janela Properties (
F4), altere Build Action paraEmbedded Resource
¶ 
Parte 1.5 — Atualizar a Versão do Assembly (AUTOMÁTICO)
SoftPark.exeque está na pastaSystemFiles. Não é mais necessário alterar manualmente oAssemblyInfo.csnem opost_script.sql.A versão exibida na interface e a versão gravada no banco são extraídas automaticamente do assembly
SoftPark.exeembarcado nos recursos.Basta copiar o
SoftPark.exeatualizado paraResources\SystemFiles\e o atualizador faz o resto.
¶ Parte 2 — Banco de Dados (Dacpac e Scripts)
¶ 2.1 Obter o Arquivo Dacpac (.dacpac)
- Compile o projeto de banco de dados (SSDT) do Softpark para gerar o arquivo
.dacpac- No Visual Studio, faça Build no projeto de banco (geralmente gera um arquivo
SoftparkDatabase.dacpac)
- No Visual Studio, faça Build no projeto de banco (geralmente gera um arquivo
- Copie o arquivo
.dacpacgerado para a pasta do atualizador:SoftparkUpdater\SoftparkUpdater\Resources\SoftparkDatabase.dacpac - Substitua o arquivo existente
¶ 2.2 Marcar o Dacpac como Embedded Resource
- No Solution Explorer, verifique se o arquivo
SoftparkDatabase.dacpacaparece emResources - Se não aparecer, adicione-o: botão direito em
Resources> Add > Existing Item - Confirme que o Build Action está como
Embedded Resource
¶ 2.3 Atualizar a Versão no post_script.sql (AUTOMÁTICO)
post_script.sql
post_script.sqlusa placeholders ({VERSION_MAJ},{VERSION_MIN},{VERSION_BUILD},{VERSION_REV}) que são substituídos em tempo de execução pela versão detectada doSoftPark.exe.Não altere os placeholders no
post_script.sql! Eles devem permanecer como estão:EXEC PROC_UPDATE_VERSAO_SOFTPARK @VERSION_MAJ = {VERSION_MAJ}, @VERSION_MIN = {VERSION_MIN}, @VERSION_BUILD = {VERSION_BUILD}, @VERSION_REV = {VERSION_REV};
¶ 2.4 Marcar o post_script.sql como Embedded Resource
- Confirme que o
post_script.sqlestá no projeto e com Build Action =Embedded Resource - O mesmo vale para o
pre_script.sql— ele normalmente não precisa ser alterado, mas deve estar como Embedded Resource
¶ 
Compilar e Testar o Atualizador
¶ 3.1 Rebuild do SoftparkUpdater
- No Visual Studio, com o projeto SoftparkUpdater aberto
- Faça Rebuild Solution (
Ctrl+Shift+B) - Verifique se a compilação finalizou sem erros
¶ 3.2 Testar Localmente (Recomendado)
Antes de distribuir, faça um teste em ambiente controlado:
- Verifique se o atualizador abre corretamente
- Confirme que os arquivos do sistema são extraídos
- Confirme que o dacpac é aplicado no banco de teste
- Verifique se a versão no banco foi atualizada corretamente
¶ 
Checklist Final
Antes de distribuir a nova versão, confirme todos os itens:
-
Rebuild da solution do SoftparkIR feito com sucesso -
Arquivos da pasta bin\Debugcopiados paraResources\SystemFiles(apenas arquivos, sem pastas) -
Todos os arquivos novos marcados como Embedded Resource -
AssemblyVersionatualizada noAssemblyInfo.cs - Versão do Assembly bate com a versão do
post_script.sql -
Arquivo .dacpacatualizado emResources\SoftparkDatabase.dacpac - Dacpac marcado como Embedded Resource
-
Versão atualizada no post_script.sql -
post_script.sqlmarcado como Embedded Resource - Rebuild do SoftparkUpdater feito com sucesso
-
Teste local realizado com sucesso
¶ 
Erros Comuns
| Problema | Causa | Solução |
|---|---|---|
| Arquivo não é extraído no cliente | Build Action não está como Embedded Resource |
Verificar Properties do arquivo no VS |
| Versão não atualiza no banco | post_script.sql não foi editado |
Editar a linha PROC_UPDATE_VERSAO_SOFTPARK |
| Dacpac falha ao aplicar | Dacpac desatualizado ou corrompido | Recompilar o projeto de banco e copiar novamente. Lembre-se de verificar se o banco "BASE" está atualizado |
| Arquivos antigos no cliente | Fez Build ao invés de Rebuild | Sempre usar Rebuild Solution |
| Subpastas copiadas por engano | Copiou a pasta inteira do Debug | Copiar apenas os arquivos, nunca as subpastas |
| Versão do Assembly divergente | AssemblyInfo.cs e post_script.sql com versões diferentes |
Garantir que ambos tenham a mesma versão |
¶ 
Estrutura de Referência do Projeto
SoftparkUpdater/
|-- SoftparkUpdater/
|-- Properties/
| |-- AssemblyInfo.cs <-- Versao do Assembly (VERSAO AQUI)
|-- Resources/
|-- SoftparkDatabase.dacpac <-- Arquivo do banco (dacpac)
|-- post_script.sql <-- Script pos-atualizacao (VERSAO AQUI)
|-- pre_script.sql <-- Script pre-atualizacao
|-- SystemFiles/ <-- Arquivos compilados do SoftparkIR
| |-- SoftPark.exe
| |-- SoftPark.pdb
| |-- *.dll
| |-- ...
|-- DLLs/
| |-- DLL_SITEF/ <-- DLLs do SiTef (override de producao)
|-- Runtimes/
|-- WebView2Loader.dll <-- Runtime WebView2
Pronto! Seguindo esse guia, a nova versão do atualizador estará pronta para distribuição.
Em caso de dúvidas, procure a equipe de desenvolvimento.