desktop6：CustomInstall

可讓您的桌面應用程式指定隨傳統型應用程式一起安裝的其他一或多個安裝程式檔案（.exe 或 .msi）。 例如，這適用於組合第三方可轉散發元件的應用程式。

注意

此元素目前僅供Microsoft和合作夥伴發行的特定桌面電腦遊戲類型使用。 它需要 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受限制的功能。

OS 會使用 desktop6：InstallAction、desktop6：RepairAction和 desktop6：UninstallAction 元素的 Name 屬性來識別一組相關的安裝、修復和卸載動作。 若要指定應該與彼此一起執行的一組相關動作，請確定它們具有與 Name 屬性相同的值。 只有在已執行對應的安裝或修復動作時，OS 才會執行卸載動作。

例子

<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>

要求

專案	價值
Namespace	http://schemas.microsoft.com/appx/manifest/desktop/windows10/6
最低 OS 版本	Windows 10 版本 1903 （組建 18362）