Практическое руководство. Указание URL-адреса поддержки для определенных необходимых компонентов в развертывании ClickOnce
Развертывание ClickOnce может проверять ряд предварительных условий, которые должны соблюдаться на клиентском компьютере для выполнения приложения ClickOnce. Эти условия включают требуемую минимальную версию .NET Framework, версию операционной системы и версии всех сборок, которые должны быть предварительно установлены в глобальном кэше сборок. Однако ClickOnce не может выполнить любые из этих предварительных условий самостоятельно. Если предварительное условие не соблюдено, установка просто останавливается, и появляется диалоговое окно, содержащее объяснение, почему установка не завершилась успешно.
Существует два метода установки компонентов, составляющих предварительные условия. Их можно установить с помощью приложения загрузчика. В альтернативном варианте можно задать для отдельных предварительных условий вспомогательный URL-адрес, который отображается для пользователей в диалоговом окне, если предварительное условие не найдено. Страница, на которую ссылаются с помощью этого URL-адреса, может содержать ссылки на инструкции по установке требуемого предварительного условия. Если приложением не задается вспомогательный URL-адрес для отдельного предварительного условия, ClickOnce отображает вспомогательный URL-адрес, указываемый в манифесте развертывания для приложения в целом, если манифест определен.
Хотя Visual Studio, Mage.exe и MageUI.exe могут все использоваться для создания развертываний ClickOnce, ни одно из этих средств непосредственно не поддерживает задание вспомогательного URL-адреса для отдельных необходимых компонентов. В этом документе описывается, как изменить для развертывания манифест приложения и манифест развертывания, чтобы включить эти вспомогательные URL-адреса.
Задание вспомогательного URL-адреса для отдельного предварительного условия
Откройте манифест приложения (файл с расширением MANIFEST) для своего приложения ClickOnce в текстовом редакторе.
Для предварительного условия операционной системы добавьте атрибут supportUrl в элемент dependentOS:
<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>С целью соблюдения предварительного требования по определенной версии общеязыковой среды выполнения добавьте атрибут supportUrl в запись dependentAssembly, которая задает зависимость общеязыковой среды выполнения:
<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>С целью соблюдения предварительного условия по сборке, которая должна быть предустановлена в глобальном кэше сборок, установите supportUrl для элемента dependentAssembly, указывающего требуемую сборку:
<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>Необязательный. Для приложений, предназначенных для .NET Framework 4, откройте манифест развертывания (файл с расширением APPLICATION) для своего приложения ClickOnce в текстовом редакторе.
Чтобы добавить .NET Framework 4 в качестве необходимого компонента, добавьте в элемент compatibleFrameworks атрибут supportUrl:
<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>После того как манифест приложения изменен вручную, необходимо заново подписать манифест приложения с использованием своего цифрового сертификата, а затем также обновить и переподписать манифест развертывания. Для выполнения этой задачи необходимо использовать средства Mage.exe или MageUI.exe из набора SDK, так как при создании этих файлов с помощью Visual Studio удаляются изменения, внесенные вручную. Дополнительные сведения об использовании Mage.exe для переподписания манифестов см. в разделе Практическое руководство. Повторное подписание манифестов приложения и развертывания.
Безопасность
Вспомогательный URL-адрес не отображается в диалоговом окне, если приложение помечено для выполнения с определенным уровнем доверия.
См. также
Задачи
Разбор примера: развертывание вручную приложения ClickOnce
Ссылки
Mage.exe (средство создания и редактирования манифеста)
Элемент <compatibleFrameworks> (развертывание ClickOnce)