Como: especificar um URL de suporte para os pré-requisitos individuais em uma implantação de ClickOnce
A ClickOnce implantação pode testar um número de pré-requisitos que devem estar disponíveis no computador cliente para o ClickOnce aplicativo seja executado.Elas incluem a versão mínima necessária da .NET Framework, a versão do sistema operacional e todos os assemblies que devem ser pré-instalado no cache global de assemblies (GAC).ClickOnce, no entanto, não é possível instalar qualquer um desses pré-requisitos propriamente dito; Se um pré-requisito não for encontrado, ele simplesmente pára a instalação e exibe uma caixa de diálogo explicando por que a instalação falhou.
Há dois métodos para instalar os pré-requisitos.Você pode instalá-las usando um aplicativo de bootstrapper.Como alternativa, você pode especificar um URL de suporte para pré-requisitos individuais, o que é exibido para os usuários na caixa de diálogo se o pré-requisito 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 o URL de suporte especificado no manifesto de implantação para o aplicativo como um todo, se ela estiver definida.
Enquanto Visual Studio, MageUI.exe e Mage podem todos ser usado para gerar ClickOnce implantações, nenhuma dessas ferramentas apóiam especificando um URL de suporte para pré-requisitos individuais.Este documento descreve como modificar a sua implantação manifesto de aplicativo e manifesto de implantação incluir esses URLs de suporte.
Especificando um URL de suporte para um pré-requisito individual
Abra o manifesto do aplicativo (o arquivo. manifest) para seu ClickOnce aplicativo em um editor de texto.
Para um pré-requisito do sistema operacional, adicionar o supportUrl de atributo para o dependentOS elemento:
<dependency> <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm"> <osVersionInfo> <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" /> </osVersionInfo> </dependentOS> </dependency>Para um pré-requisito para uma determinada versão do common language runtime, adicione a supportUrl de atributo para o dependentAssembly entrada que especifica a dependência de tempo de execução de linguagem comum:
<dependency> <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm"> <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" /> </dependentAssembly> </dependency>Para um pré-requisito para um assembly que deve ser pré-instalado no cache global de assemblies, defina a supportUrl para o dependentAssembly o elemento que especifica o assembly necessário:
<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>Opcional.Para aplicativos que se destinam a.NET Framework 4, abra o manifesto de implantação (o arquivo. Application) para seu ClickOnce aplicativo em um editor de texto.
Para um.NET pré-requisito Framework 4, adicione a supportUrl de atributo para o compatibleFrameworks elemento:
<compatibleFrameworks xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm"> <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" /> <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" /> </compatibleFrameworks>Depois de você ter alterado manualmente o manifesto do aplicativo, você deve assinar novamente o manifesto do aplicativo usando o certificado digital, e em seguida, atualizar e assinar novamente o manifesto da implantação.Você deve usar o Mage ou de ferramentas do SDK do MageUI.exe para realizar essa tarefa, como gerar esses arquivos usando Visual Studio apaga as alterações manuais.Para obter mais informações sobre como usar Mage para assinar novamente os manifestos, consulte Como: assinar novamente os manifestos de aplicativo e implantação.
Segurança
A URL de suporte não é exibido na caixa de diálogo se o aplicativo estiver marcado para ser executado em confiança parcial.
Consulte também
Tarefas
Passo a passo: Manualmente implantando um aplicativo de ClickOnce
Referência
Mage (geração de manifesto e ferramenta de edição)
<compatibleFrameworks> Elemento (implantação de ClickOnce)