Compartilhar via


Como: Especificar um URL de suporte para pré-requisitos individuais em uma implantação do ClickOnce

sistema autônomo descrito em Pré-requisitos de implantação de aplicativo, um ClickOnce implantação pode testar para um número de pré-requisitos que devem estar disponível no computador cliente para o ClickOnce aplicativo seja executado. Incluem a versão mínima requerida do .NET Framework, a versão do sistema operacional e todos os assemblies que devem ser pré-instalados no cache de assemblies global (GAC). ClickOnce, no entanto, não é possível instalar qualquer um desses pré-requisitos propriamente dito; se não for encontrado um pré-requisito, ele simplesmente interromperá a instalação e exibe uma caixa de diálogo explicando por que a instalação falhou.

Há dois métodos para a instalação de pré-requisitos.Você pode, conforme explicado no documento chamado acima, instalá-los usando um aplicativo de bootstrapper.Como alternativa, você pode especificar um URL de suporte para pré-requisitos individuais, que é exibido para os usuários na caixa de diálogo se os pré-requisitos não for encontrado.A página referenciada por essa URL pode conter links para instruções sobre como instalar os pré-requisitos necessários.Se um aplicativo não especificar um URL de suporte para um pré-requisito individual, ClickOnce Exibe a URL de suporte especificada no manifesto de implantação para o aplicativo sistema autônomo um todo, se ela estiver definida.

Ao mesmo tempo em que Visual StudioMage.exe e MageUI.exe podem todos ser usados para gerar ClickOnce implantações, nenhuma dessas ferramentas diretamente suporte especificando um URL de suporte para pré-requisitos individuais. Este documento descreve como modificar manifesto do aplicativo do sua implantação incluir esses URLs de suporte.

Especificando um URL de suporte para um pré-requisito individual

  1. Abra o manifesto do aplicativo para o seu ClickOnce aplicativo em um editor de texto.

  2. Para um sistema operacional pré-requisito, adicione o supportUrl atributo para o dependentOS elemento:

     <dependency>
        <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
          <osVersionInfo>
            <os majorVersion="4" minorVersion="0" servicePackMajor="0" servicePackMinor="0" />
          </osVersionInfo>
        </dependentOS>
      </dependency>
    
  3. Para pré-requisito para uma determinada versão dos Common linguagem tempo de execução, adicione o supportUrl atributo para o dependentAssembly entrada especifica o Common linguagem tempo de execução dependência:

      <dependency>
        <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
          <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="2.0.40607.0" />
        </dependentAssembly>
      </dependency>
    
  4. Para pré-requisito para um assembly deve ser pré-instalado no cache de assembly global, definir o supportUrl para o dependentAssembly elemento que especifica o conjunto de módulos (assembly):

      <dependency>
        <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm">
          <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" />
        </dependentAssembly>
      </dependency>
    
  5. Depois que você tenha alterado manualmente o manifesto do aplicativo, você deve assinar novamente o manifesto do aplicativo usando o certificado digital, e, em seguida, regenerar e assinar novamente o manifesto de implantação.Você deve usar sistema autônomo ferramentas Mage.exe ou MageUI.exe SDK para realizar essa tarefa, sistema autônomo gerar esses arquivos usando Visual Studio Apaga sistema autônomo alterações manual. Para obter mais informações sobre como usar MageUI.exe para assinar e gerar manifestos, consulte Geração e Edição (Mage.exe) ferramenta de manifesto e Demonstra Passo a passo: Implantando um aplicativo ClickOnce manualmente.

Segurança

A URL de suporte não será exibida na caixa de diálogo se o aplicativo é marcado para ser executado em confiança parcial.

Consulte também

Conceitos

Implantação ClickOnce e Authenticode

Visão geral sobre a implantação do ClickOnce