How to: Especifique um suporte de URL 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 para executar. 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 na 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á-los usando um aplicativo de bootstrapper. Como alternativa, você pode especificar um URL de suporte para pré-requisitos individuais, o que é exibido aos 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 o URL de suporte especificado no manifesto de implantação para o aplicativo como um todo, se ela estiver definida.
Enquanto Visual Studio, Mage. exe e MageUI.exe podem todos ser usados para gerar ClickOnce suporte implantações, nenhuma dessas ferramentas diretamente para especificar uma 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 o 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 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 visam o.NET Framework 4, abra o manifesto de implantação (o arquivo. Application) para seu ClickOnce o aplicativo em um editor de texto.
Para um.NET de pré-requisito do 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 que você alterou manualmente o manifesto do aplicativo, você deve assinar novamente o manifesto do aplicativo usando o seu certificado digital, e em seguida, atualizar e assinar novamente o manifesto de implantação. Você deve usar o Mage ou ferramentas do SDK do MageUI.exe para realizar essa tarefa, como gerar esses arquivos usando Visual Studio apaga alterações manuais. Para obter mais informações sobre como usar o Mage para assinar novamente os manifestos, consulte How to: Re-assinar manifestos de aplicativo e implantação.
Segurança
A URL de suporte não é exibido na caixa de diálogo se o aplicativo é marcado para ser executado em confiança parcial.
Consulte também
Tarefas
Walkthrough: Manualmente, implantando um aplicativo de ClickOnce
Referência
Mage (geração de manifesto e ferramenta de edição)
<compatibleFrameworks> Elemento (implantação deClickOnce )