Partilhar via


Compilar aplicativos ClickOnce do .NET a partir da linha de comando

No Visual Studio, você pode compilar projetos a partir da linha de comando, mesmo que eles sejam criados no ambiente de desenvolvimento integrado (IDE). Na verdade, você pode recompilar um projeto criado com o Visual Studio em outro computador que tenha apenas o .NET 5 ou posterior instalado. Essa capacidade permite reproduzir um build usando um processo automatizado, por exemplo, em um laboratório de build central ou com técnicas avançadas de script além do escopo de compilação do próprio projeto.

Observação

Para compilar aplicativos ClickOnce .NET Framework da linha de comando, confira Compilar aplicativos ClickOnce da linha de comando.

Usar o MSBuild para reproduzir as implantações de aplicativo ClickOnce .NET

Quando você invoca msbuild /target:publish na linha de comando, esse comando dá instruções ao sistema MSBuild para compilar o projeto e criar um aplicativo ClickOnce na pasta de publicação. Esse comando é equivalente à seleção do comando Publicar no IDE.

Esse comando executa msbuild.exe, que está no caminho no ambiente de prompt de comando do Visual Studio.

Um "destino" é um indicador para o MSBuild sobre como processar o comando. Os principais destinos são o destino "build" e o destino "publicar". O destino build é o equivalente a selecionar o comando Build (ou pressionar F5) no IDE. Se você quiser apenas compilar seu projeto, insira msbuild. Esse comando funciona porque o destino build é o destino padrão para todos os projetos gerados pelo Visual Studio. Como um resultado, você não precisa especificar explicitamente o destino de build. Portanto, inserir msbuild é a mesma operação que inserir msbuild /target:build.

O comando /target:publish diz ao MSBuild para invocar o destino publicar. O destino de publicação depende do destino de build, o que significa que a operação de publicação é um superconjunto da operação de build. Por exemplo, se você fizer uma alteração nos arquivos de origem do Visual Basic ou C#, a operação de publicação recompila automaticamente um assembly correspondente.

Para obter informações sobre como gerar uma implantação completa do ClickOnce usando a ferramenta de linha de comando Mage.exe para criar seu manifesto do ClickOnce, confira o Passo a passo: implantar manualmente um aplicativo ClickOnce.

Criar e compilar um aplicativo básico ClickOnce com o MSBuild

A maneira mais fácil de criar um perfil de publicação é usando o Visual Studio. Um perfil de publicação é necessário para publicar com o MSBuild.

Criar e publicar um projeto do ClickOnce

  1. Abra o Visual Studio e crie um projeto.

    Escolha o modelo de projeto Aplicativo Windows Forms ou aplicativo WPF e nomeie o projeto como CmdLineDemo, e crie-o.

  2. Clique com o botão direito do mouse no projeto no Gerenciador de Soluções e selecione Publicar.

    Essa etapa garante que o projeto esteja configurado corretamente para produzir uma implantação de aplicativo ClickOnce.

    A página Publicar aparecerá.

  3. Na página Publicar, selecione Adicionar um perfil de publicação, escolha ClickOnce e selecione Concluir.

    Para este exercício, você pode ignorar as outras definições de configuração na página Publicar.

  4. Após a conclusão do processo, selecione Fechar para sair da caixa de diálogo da página Publicar.

  5. Selecione Publicar.

    O Visual Studio gera a saída de implantação do ClickOnce.

  6. Salve seu projeto e anote o local da pasta em que ele está armazenado.

    As etapas acima criam um projeto do ClickOnce que foi publicado pela primeira vez. Agora você pode reproduzir o build fora do IDE.

Reproduzir o build a partir da linha de comando

  1. Saia do Visual Studio.

  2. No menu Iniciar do Windows, selecione Ferramentas>Linha de Comando>Prompt de Comando do Desenvolvedor.

    O Prompt de Comando do Desenvolvedor do Visual Studio será aberto.

  3. No Prompt de Comando do Visual Studio, verifique se o diretório atual indica o local do projeto que você compilou anteriormente.

    Se você não estiver trabalhando no diretório do projeto, insira um comando para alterar para o local desejado, como chdir C:\Users\username\source\repos\CmdLineDemo.

  4. Para remover os arquivos existentes produzidos na seção anterior, insira rmdir /s publish.

    Essa etapa é opcional, mas garante que o build de linhas de comando produza todos os arquivos novos.

    Para o .NET 5 e posterior, a criação de aplicativos .NET ClickOnce por meio da linha de comando é uma experiência semelhante. A única diferença é que você precisa fornecer uma propriedade extra para o perfil de publicação na linha de comando do MSBuild.

  5. Digite msbuild /target:publish /p:PublishProfile=<pubxml file> /p:PublishDir="<specific location>".

    As etapas anteriores produzem uma implantação completa do aplicativo ClickOnce em uma subpasta do seu projeto chamada publicar. CmdLineDemo.application é o manifesto de implantação do ClickOnce. A pasta CmdLineDemo_1.0.0.0 contém os arquivos CmdLineDemo.exe e CmdLineDemo.exe.manifest, o manifesto do aplicativo ClickOnce. Setup.exe é o inicializador, que por padrão é configurado para instalar o .NET. Os arquivos nessa pasta incluem todo o conjunto de arquivos necessários para implantar seu aplicativo na Web ou por meio de UNC ou CD/DVD.

Observação

O sistema MSBuild usa a opção PublishDir para especificar o local para saída, como msbuild /t:publish /p:PublishProfile=<pubxml file> /p:PublishDir="<specific location>".

Publicar saída do processo

O MSBuild usa a propriedade PublishDir para definir o local de saída do build, incluindo artefatos de build. O valor PublishDir que o MSBuild usa como destino para a publicação é obtido por padrão da propriedade PublishDir no arquivo .pubxml (.NET). Você pode substituir esse comportamento na linha de comando do MSBuild usando a opção /p. Se você substituir a configuração, a saída de publicação irá para o local especificado. A saída é gerada durante a etapa publicar do MSBuild. Qualquer destino do MSBuild com AfterTargets="ClickOncePublish" é executado após essa cópia ser feita.

A propriedade PublishUrl, ao contrário de PublishDir, não é usada na etapa do MSBuild. PublishUrl é ignorado quando você invoca o MSBuild diretamente para publicar da linha de comando.

Quando a publicação é iniciada no IDE do Visual Studio, o Visual Studio invoca o MSBuild para publicar artefatos no local PublishDir. Depois que essa etapa do MSBuild for concluída, o Visual Studio publicará arquivos específicos do ClickOnce no local apontado por PublishUrl. Essa segunda etapa é executada dentro do processo do Visual Studio. Você não pode injetar nenhum destino/tarefa para execução durante esta etapa porque é um processo do Visual Studio.

Para implantações do MSBuild que não usam o Visual Studio, copie todos os arquivos no diretório de implantação para o destino ou a mídia de implantação. O diretório de implantação talvez seja uma pasta em um site ou site FTP, um compartilhamento de arquivos ou um CD-ROM. Por exemplo, você pode usar uma ferramenta de terceiros ou uma tarefa personalizada do MSBuild para copiar os arquivos ClickOnce.

Para qualquer pós-processamento na pasta PublishUrl, você precisa ter um script separado.

Importante

Se o PublishDir estiver definido como o mesmo local que PublishUrl, a saída de compilação duplicada será copiada para o local PublishUrl. Você pode evitar esse problema no Visual Studio 2022 versão 17.4 e posterior criando um novo perfil. O novo perfil define PublishDir como um local diferente do PublishUrl. No final da operação de publicação, os arquivos ClickOnce relevantes são copiados do PublishDir para o local PublishUrl.

Publicar propriedades

Quando você publica o aplicativo usando os procedimentos descritos anteriormente, as propriedades a seguir são inseridas no arquivo de perfil de publicação para projetos .NET (.NET 5 e posterior). Essas propriedades influenciam diretamente como o aplicativo ClickOnce é produzido.

Em .pubxml:

<AssemblyOriginatorKeyFile>WindowsApplication3.snk</AssemblyOriginatorKeyFile>
<GenerateManifests>true</GenerateManifests>
<TargetZone>LocalIntranet</TargetZone>
<PublisherName>Microsoft</PublisherName>
<ProductName>CmdLineDemo</ProductName>
<PublishUrl>http://localhost/CmdLineDemo</PublishUrl>
<Install>true</Install>
<ApplicationVersion>1.0.0.*</ApplicationVersion>
<ApplicationRevision>1</ApplicationRevision>
<UpdateEnabled>true</UpdateEnabled>
<UpdateRequired>false</UpdateRequired>
<UpdateMode>Foreground</UpdateMode>
<UpdateUrlEnabled>false</UpdateUrlEnabled>
<IsWebBootstrapper>true</IsWebBootstrapper>
<BootstrapperEnabled>true</BootstrapperEnabled>

Você pode substituir essas propriedades na linha de comando sem alterar o próprio arquivo de projeto. Por exemplo, o código a seguir compila a implantação do aplicativo ClickOnce sem o inicializador:

msbuild /target:publish /p:PublishProfile=<pubxml file> /property:BootstrapperEnabled=false

As propriedades de publicação são controladas no Visual Studio a partir das páginas de propriedade Publicar, Segurança e Assinatura do Designer de Projeto. Para projetos .NET (.NET 5 e posterior), essas configurações são fornecidas no arquivo pubxml, que você pode acessar no Visual Studio usando a ferramenta Publicar.

As propriedades de publicação a seguir são definidas em várias páginas de propriedades do designer de aplicativo.

  • AssemblyOriginatorKeyFile determina o arquivo de chave usado para assinar seus manifestos do aplicativo ClickOnce. Essa mesma chave também pode ser usada para atribuir um nome forte aos assemblies. Essa propriedade é definida na página Assinatura do Designer de Projeto. Para aplicativos Windows .NET, essa configuração permanece no arquivo de projeto.

As seguintes propriedades são definidas na página Publicar:

  • PublishUrl é o local no qual o aplicativo é publicado no IDE. Ele será inserido no manifesto do aplicativo ClickOnce se ambas as propriedades InstallUrl e UpdateUrl forem especificadas.

  • ApplicationVersion especifica a versão do aplicativo ClickOnce. A versão é um número de quatro dígitos. Se o último dígito for um "*" (asterisco), o ApplicationRevision será substituído pelo valor inserido no manifesto no momento do build.

  • ApplicationRevision especifica a revisão. Esse valor é um inteiro que incrementa cada vez que você publica no IDE. Observe que ele não é incrementado automaticamente para builds executados na linha de comando.

  • Install determina se o aplicativo é um aplicativo instalado ou um aplicativo executado pela Web.

  • InstallUrl (não mostrado) é o local a partir do qual os usuários instalam o aplicativo. Se especificado, esse valor será gravado no inicializador setup.exe se a propriedade IsWebBootstrapper estiver habilitada. Ele também será inserido no manifesto do aplicativo se o UpdateUrl não for especificado.

  • SupportUrl (não mostrado) é o local vinculado na caixa de diálogo Adicionar/Remover programas de um aplicativo instalado.

As propriedades a seguir são definidas na caixa de diálogo Atualizações do aplicativo, acessada na página Publicar.

  • UpdateEnabled indica se o aplicativo deve verificar se há atualizações.

  • UpdateMode especifica atualizações em primeiro plano. Para projetos .NET (.NET 5 e posterior), não há suporte para segundo plano.

  • UpdateUrl (não mostrado) é o local a partir do qual o aplicativo recebe atualizações. Se especificado, esse valor será inserido no manifesto do aplicativo.

As propriedades a seguir são definidas na caixa de diálogo Opções de publicação, acessada na página Publicar.

  • PublisherName especifica o nome do publicador exibido no prompt mostrado ao instalar ou executar o aplicativo. Para um aplicativo instalado, ele também é usado para especificar o nome da pasta no menu Iniciar.

  • ProductName especifica o nome do produto exibido no prompt mostrado ao instalar ou executar o aplicativo. Para um aplicativo instalado, ele também é usado para especificar o nome do atalho no menu Iniciar.

As propriedades a seguir são definidas na caixa de diálogo Pré-requisitos, acessada na página Publicar.

  • BootstrapperEnabled determina se o inicializador setup.exe deve ser gerado.

  • IsWebBootstrapper determina se o inicializador setup.exe funciona na Web ou no modo baseado em disco.

Use as opções: InstallURL, SupportUrl, PublishURL, UpdateURL

A tabela a seguir mostra as quatro opções de URL para implantação do ClickOnce.

Opção de URL Descrição
PublishURL Necessário para publicar o aplicativo ClickOnce em um site.
InstallURL Opcional. Defina essa opção de URL se o site de instalação for diferente de PublishURL. Por exemplo, você pode definir o PublishURL como um caminho FTP e definir o InstallURL como uma URL da Web.
SupportURL Opcional. Defina essa opção de URL se o site de suporte for diferente de PublishURL. Por exemplo, você pode definir o SupportURL para o site de suporte ao cliente da sua empresa.
UpdateURL Opcional. Defina essa opção de URL se o local de atualização for diferente de InstallURL. Por exemplo, você pode definir o PublishURL como um caminho FTP e definir o UpdateURL como uma URL da Web.