ClickOnce de criação de aplicativos da linha de comando

Em Visual Studio, você pode construir projetos a partir da linha de comando, mesmo se eles são criados no ambiente de desenvolvimento integrado (IDE). Na verdade, você pode reconstruir um projeto criado com Visual Studio em outro computador que tenha somente a .NET Framework instalado. Isso lhe permite reproduzir uma compilação usando um processo automatizado, por exemplo, em uma compilação de central de laboratório ou usando avançadas técnicas além do escopo do próprio projeto de criação de scripts.

Usando o MSBuild para reproduzir as implantações de aplicativos de ClickOnce

Quando você chama o /target:publish do msbuild na linha de comando, ele informa o sistema do MSBuild para construir o projeto e criar um ClickOnce o aplicativo na pasta ' Publicar '. Isso equivale a selecionar o Publicar comando no IDE.

Este comando executa o MSBuild. exe, está no caminho do ambiente de prompt de comando Visual Studio.

"Destino" é um indicador para MSBuild sobre como processar o comando. Os principais alvos são "build" destino e o "Publicar" destino. O destino de compilação é equivalente a selecionar a compilação comando (ou pressionando F5) no IDE. Se você apenas deseja construir seu projeto, você pode obter que digitando msbuild. Esse comando funciona porque o destino de compilação é o destino padrão para todos os projetos gerados por Visual Studio. Isso significa que você explicitamente não precisa especificar o destino de compilação. Portanto, digitando msbuild é a mesma operação que digitando msbuild /target:build.

O /target:publish comando instrui o MSBuild para invocar o destino de publicação. O destino de publicação depende do destino de compilação. Isso significa que a operação de publicação é um superconjunto da operação de compilação. Por exemplo, se você fez uma alteração em um dos arquivos de origem do Visual Basic ou C#, o assembly correspondente automaticamente ser reconstruído pela operação de publicação.

Para informações sobre como gerar um completo ClickOnce implantação usando a ferramenta de linha de comando Mage para criar seu ClickOnce manifesto, consulte Walkthrough: Manualmente, implantando um aplicativo de ClickOnce.

Criando e construindo um aplicativo de ClickOnce básica usando MSBuild

Para criar e publicar um projeto de ClickOnce

1. Clique em Novo projeto partir do arquivo menu. A caixa de diálogo New Project será exibida.

2. Selecione Windows Application e nomeie- CmdLineDemo.

3. Do Build menu, clique no Publicar comando.

   Esta etapa garante que o projeto está configurado corretamente para produzir um ClickOnce implantação de aplicativo.

   O Assistente de Publicação aparece.

4. No Publish Wizard, clique em Concluir.

   Visual Studio gera e exibe a página da Web padrão, chamada Publish.

5. Salve o projeto e anote o local da pasta na qual está armazenado.

As etapas acima criam uma ClickOnce projeto que foi publicado para a primeira vez. Agora você pode reproduzir a compilação fora do IDE.

Para reproduzir a compilação da linha de comando

1. Exit Visual Studio.

2. Do Windows Iniciar menu, clique em Todos os programas, em seguida, Visual Studio do Microsoft, em seguida, Visual Studio Tools, em seguida, Visual Studio Prompt de comando. Isso deve abrir um prompt de comando na pasta raiz do usuário atual.

3. No Visual Studio Prompt de comando de, mude o diretório atual para o local do projeto que você acabou de criar acima. Por exemplo, digite chdir Studio\Projects\CmdLineDemo de My Documents\Visual.

4. Para remover os arquivos existentes, produzidos em "criar e publicar um ClickOnce o projeto," tipo de a publicar rmdir /s.

   Esta etapa é opcional, mas garante que os novos arquivos todos produzidos pela compilação de linha de comando.

5. Tipo de msbuild /target: publicar.

As etapas acima produzirá uma completa ClickOnce implantação de aplicativos em uma subpasta do projeto chamada pblicar. CmdLineDemo.application é o ClickOnce manifesto de implantação. A pasta CmdLineDemo_1.0.0.0 contém os arquivos CmdLineDemo.exe e CmdLineDemo.exe.manifest, o ClickOnce manifesto de aplicativo. Setup. exe é o bootstrapper, que, por padrão, está configurado para instalar o .NET Framework. A pasta DotNetFX contém redistribuíveis para o .NET Framework. Este é todo o conjunto de arquivos que você precisa para implantar seu aplicativo pela Web ou por meio de CD/DVD ou UNC.

Propriedades de publicação

Quando você publica o aplicativo nos procedimentos acima, as propriedades a seguir são inseridas em seu arquivo de projeto, o Assistente de publicação. Essas propriedades diretamente influenciam como o ClickOnce aplicativo é produzido.

Em CmdLineDemo.vbproj / CmdLineDemo.csproj:

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

Você pode substituir qualquer uma dessas propriedades na linha de comando sem alterar o arquivo de projeto. Por exemplo, a seguir criará o ClickOnce implantação de aplicativos sem o bootstrapper:

msbuild /target:publish /property:BootstrapperEnabled=false

Propriedades de publicação são controladas no Visual Studio da Publicar, Security, e Signing páginas de propriedade da Project Designer. Abaixo está uma descrição das propriedades de publicação, juntamente com uma indicação de como cada um é definida em várias páginas de propriedade do designer de aplicativo:

• AssemblyOriginatorKeyFileDetermina o arquivo de chave usado para assinar seu ClickOnce manifestos de aplicativo. Essa mesma chave também pode ser usado para atribuir um nome forte para seus assemblies. Esta propriedade é definida na assinatura página da Project Designer.

As seguintes propriedades são definidas no Security página:

• Ativar configurações de segurança de ClickOnce determina se ClickOnce manifestos são gerados. Quando um projeto é criado inicialmente, ClickOnce geração de manifesto está desativado por padrão. O assistente automaticamente irá ativar esse sinalizador em quando você publica pela primeira vez.

• TargetZone determina o nível de confiança a ser emitido em seu ClickOnce manifesto de aplicativo. Valores possíveis são "Internet", "localintranet" e "Custom". Internet e LocalIntranet fará com que um conjunto de permissões padrão a ser emitido em seu ClickOnce manifesto de aplicativo. LocalIntranet é o padrão e isso significa, basicamente, confiança total. Custom Especifica que somente as permissões explicitamente especificadas no arquivo app. manifest base a ser emitido para o ClickOnce manifesto de aplicativo. O arquivo app. manifest é um arquivo de manifesto parcial que contém apenas as definições de informações de confiança. É um arquivo oculto, adicionado automaticamente ao seu projeto, quando você configurar permissões de Security página.

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

• PublishUrlé o local onde o aplicativo será publicado no IDE. É inserido o ClickOnce manifesto de aplicativo, caso nem a InstallUrl ou UpdateUrl propriedade for especificada.

• ApplicationVersionEspecifica a versão do ClickOnce aplicativo. Este é um número de versão de quatro dígitos. Se o último dígito é um "*", em seguida, a ApplicationRevision substituirá o valor inserido no manifesto em tempo de compilação.

• ApplicationRevisionEspecifica a revisão. Este é um inteiro que é incrementado toda vez que você publicar no IDE. Observe que não é incrementado automaticamente para compilações realizadas na linha de comando.

• InstallDetermina se o aplicativo é um aplicativo instalado ou um aplicativo de execução da Web.

• InstallUrl(não mostrado) é o local onde os usuários instalarão o aplicativo. Se especificado, esse valor é gravado para o bootstrapper Setup. exe, se a IsWebBootstrapper propriedade estiver ativada. Ele também é inserido na se manifesto de aplicativo do UpdateUrl não for especificado.

• SupportUrl(não mostrado) é o local vinculado a Adicionar ou remover programas caixa de diálogo para um aplicativo instalado.

As seguintes propriedades são definidas na Atualizações de aplicativos caixa de diálogo, acessada a partir de Publicar página.

• UpdateEnabledIndica se o aplicativo deve verificar as atualizações.

• UpdateModeEspecifica as atualizações de primeiro plano ou de atualizações em segundo plano.

• UpdateIntervalEspecifica a freqüência com que o aplicativo deve verificar atualizações.

• UpdateIntervalUnitsEspecifica se a UpdateInterval valor é em unidades de horas, dias ou semanas.

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

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

• PublisherNameEspecifica o nome do Editor exibido no prompt mostrado ao instalar ou executar o aplicativo. No caso de um aplicativo instalado, ele também é usado para especificar o nome da pasta do Iniciar menu.

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

• As seguintes propriedades são definidas na pré-requisitos caixa de diálogo, acessada a partir de Publicar página.

• BootstrapperEnabledDetermina se deve gerar bootstrapper Setup. exe.

• IsWebBootstrapperDetermina se o bootstrapper Setup. exe funciona pela Web ou no modo baseado em disco.

InstallURL, SupportUrl, PublishURL e UpdateURL

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

Consulte também

Tarefas

Walkthrough: Manualmente, implantando um aplicativo de ClickOnce

Referência

GenerateBootstrapper

GenerateApplicationManifest

GenerateDeploymentManifest

Conceitos

ClickOnce Segurança e implantação