Практическое руководство. Указание URL-адреса поддержки для определенных необходимых компонентов в развертывании ClickOnce
Обновлен: Ноябрь 2007
Как описано в разделе Предварительные условия для развертывания приложения, развертывание ClickOnce может проверять ряд предварительных условий, которые должны соблюдаться на клиентском компьютере для выполнения приложения ClickOnce. Эти условия включают требуемую минимальную версию .NET Framework, версию операционной системы и версии всех сборок, которые должны быть предварительно установлены в глобальном кэше сборок. Однако ClickOnce не может выполнить любые из этих предварительных условий самостоятельно. Если предварительное условие не соблюдено, установка просто останавливается, и появляется диалоговое окно, содержащее объяснение, почему установка не завершилась успешно.
Существует два метода установки компонентов, составляющих предварительные условия. Как объясняется в упомянутой выше документации, можно установить эти компоненты, используя приложение загрузчика. В альтернативном варианте можно задать для отдельных предварительных условий вспомогательный URL-адрес, который отображается для пользователей в диалоговом окне, если предварительное условие не найдено. Страница, на которую ссылаются с помощью этого URL-адреса, может содержать ссылки на инструкции по установке требуемого предварительного условия. Если приложением не задается вспомогательный URL-адрес для отдельного предварительного условия, ClickOnce отображает вспомогательный URL-адрес, указываемый в манифесте развертывания для приложения в целом, если манифест определен.
Хотя Visual Studio, Mage.exe и MageUI.exe могут все использоваться для создания развертываний ClickOnce, ни одно из этих средств непосредственно не поддерживает задание вспомогательного URL-адреса для отдельных предварительных условий. В этом документе описывается, как изменить для развертывания манифест приложения, чтобы включить эти вспомогательные URL-адреса.
Задание вспомогательного URL-адреса для отдельного предварительного условия
Откройте в текстовом редакторе манифест приложения для используемого приложения ClickOnce.
Для предварительного условия операционной системы добавьте атрибут supportUrl в элемент dependentOS:
<dependency> <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm"> <osVersionInfo> <os majorVersion="4" minorVersion="0" 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="2.0.40607.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>После того как манифест приложения изменен вручную, следует заново подписать манифест приложения, используя свой цифровой сертификат, затем необходимо также повторно создать и переподписать манифест развертывания. Для выполнения этой задачи необходимо использовать средства Mage.exe или MageUI.exe из набора SDK, так как при создании этих файлов с помощью Visual Studio удаляются изменения, внесенные вручную. Дополнительные сведения об использовании MageUI.exe для подписи и генерирования манифестов см. в разделах Средство создания и редактирования манифеста (Mage.exe) и Пошаговое руководство. Развертывание приложения ClickOnce вручную.
Безопасность
Вспомогательный URL-адрес не отображается в диалоговом окне, если приложение помечено для выполнения с определенным уровнем доверия.