Манифест приложения ClickOnce

Статья
01/12/2024

Манифест приложения ClickOnce — это XML-файл, описывающий приложение, развернутое с помощью ClickOnce.

Манифесты приложения ClickOnce содержат следующие элементы и атрибуты.

Элемент	Description	Атрибуты
<Элемент assembly>	Обязательно. Это элемент верхнего уровня.	`manifestVersion`
<Элемент assemblyIdentity>	Обязательно. Определяет основную сборку приложения ClickOnce.	`name` `version` `publicKeyToken` `processorArchitecture` `language`
<Элемент trustInfo>	Определяет требования к безопасности приложения.	нет
<Элемент entryPoint>	Обязательно. Определяет точку входа кода приложения.	`name`
<Элемент зависимостей>	Обязательно. Определяет все зависимости, необходимые для выполнения приложения. При необходимости определяет сборки, которые требуется установить предварительно.	нет
<Элемент file>	Необязательно. Определяет каждый файл, отличный от сборки, используемый приложением. Может включать данные изоляции модели COM, связанные с этим файлом.	`name` `size` `group` `optional` `writeableType`
<Элемент fileAssociation>	Необязательно. Определяет расширение файла, связанное с приложением.	`extension` `description` `progid` `defaultIcon`

Замечания

Файл манифеста приложения ClickOnce определяет приложение, развернутое с помощью ClickOnce. Дополнительные сведения о развертывании с помощью ClickOnce см. в статье Развертывание и безопасность технологии ClickOnce.

Расположение файла

Манифест приложения ClickOnce зависит от одной версии развертывания. По этой причине они должны храниться отдельно от манифестов развертывания. Общее соглашение заключается в том, чтобы поместить их в подкаталог с именем соответствующей версии.

Манифест приложения всегда должен быть подписан перед развертыванием. При изменении манифеста приложения вручную необходимо использовать mage.exe для повторной подписи манифеста приложения, обновления манифеста развертывания и повторного подписывания манифеста развертывания. Дополнительные сведения см. в пошаговом руководстве. Развертывание приложения ClickOnce вручную.

Синтаксис имени файла

Имя файла манифеста приложения ClickOnce должно быть полным именем и расширением приложения, как указано в assemblyIdentity элементе, а затем расширением . manifest. Например, манифест приложения, ссылающийся на приложение Example.exe , будет использовать следующий синтаксис имени файла.

example.exe.manifest

Пример

В следующем примере кода показан манифест приложения для приложения ClickOnce.

<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly xsi:schemaLocation="urn:schemas-microsoft-com:asm.v1 assembly.adaptive.xsd" manifestVersion="1.0" xmlns:asmv3="urn:schemas-microsoft-com:asm.v3" xmlns:dsig="http://www.w3.org/2000/09/xmldsig#" xmlns:co.v2="urn:schemas-microsoft-com:clickonce.v2" xmlns="urn:schemas-microsoft-com:asm.v2" xmlns:asmv1="urn:schemas-microsoft-com:asm.v1" xmlns:asmv2="urn:schemas-microsoft-com:asm.v2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:co.v1="urn:schemas-microsoft-com:clickonce.v1">
  <asmv1:assemblyIdentity name="My Application Deployment.exe" version="1.0.0.0" publicKeyToken="43cb1e8e7a352766" language="neutral" processorArchitecture="x86" type="win32" />
  <application />
  <entryPoint>
    <assemblyIdentity name="MyApplication" version="1.0.0.0" language="neutral" processorArchitecture="x86" />
    <commandLine file="MyApplication.exe" parameters="" />
  </entryPoint>
  <trustInfo>
    <security>
      <applicationRequestMinimum>
        <PermissionSet Unrestricted="true" ID="Custom" SameSite="site" />
        <defaultAssemblyRequest permissionSetReference="Custom" />
      </applicationRequestMinimum>
      <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
        <!--
          UAC Manifest Options
          If you want to change the Windows User Account Control level replace the
          requestedExecutionLevel node with one of the following.

        <requestedExecutionLevel  level="asInvoker" uiAccess="false" />
        <requestedExecutionLevel  level="requireAdministrator" uiAccess="false" />
        <requestedExecutionLevel  level="highestAvailable" uiAccess="false" />

         If you want to utilize File and Registry Virtualization for backward
         compatibility then delete the requestedExecutionLevel node.
    -->
        <requestedExecutionLevel level="asInvoker" uiAccess="false" />
      </requestedPrivileges>
    </security>
  </trustInfo>
  <dependency>
    <dependentOS>
      <osVersionInfo>
        <os majorVersion="4" minorVersion="10" buildNumber="0" servicePackMajor="0" />
      </osVersionInfo>
    </dependentOS>
  </dependency>
  <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true">
      <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.20506.0" />
    </dependentAssembly>
  </dependency>
  <dependency>
    <dependentAssembly dependencyType="install" allowDelayedBinding="true" codebase="MyApplication.exe" size="4096">
      <assemblyIdentity name="MyApplication" version="1.0.0.0" language="neutral" processorArchitecture="x86" />
      <hash>
        <dsig:Transforms>
          <dsig:Transform Algorithm="urn:schemas-microsoft-com:HashTransforms.Identity" />
        </dsig:Transforms>
        <dsig:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
        <dsig:DigestValue>DpTW7RzS9IeT/RBSLj54vfTEzNg=</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
<publisherIdentity name="CN=DOMAINCONTROLLER\UserMe" issuerKeyHash="18312a18a21b215ecf4cdb20f5a0e0b0dd263c08" /><Signature Id="StrongNameSignature" xmlns="http://www.w3.org/2000/09/xmldsig#">
...
</Signature></r:issuer></r:license></msrel:RelData></KeyInfo></Signature></asmv1:assembly>

См. также

Публикация приложений ClickOnce