Criando aplicativos ClickOnce na linha de comando

  • Artigo

In Visual Studio, você pode compilação projetos da linha de comando, mesmo que eles são criados no ambiente de desenvolvimento integrado (IDE). Na verdade, você poderá recompilar um projeto criado com Visual Studio em outro computador que tem apenas o .NET Framework instalado. Assim, você pode reproduzir uma compilação usando um processo automatizado, por exemplo, em uma compilação central laboratório ou usando o avançado scripts técnicas além do escopo da criação de projeto propriamente dito.

Usando MSBuild para reproduzir aplicativo implantações do ClickOnce

Quando você chamar MS compilação / destino: publicar na linha de comando, ele informa o MSBuild sistema compilação o projeto e criar um ClickOnce aplicativo na pasta de publicação. Isso equivale a selecionar o Publicar comando no IDE.

Este comando executa msbuild.exe, que se encontra o caminho no ambiente de aviso de comando do Visual Studio.

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

The / target: publicar comando informa ao MSBuild para invocar o destino de publicação.O destino de publicar depende do destino de compilação.Isso significa que a operação de publicar é um superconjunto da operação de compilação.Por exemplo, se você fez uma alterar em um dos arquivos de fonte do Visual Basic ou translation from VPE for Csharp, assembly correspondente deve ser reconstruído automaticamente pela operação de publicar.

Para obter informações sobre como gerar um completo ClickOnce implantação usando a ferramenta de linha de comando Mage.exe para criar seu ClickOnce manifesto, consulte Demonstra Passo a passo: Implantando manualmente um aplicativo ClickOnce.

Criando e desenvolvendo um aplicativo ClickOnce básica usando MSBuild

Para criar e publicar um projeto do ClickOnce

  1. clicar Novo projeto from the Arquivo menu.A caixa de diálogo New Project será exibida.

  2. selecionar aplicativos do Windows e nomeie- CmdLineDemo.

  3. From a Compilação menu, clicar no Publicarcomando .

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

    O Assistente de publicar é exibido.

  4. No Assistente para publicar, clicar Concluir.

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

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

As etapas acima criam um ClickOnce projeto que foi publicado pela primeira vez. Agora é possível reproduzir a compilação fora do IDE.

Para reproduzir a compilação da linha de comando

  1. SairVisual Studio.

  2. From a Windows Iniciar menu, clicar Todos os programas, then Microsoft Visual Studio 2008, then O Visual Studio Tools, then O Visual Studio 2008 aviso de comando.Isso deve em aberto um aviso de comando na pasta raiz do usuário corrente.

  3. No aviso de comando do Visual Studio 2008, altere a pasta corrente para o local do projeto que acabou criado acima.Por exemplo, digite Meus Documentos\Visual Studio\Projects\CmdLineDemo chdir.

  4. Para remover os arquivos existentes produzidos em "para criar e publicar umaClickOnceprojeto,"tipo rmdir /s publicar.

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

  5. Tipo de / MSBuild destino: publicar.

As etapas acima produzirá um completo ClickOnce aplicativo implantação em uma subpasta do seu projeto chamado Publicar.CmdLineDemo.aplicativo é de ClickOnce manifesto de implantação. A pasta CmdLineDemo_1.0.0.0 contém os arquivos CmdLineDemo.exe e CmdLineDemo.exe.manifest, a ClickOnce manifesto do aplicativo. Setup.exe é o bootstrapper, que, por padrão, está configurado para instalar o .NET Framework. A pasta DotNetFX contém os redistribuíveis para o .NET Framework. Este é o conjunto inteiro de arquivos que necessários para implantar seu aplicativo através da Web ou via 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 pelo Assistente de publicar.Essas propriedades diretamente influenciam como a 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 essas propriedades na linha de comando sem alterar o próprio arquivo de projeto.Por exemplo, a seguir criará o ClickOnce aplicativo implantação sem o bootstrapper:

msbuild /target:publish /property:BootstrapperEnabled=false

Propriedades de publicação são controladas em Visual Studio do Publicar, Segurança, and Assinatura páginas de propriedades de do Designer de projeto.A seguir é uma descrição das propriedades de publicação, juntamente com uma indicação de como cada um é conjunto nas páginas de propriedade vários do designer de aplicativo:

  • AssemblyOriginatorKeyFile Determina o arquivo de chave usado para assinar seu ClickOnce manifestos de aplicativo. Também é possível usar essa mesma chave para atribuir um nome forte para os módulos (assemblies).Esta propriedade é conjunto sobre o Assinatura página de do Designer de projeto.

As propriedades a seguir são conjunto sobre o Segurança página:

  • Habilitar configurações de segurança do 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 irá ativar automaticamente este sinalizar ao publicar para a primeira time.

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

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

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

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

  • ApplicationRevision Especifica 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.

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

  • InstallUrl (não mostrado) é o local onde os usuários instalarão o aplicativo. Se especificado, esse valor é gravado no bootstrapper setup.exe se o IsWebBootstrapper propriedade está ativada. Também é inserido na se manifesto do aplicativo o UpdateUrl não foi especificado.

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

As propriedades a seguir são conjunto no Atualizações de aplicativo caixa de diálogo , acessada a partir de Publicar página.

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

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

  • UpdateInterval Especifica a freqüência com a qual o aplicativo deve verificar as atualizações.

  • UpdateIntervalUnits Especifica se a UpdateInterval valor se encontra nas unidades de horas, dias ou semanas.

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

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

  • PublisherName Especifica o nome do publicador exibido solicitação mostrada ao instalar ou executar o aplicativo. No caso de um aplicativo instalado, ele também é usado para especificar o nome da pasta no Iniciar menu.

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

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

  • BootstrapperEnabled Determina se deve gerar bootstrapper setup.exe.

  • IsWebBootstrapper Determina se o bootstrapper setup.exe funciona pela Web ou no modo baseado em disco.

InstallURL SupportUrl e PublishURL

Você pode especificar três URLs: InstallURL, SupportUrl, e PublishURL. Se você estiver publicação um URL da Web e, em seguida, apenas PublishURL deve ser especificado. Você só precisará especificar outras URLs se forem diferentes do PublishURL. No IDE, é aconselhável publicar em um caminho diferente do qual os usuários finais instalar.Por exemplo, você pode definir o PublishURL um caminho de FTP e o conjunto a InstallURL para uma URL da Web. Nesse caso, a PublishURL é usado apenas no IDE transferência os arquivos, mas não é usado em compilações de linha de comando. Finalmente, você pode usar UpdateUrl Se você quiser publicar um ClickOnce aplicativo atualiza-se de um local separado do qual ele está instalado.

Consulte também

Tarefas

Demonstra Passo a passo: Implantando manualmente um aplicativo ClickOnce

Conceitos

Visão geral do MSBuild

Outros recursos

Implantação do ClickOnce

Date

History

Motivo

Julho de 2008

Atualizar a lista de valores válido para o TargetZone propriedade.

Correção de bug do conteúdo.