desktop6:CustomInstall

Статья
08/17/2024

Позволяет классическому приложению указать один или несколько дополнительных файлов установщика (.exe или .msi), установленных в классическом приложении. Например, это полезно для приложений, которые объединяют сторонний распространяемый компонент.

Заметка

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

Иерархия элементов

пакета

<расширения>

<desktop6:Extension>

<desktop6:CustomInstall>

Синтаксис

<desktop6:CustomInstall
  Folder = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.' 
  desktop8:RunAsUser = 'An optional boolean value.'>

  <!-- Child elements -->
  desktop6:InstallActions
  desktop6:RepairActions
  desktop6:UninstallActions?

</desktop6:CustomInstall>

Ключ

? необязательный (ноль или один)

Атрибуты и элементы

Атрибуты

Атрибут	Описание	Тип данных	Обязательно	Значение по умолчанию
папки	Имя папки пакета, содержащей все файлы, необходимые для всех пользовательских действий. Эта папка может содержать вложенные папки.	Строка со значением от 1 до 256 символов длиной, которая не может содержать следующие символы: `<`, `>`, `:`, `"`, `\|`, `?`или `*`.	Да

Дочерние элементы

Дочерний элемент	Описание
InstallActions	Указывает файлы установщика, которые выполняются перед первым запуском классического приложения.
RepairActions	Указывает файлы установщика, которые выполняются, когда пользователь выбирает параметры восстановления или сброса на странице "Параметры" для классического приложения.
UninstallActions	Указывает файлы установщика, которые выполняются при удалении классического приложения пользователем.

Родительские элементы

Родительский элемент	Описание
desktop6:Extension	Объявляет точку расширяемости для классического приложения.
desktop8:RunAsUser	Указывает, должна ли задача выполняться от имени текущего пользователя.

Замечания

Для этого элемента требуется customInstallActionsограниченные возможности.

ОС использует атрибут Name для элементов desktop6:InstallAction, desktop6:RepairActionи desktop6:UninstallAction для определения связанного набора действий установки, восстановления и удаления. Чтобы указать связанный набор действий, которые должны выполняться вместе друг с другом, убедитесь, что они имеют одинаковое значение для атрибута Name. ОС будет запускать действие удаления только в том случае, если выполняется соответствующее действие установки или восстановления.

Примеры

<Package
  xmlns:desktop6="http://schemas.microsoft.com/appx/manifest/desktop/windows10/6"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
  IgnorableNamespaces="rescap desktop6">

  <!-- ... -->
  <!-- Other entries omitted for brevity. -->
  <!-- ... -->

  <Extensions>
    <desktop6:Extension Category="windows.customInstall">
      <desktop6:CustomInstall Folder="MyInstallers">
        <desktop6:InstallActions>
          <desktop6:InstallAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/add /silent" />
        </desktop6:InstallActions>
        <desktop6:RepairActions>
          <desktop6:RepairAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/add /silent /force" />
        </desktop6:RepairActions>
        <desktop6:UninstallActions>
          <desktop6:UninstallAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/remove /silent" />
        </desktop6:UninstallActions>
      </desktop6:CustomInstall>
    </desktop6:Extension>
  </Extensions>

  <Capabilities>
    <rescap:Capability Name="customInstallActions"/>
  </Capabilities>
</Package>

Требования

Пункт	Ценность
Пространство имен	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/6`
минимальная версия ОС	Windows 10 версии 1903 (сборка 18362)

Поделиться через