使用套件延伸模組將傳統型應用程式與 Windows 整合

發行項
05/07/2024

如果您的傳統型應用程式已封裝 (在執行階段具備套件識別資料)，則您可以使用延伸模組，藉由使用封裝資訊清單中的延伸模組 (已預先定義)，將您的應用程式與 Windows 10 整合。另請參閱需要套件識別資料的功能。

例如：使用延伸模組建立防火牆例外，讓您的應用程式成為某一種檔案類型的預設應用程式，或將開始畫面磚指向您的應用程式。若要使用延伸模組，您只需要將一些 XML 加入應用程式的封裝資訊清單檔案。不需要程式碼。

此主題會描述這些延伸模組，以及您可以使用這些延伸模組執行的工作。

注意

本主題所述的功能需要封裝您的應用程式 (在執行階段具備套件識別資料)。這包括已封裝的應用程式 (請參閱為已封裝的 WinUI 3 傳統型應用程式建立新專案)，以及具有外部位置的封裝應用程式 (請參閱使用外部位置封裝來授與套件識別資料)。另請參閱需要套件識別資料的功能。

將使用者轉換至您的應用程式

協助使用者轉換至您已封裝的應用程式。

將現有的傳統型應用程式重新導向至已封裝的應用程式
將現有的開始畫面磚和工作列按鈕指向您已封裝的應用程式
使用您已封裝的應用程式開啟檔案，而非使用您的傳統型應用程式
將已封裝的應用程式和一組檔案類型建立關聯
將選項新增至具有特定檔案類型的檔案操作功能表
使用 URL 直接開啟特定類型的檔案

將現有的傳統型應用程式重新導向至已封裝的應用程式

當使用者啟動現有的未封裝傳統型應用程式時，您可以改為將已封裝的應用程式設定為開啟。

注意

Windows Insider 預覽組建 21313 和更新版本支援此功能。

若要啟用此行為：

新增登錄項目以將未封裝的傳統型應用程式可執行檔重新導向至已封裝的應用程式。
註冊您的已封裝應用程式，以在啟動未封裝的傳統型應用程式可執行檔時啟動。

新增登錄項目以重新導向至未封裝的傳統型應用程式可執行檔

在登錄中，在 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options 機碼之下建立具有傳統型應用程式可執行檔名稱的子機碼。
在此子機碼下，新增下列值：
- AppExecutionAliasRedirect (DWORD)：如果設定為 1，則系統將會檢查是否存在與可執行檔相同名稱的 AppExecutionAlias 封裝延伸模組。如果已啟用 AppExecutionAlias 延伸模組，則會使用該值啟動已封裝的應用程式。
- AppExecutionAliasRedirectPackages (REG_SZ)：系統只會重新導向至所列出的套件。套件會依其套件系列名稱列出，並以分號分隔。如果使用特殊值 *，系統會從任何套件重新導向至 AppExecutionAlias。

例如：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\contosoapp.exe 
    AppExecutionAliasRedirect = 1
    AppExecutionAliasRedirectPackages = "Microsoft.WindowsNotepad_8weky8webbe"

註冊要啟動的已封裝應用程式

在您的封裝資訊清單中，新增 AppExecutionAlias 延伸模組，以註冊未封裝傳統型應用程式可執行檔的名稱。例如：

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap3:Extension Category="windows.appExecutionAlias" EntryPoint="Windows.FullTrustApplication">
          <uap3:AppExecutionAlias>
            <desktop:ExecutionAlias Alias="contosoapp.exe" />
          </uap3:AppExecutionAlias>
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

停用重新導向

使用者可以關閉重新導向，並透過下列選項啟動未封裝的應用程式可執行檔：

他們可以針對已封裝的應用程式版本進行解除安裝。
使用者可以在 [設定] 的 [應用程式執行別名] 頁面中停用已封裝應用程式的 AppExecutionAlias 項目。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10/3
http://schemas.microsoft.com/appx/manifest/desktop/windows10

此延伸模組的元素和屬性

<uap3:Extension
    Category="windows.appExecutionAlias"
    EntryPoint="Windows.FullTrustApplication">
    <uap3:AppExecutionAlias>
        <desktop:ExecutionAlias Alias="[AliasName]" />
    </uap3:AppExecutionAlias>
</uap3:Extension>

名稱	描述
類別	一律為 `windows.appExecutionAlias`。
可執行檔	叫用別名時，要啟動的可執行檔相對路徑。
Alias	適用於您應用程式的簡短名稱。其必須一律以副檔名「.exe」結尾。

將現有的開始畫面磚和工作列按鈕指向您已封裝的應用程式

您的使用者可能會將您的傳統型應用程式釘選至工作列或 [開始] 功能表。您可以將這些捷徑指向新的已封裝應用程式。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

此延伸模組的元素和屬性

<Extension Category="windows.desktopAppMigration">
    <DesktopAppMigration>
        <DesktopApp AumId="[your_app_aumid]" />
        <DesktopApp ShortcutPath="[path]" />
    </DesktopAppMigration>
</Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.desktopAppMigration`。
AumID	封裝應用程式的應用程式使用者模型識別碼。
ShortcutPath	啟動您傳統型版本應用程式之 .lnk 檔案的路徑。

範例

<Package
  xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="rescap3">
  <Applications>
    <Application>
      <Extensions>
        <rescap3:Extension Category="windows.desktopAppMigration">
          <rescap3:DesktopAppMigration>
            <rescap3:DesktopApp AumId="[your_app_aumid]" />
            <rescap3:DesktopApp ShortcutPath="%USERPROFILE%\Desktop\[my_app].lnk" />
            <rescap3:DesktopApp ShortcutPath="%APPDATA%\Microsoft\Windows\Start Menu\Programs\[my_app].lnk" />
            <rescap3:DesktopApp ShortcutPath="%PROGRAMDATA%\Microsoft\Windows\Start Menu\Programs\[my_app_folder]\[my_app].lnk"/>
         </rescap3:DesktopAppMigration>
        </rescap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

具有轉換/移轉/解除安裝的 WPF 圖片檢視器

使用您已封裝的應用程式開啟檔案，而非使用您的傳統型應用程式

您可以確保使用者預設使用您新的已封裝應用程式開啟特定類型的檔案，而非使用您傳統型版本的應用程式開啟。

若要完成這項工作，您可以針對想要繼承檔案關聯的每個應用程式，為其指定程式設計識別碼 (ProgID)。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10/3
http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

此延伸模組的元素和屬性

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
         <MigrationProgIds>
            <MigrationProgId>"[ProgID]"</MigrationProgId>
        </MigrationProgIds>
    </FileTypeAssociation>
</Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.fileTypeAssociation`。
名稱	檔案類型關聯的名稱。您可以使用此名稱來組織檔案類型，並將其分組。名稱必須全部是小寫，而且沒有任何空格。
MigrationProgId	程式設計識別碼 (ProgID) 針對您想要繼承檔案關聯的傳統型應用程式，描述其應用程式、元件，以及版本。

範例

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="uap3, rescap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <rescap3:MigrationProgIds>
              <rescap3:MigrationProgId>Foo.Bar.1</rescap3:MigrationProgId>
              <rescap3:MigrationProgId>Foo.Bar.2</rescap3:MigrationProgId>
            </rescap3:MigrationProgIds>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

具有轉換/移轉/解除安裝的 WPF 圖片檢視器

將已封裝的應用程式和一組檔案類型建立關聯

您可以將已封裝的應用程式和檔案類型副檔名產生關聯。如果使用者以滑鼠右鍵按一下 [檔案總管] 中的檔案，然後選取 [開啟檔案] 選項，則您的應用程式會出現在建議清單中。如需使用此延伸模組的詳細資訊，請參閱將已封裝傳統型應用程式與檔案總管進行整合。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/3

此延伸模組的元素和屬性

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[file extension]"</FileType>
        </SupportedFileTypes>
    </FileTypeAssociation>
</Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.fileTypeAssociation`。
名稱	檔案類型關聯的名稱。您可以使用此名稱來組織檔案類型，並將其分組。名稱必須全部是小寫，而且沒有任何空格。
FileType	您的應用程式支援的副檔名。

範例

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="mediafiles">
            <uap:SupportedFileTypes>
            <uap:FileType>.avi</uap:FileType>
            </uap:SupportedFileTypes>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

具有轉換/移轉/解除安裝的 WPF 圖片檢視器

將選項新增至具有特定檔案類型的檔案操作功能表

此延伸模組可讓您在使用者以滑鼠右鍵按一下 [檔案總管] 中的檔案時，能夠在所顯示的操作功能表中新增選項。這些選項可為使用者提供更多與您檔案互動的方式，例如：列印、編輯，或預覽檔案。如需使用此延伸模組的詳細資訊，請參閱將已封裝傳統型應用程式與檔案總管進行整合。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/2
http://schemas.microsoft.com/appx/manifest/uap/windows10/3

此延伸模組的元素和屬性

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedVerbs>
           <Verb Id="[ID]" Extended="[Extended]" Parameters="[parameters]">"[verb label]"</Verb>
        </SupportedVerbs>
    </FileTypeAssociation>
</Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.fileTypeAssociation`。
名稱	檔案類型關聯的名稱。您可以使用此名稱來組織檔案類型，並將其分組。名稱必須全部是小寫，而且沒有任何空格。
動詞命令	在 [檔案總管] 操作功能表中出現的名稱。此字串可使用 `ms-resource` 進行當地語系化。
Id	動詞的唯一識別碼。若您的應用程式為 UWP 應用程式，則此識別碼會傳送至應用程式做為啟用事件引數的一部分，以便能夠適當處理使用者的選擇。如果您的應用程式是完全信任的封裝應用程式，則該應用程式會改為接收參數 (請參閱下一個項目符號)。
參數	與動詞關聯的引數參數和值清單。如果您的應用程式為完全信任的已封裝應用程式，這些參數會傳遞至應用程式做為啟動應用程式時的事件引數。您可以根據不同的啟用動詞。自訂應用程式的行為。如果變數包含檔案路徑，請使用引號括住參數。這樣可避免路徑中包含空格時發生任何問題。如果您的應用程式是 UWP 應用程式，則無法傳遞參數。應用程式會改為接收識別碼 (請參閱上一個項目符號)。
擴充的	指定僅在使用者以滑鼠右鍵按一下檔案之前，先按住 Shift 鍵以顯示操作功能表時，才會顯示動詞。此屬性為選擇性，而且預設值為 False (例如，一律顯示動詞)。您會針對每個動詞個別指定此行為 (不包括「開啟」，其一律設定為 False)。

範例

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"

  IgnorableNamespaces="uap, uap2, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap2:SupportedVerbs>
              <uap3:Verb Id="Edit" Parameters="/e &quot;%1&quot;">Edit</uap3:Verb>
              <uap3:Verb Id="Print" Extended="true" Parameters="/p &quot;%1&quot;">Print</uap3:Verb>
            </uap2:SupportedVerbs>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

具有轉換/移轉/解除安裝的 WPF 圖片檢視器

使用 URL 直接開啟特定類型的檔案

您可以確保使用者預設使用您新的已封裝應用程式開啟特定類型的檔案，而非使用您傳統型版本的應用程式開啟。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/3

此延伸模組的元素和屬性

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]" UseUrl="true" Parameters="%1">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
    </FileTypeAssociation>
</Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.fileTypeAssociation`。
名稱	檔案類型關聯的名稱。您可以使用此名稱來組織檔案類型，並將其分組。名稱必須全部是小寫，而且沒有任何空格。
UseUrl	指出是否要直接從 URL 目標開啟檔案。如果您未設定這個值，每當您的應用程式嘗試使用 URL 開啟檔案時，都會讓系統先將檔案下載至本機電腦。
參數	選用參數。
FileType	相關副檔名。

範例

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap3">
  <Applications>
      <Application>
        <Extensions>
          <uap:Extension Category="windows.fileTypeAssociation">
            <uap3:FileTypeAssociation Name="myfiletypes" UseUrl="true" Parameters="%1">
              <uap:SupportedFileTypes>
                <uap:FileType>.txt</uap:FileType>
                <uap:FileType>.doc</uap:FileType>
              </uap:SupportedFileTypes>
            </uap3:FileTypeAssociation>
          </uap:Extension>
        </Extensions>
      </Application>
    </Applications>
</Package>

為您的應用程式建立防火牆例外

如果您的應用程式需要透過連接埠進行通訊，您可以將應用程式新增至防火牆例外清單。

注意

若要使用 "windows.firewallRules" 延伸模組類別 (請參閱下方)，則您的套件需要完全信任權限層級限制功能。請參閱受限功能清單。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

此延伸模組的元素和屬性

<Extension Category="windows.firewallRules">
  <FirewallRules Executable="[executable file name]">
    <Rule
      Direction="[Direction]"
      IPProtocol="[Protocol]"
      LocalPortMin="[LocalPortMin]"
      LocalPortMax="LocalPortMax"
      RemotePortMin="RemotePortMin"
      RemotePortMax="RemotePortMax"
      Profile="[Profile]"/>
  </FirewallRules>
</Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.firewallRules`
可執行檔	您想要新增到防火牆例外清單的可執行檔名稱
方向	指定規則為輸入或輸出規則
IPProtocol	通訊協定
LocalPortMin	本機連接埠號碼範圍中較低的連接埠號碼。
LocalPortMax	本機連接埠號碼範圍中最高的連接埠號碼。
RemotePortMax	遠端連接埠號碼範圍中較低的連接埠號碼。
RemotePortMax	遠端連接埠數字範圍中最高的連接埠號碼。
設定檔	網路類型

範例

<Package
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="desktop2">
  <Extensions>
    <desktop2:Extension Category="windows.firewallRules">
      <desktop2:FirewallRules Executable="Contoso.exe">
          <desktop2:Rule Direction="in" IPProtocol="TCP" Profile="all"/>
          <desktop2:Rule Direction="in" IPProtocol="UDP" LocalPortMin="1337" LocalPortMax="1338" Profile="domain"/>
          <desktop2:Rule Direction="in" IPProtocol="UDP" LocalPortMin="1337" LocalPortMax="1338" Profile="public"/>
          <desktop2:Rule Direction="out" IPProtocol="UDP" LocalPortMin="1339" LocalPortMax="1340" RemotePortMin="15"
                         RemotePortMax="19" Profile="domainAndPrivate"/>
          <desktop2:Rule Direction="out" IPProtocol="GRE" Profile="private"/>
      </desktop2:FirewallRules>
  </desktop2:Extension>
</Extensions>
</Package>

將 DLL 檔案放置在套件的任何資料夾

使用 uap6:LoaderSearchPathOverride 擴充功能，在應用程式套件中宣告最多五個資料夾路徑 (相對於應用程式套件根路徑)，以用於應用程式程序的載入器搜尋路徑。

如果套件具有執行權限，Windows 應用程式的 DLL 搜尋順序會在套件相依性圖形中包含套件。根據預設，這會包含主要、選擇性和架構套件，不過，封裝資訊清單中的 uap6:AllowExecution 元素可以覆寫此設定。

依預設，包含在 DLL 搜尋順序中的套件會包含其「有效路徑」。如需有效路徑的詳細資訊，請參閱 EffectivePath 屬性 (WinRT) 和 PackagePathType 列舉 (Win32)。

如果套件指定 uap6:LoaderSearchPathOverride，則會使用這項資訊，而不是套件的有效路徑。

每個套件只能包含一個 uap6:LoaderSearchPathOverride 擴充功能。這表示您可以將其中一個延伸模組新增至主要套件，然後在選用套件及相關集合中，新增一個。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10/6

此延伸模組的元素和屬性

在應用程式資訊清單的套件層級宣告此延伸模組。

<Extension Category="windows.loaderSearchPathOverride">
  <LoaderSearchPathOverride>
    <LoaderSearchPathEntry FolderPath="[path]"/>
  </LoaderSearchPathOverride>
</Extension>

名稱描述

類別一律為 windows.loaderSearchPathOverride。

FolderPath 包含 DLL 檔案的資料夾路徑。指定相對於套件根資料夾的路徑。您可以在一個延伸模組中指定最多五個路徑。如果您想要系統在套件根資料夾中搜尋檔案，請使用空字串代表其中一個路徑。不能包含重複路徑，並請確定路徑不包含前置和結尾斜線或反斜線。

系統不會搜尋子資料夾，因此請務必明確列出每個資料夾，其中包含要系統載入的 DLL 檔案。

名稱	描述
類別	一律為 `windows.loaderSearchPathOverride`。
FolderPath	包含 DLL 檔案的資料夾路徑。指定相對於套件根資料夾的路徑。您可以在一個延伸模組中指定最多五個路徑。如果您想要系統在套件根資料夾中搜尋檔案，請使用空字串代表其中一個路徑。不能包含重複路徑，並請確定路徑不包含前置和結尾斜線或反斜線。系統不會搜尋子資料夾，因此請務必明確列出每個資料夾，其中包含要系統載入的 DLL 檔案。

範例

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/6"
  IgnorableNamespaces="uap6">
  ...
    <Extensions>
      <uap6:Extension Category="windows.loaderSearchPathOverride">
        <uap6:LoaderSearchPathOverride>
          <uap6:LoaderSearchPathEntry FolderPath=""/>
          <uap6:LoaderSearchPathEntry FolderPath="folder1/subfolder1"/>
          <uap6:LoaderSearchPathEntry FolderPath="folder2/subfolder2"/>
        </uap6:LoaderSearchPathOverride>
      </uap6:Extension>
    </Extensions>
...
</Package>

與檔案總管整合

協助使用者組織您的檔案，並以熟悉的方式與他們互動。

定義使用者同時選取和開啟多個檔案時，您的應用程式將會如何反應
在檔案總管中以縮圖影像顯示檔案內容
在檔案總管的預覽窗格中顯示檔案內容
讓使用者在檔案總管中使用種類欄位群組檔案
讓檔案屬性可供搜尋、索引、屬性對話方塊，以及詳細資料窗格使用
為檔案類型指定操作功能表處理常式
讓雲端服務中的檔案出現在檔案總管

定義使用者同時選取和開啟多個檔案時，您的應用程式將會如何反應

指定當使用者同時開啟多個檔案時，您的應用程式將會如何反應。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/2
http://schemas.microsoft.com/appx/manifest/uap/windows10/3

此延伸模組的元素和屬性

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]" MultiSelectModel="[SelectionModel]">
        <SupportedVerbs>
            <Verb Id="Edit" MultiSelectModel="[SelectionModel]">Edit</Verb>
        </SupportedVerbs>
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
</Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.fileTypeAssociation`。
名稱	檔案類型關聯的名稱。您可以使用此名稱來組織檔案類型，並將其分組。名稱必須全部是小寫，而且沒有任何空格。
MultiSelectModel	請參閱下文
FileType	相關副檔名。

MultiSelectModel

已封裝的傳統型應用程式具有與一般傳統型應用程式相同的三個選項。

Player：您的應用程式會啟動一次。所有選取的檔案都會做為引數參數傳遞至您的應用程式。
Single：您的應用程式會針對第一個選取的檔案啟動一次。系統會忽略其他的檔案。
Document：針對每個所選檔案，個別啟動應用程式的新執行個體。

您可針對不同的檔案類型和動作，設定不同的喜好設定。例如，您可以會想要在 Document 模式中開啟文件，以及在 Player 模式中開啟影像。

範例

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap2, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes" MultiSelectModel="Document">
            <uap2:SupportedVerbs>
              <uap3:Verb Id="Edit" MultiSelectModel="Player">Edit</uap3:Verb>
              <uap3:Verb Id="Preview" MultiSelectModel="Document">Preview</uap3:Verb>
            </uap2:SupportedVerbs>
            <uap:SupportedFileTypes>
              <uap:FileType>.txt</uap:FileType>
            </uap:SupportedFileTypes>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

如果使用者開啟 15 個或較少數量的檔案，MultiSelectModel 屬性的預設選項將會設定為 Player。否則，預設值為 Document。 UWP 應用程式一律以 Player 啟動。

在檔案總管中以縮圖影像顯示檔案內容

讓使用者在檔案圖示以中圖示、大圖示，或超大圖示顯示時，可透過縮圖影像檢視檔案內容。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/2
http://schemas.microsoft.com/appx/manifest/uap/windows10/3
http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

此延伸模組的元素和屬性

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <ThumbnailHandler
            Clsid  ="[Clsid  ]" />
    </FileTypeAssociation>
</Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.fileTypeAssociation`。
名稱	檔案類型關聯的名稱。您可以使用此名稱來組織檔案類型，並將其分組。名稱必須全部是小寫，而且沒有任何空格。
FileType	相關副檔名。
Clsid	應用程式的類別識別碼。

範例

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap2, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
            </uap:SupportedFileTypes>
            <desktop2:ThumbnailHandler
              Clsid  ="20000000-0000-0000-0000-000000000001"  />
            </uap3:FileTypeAssociation>
         </uap::Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

在檔案總管的預覽窗格中顯示檔案內容

讓使用者可在檔案總管中的預覽窗格預覽檔案內容。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/2
http://schemas.microsoft.com/appx/manifest/uap/windows10/3
http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

此延伸模組的元素和屬性

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <DesktopPreviewHandler Clsid  ="[Clsid  ]" />
    </FileTypeAssociation>
</Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.fileTypeAssociation`。
名稱	檔案類型關聯的名稱。您可以使用此名稱來組織檔案類型，並將其分組。名稱必須全部是小寫，而且沒有任何空格。
FileType	相關副檔名。
Clsid	應用程式的類別識別碼。

範例

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap2, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
                </uap:SupportedFileTypes>
              <desktop2:DesktopPreviewHandler Clsid ="20000000-0000-0000-0000-000000000001" />
           </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

讓使用者在檔案總管中使用種類欄位群組檔案

您可以透過 [種類] 欄位，將您的檔案類型與一或多個預先定義的值建立關聯。

在檔案總管中，使用者可以使用該欄位分組這些檔案。系統元件也會根據不同用途使用此欄位，例如：編製索引。

如需 [種類] 欄位以及可用於此欄位中的值的詳細資訊，請參閱使用種類名稱。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

此延伸模組的元素和屬性

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <KindMap>
            <Kind value="[KindValue]">
        </KindMap>
    </FileTypeAssociation>
</Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.fileTypeAssociation`。
名稱	檔案類型關聯的名稱。您可以使用此名稱來組織檔案類型，並將其分組。名稱必須全部是小寫，而且沒有任何空格。
FileType	相關副檔名。
value	有效的種類值

範例

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="uap, rescap">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
           <uap:FileTypeAssociation Name="mediafiles">
             <uap:SupportedFileTypes>
               <uap:FileType>.m4a</uap:FileType>
               <uap:FileType>.mta</uap:FileType>
             </uap:SupportedFileTypes>
             <rescap:KindMap>
               <rescap:Kind value="Item">
               <rescap:Kind value="Communications">
               <rescap:Kind value="Task">
             </rescap:KindMap>
          </uap:FileTypeAssociation>
      </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

讓檔案屬性可供搜尋、索引、屬性對話方塊，以及詳細資料窗格使用

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/3
http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

此延伸模組的元素和屬性

<uap:Extension Category="windows.fileTypeAssociation">
    <uap:FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>.bar</FileType>
        </SupportedFileTypes>
        <DesktopPropertyHandler Clsid ="[Clsid]"/>
    </uap:FileTypeAssociation>
</uap:Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.fileTypeAssociation`。
名稱	檔案類型關聯的名稱。您可以使用此名稱來組織檔案類型，並將其分組。名稱必須全部是小寫，而且沒有任何空格。
FileType	相關副檔名。
Clsid	應用程式的類別識別碼。

範例

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
            </uap:SupportedFileTypes>
            <desktop2:DesktopPropertyHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

如果您的傳統型應用程式定義操作功能表處理常式，請使用此延伸模組來登錄功能表處理常式。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/foundation/windows10
http://schemas.microsoft.com/appx/manifest/desktop/windows10/4

此延伸模組的元素和屬性

<Extensions>
    <com:Extension Category="windows.comServer">
        <com:ComServer>
            <com:SurrogateServer AppId="[AppID]" DisplayName="[DisplayName]">
                <com:Class Id="[Clsid]" Path="[Path]" ThreadingModel="[Model]"/>
            </com:SurrogateServer>
        </com:ComServer>
    </com:Extension>
    <desktop4:Extension Category="windows.fileExplorerContextMenus">
        <desktop4:FileExplorerContextMenus>
            <desktop4:ItemType Type="[Type]">
                <desktop4:Verb Id="[ID]" Clsid="[Clsid]" />
            </desktop4:ItemType>
        </desktop4:FileExplorerContextMenus>
    </desktop4:Extension>
</Extensions>

您可以在這裡找到完整的結構描述參考：com:ComServer 和 desktop4:FileExplorerContextMenus。

指示

若要登錄您的操作功能表處理常式，請遵循下列指示。

在您的傳統型應用程式中，藉由實作 IExplorerCommand 或 IExplorerCommandState 介面，來實作內容功能表處理常式。如需範例，請參閱 ExplorerCommandVerb 程式碼範例。確保為每個實作物件定義類別 GUID。例如，下列程式碼會定義類別識別碼以實作 IExplorerCommand。
```
class __declspec(uuid("00001111-aaaa-2222-bbbb-3333cccc4444")) CExplorerCommandVerb;
```

在您的封裝資訊清單中，指定 com:ComServer 應用程式延伸模組，該延伸模組使用操作功能表處理常式實作的類別識別碼，登錄 COM 代理伺服器。

<com:Extension Category="windows.comServer">
    <com:ComServer>
        <com:SurrogateServer AppId="00001111-aaaa-2222-bbbb-3333cccc4444" DisplayName="ContosoHandler">
            <com:Class Id="00001111-aaaa-2222-bbbb-3333cccc4444" Path="ExplorerCommandVerb.dll" ThreadingModel="STA"/>
        </com:SurrogateServer>
    </com:ComServer>
</com:Extension>

在您的封裝資訊清單中，指定 desktop4:FileExplorerContextMenus 應用程式延伸模組，以登錄操作功能表處理常式實作。

<desktop4:Extension Category="windows.fileExplorerContextMenus">
    <desktop4:FileExplorerContextMenus>
        <desktop4:ItemType Type=".rar">
            <desktop4:Verb Id="Command1" Clsid="00001111-aaaa-2222-bbbb-3333cccc4444" />
        </desktop4:ItemType>
    </desktop4:FileExplorerContextMenus>
</desktop4:Extension>

範例

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
  xmlns:desktop4="http://schemas.microsoft.com/appx/manifest/desktop/windows10/4"
  xmlns:com="http://schemas.microsoft.com/appx/manifest/com/windows10"
  IgnorableNamespaces="desktop4">
  <Applications>
    <Application>
      <Extensions>
        <com:Extension Category="windows.comServer">
          <com:ComServer>
            <com:SurrogateServer AppId="00001111-aaaa-2222-bbbb-3333cccc4444" DisplayName="ContosoHandler">
              <com:Class Id="00001111-aaaa-2222-bbbb-3333cccc4444" Path="ExplorerCommandVerb.dll" ThreadingModel="STA"/>
            </com:SurrogateServer>
          </com:ComServer>
        </com:Extension>
        <desktop4:Extension Category="windows.fileExplorerContextMenus">
          <desktop4:FileExplorerContextMenus>
            <desktop4:ItemType Type=".contoso">
              <desktop4:Verb Id="Command1" Clsid="00001111-aaaa-2222-bbbb-3333cccc4444" />
            </desktop4:ItemType>
          </desktop4:FileExplorerContextMenus>
        </desktop4:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

讓雲端服務中的檔案出現在檔案總管

登錄在您應用程式中實作的處理常式。您也可以新增操作功能表選項，使用者在 [檔案總管] 中的雲端式檔案上按一下滑鼠右鍵時會出現這些選項。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/desktop/windows10

此延伸模組的元素和屬性

<Extension Category="windows.cloudfiles" >
    <CloudFiles IconResource="[Icon]">
        <CustomStateHandler Clsid ="[Clsid]"/>
        <ThumbnailProviderHandler Clsid ="[Clsid]"/>
        <ExtendedPropertyhandler Clsid ="[Clsid]"/>
        <CloudFilesContextMenus>
            <Verb Id ="Command3" Clsid= "[GUID]">[Verb Label]</Verb>
        </CloudFilesContextMenus>
    </CloudFiles>
</Extension>

名稱	描述
類別	一律為 `windows.cloudfiles`。
iconResource	此圖示表示您的雲端檔案提供者服務。在 [檔案總管] 瀏覽窗格中會顯示此圖示。使用者選擇此圖示，以顯示雲端服務中的檔案。
CustomStateHandler Clsid	實作 CustomStateHandler 的應用程式類別識別碼。系統會使用這個類別識別碼要求雲端檔案的自訂狀態和欄。
ThumbnailProviderHandler Clsid	實作 ThumbnailProviderHandler 的應用程式類別識別碼。系統會使用這個類別識別碼要求雲端檔案的縮圖影像。
ExtendedPropertyHandler Clsid	實作 ExtendedPropertyHandler 的應用程式類別識別碼。系統會使用這個類別識別碼要求雲端檔案的擴充屬性。
動詞命令	為您的雲端服務所提供的檔案，顯示在 [檔案總管] 操作功能表中的名稱。
Id	動詞的唯一識別碼。

範例

<Package
    xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
    IgnorableNamespaces="desktop">
  <Applications>
    <Application>
      <Extensions>
        <Extension Category="windows.cloudfiles" >
            <CloudFiles IconResource="images\Wide310x150Logo.png">
                <CustomStateHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <ThumbnailProviderHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <ExtendedPropertyhandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <desktop:CloudFilesContextMenus>
                    <desktop:Verb Id ="keep" Clsid=
                       "20000000-0000-0000-0000-000000000001">
                       Always keep on this device</desktop:Verb>
                </desktop:CloudFilesContextMenus>
            </CloudFiles>
          </Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

以不同的方式啟動您的應用程式

使用通訊協定啟動您的應用程式
使用別名啟動您的應用程式
在使用者登入 Windows 時啟動可執行檔
讓使用者在將裝置連接到電腦時，啟動您的應用程式
從 Microsoft Store 接收更新後自動重新開機

使用通訊協定啟動您的應用程式

通訊協定關聯支援已封裝應用程式與其他程式或系統元件間的相互操作。若您使用通訊協定啟動已封裝的應用程式，則可指定特定參數傳送至該應用程式的啟用事件引數，讓其據以運作。參數僅支援已封裝、完全信任的應用程式。 UWP 應用程式無法使用參數。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10/3

此延伸模組的元素和屬性

<Extension
    Category="windows.protocol">
  <Protocol
      Name="[Protocol name]"
      Parameters="[Parameters]" />
</Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.protocol`。
名稱	通訊協定的名稱。
參數	應用程式啟動時，做為事件引數傳遞至應用程式的參數與數值清單。如果變數包含檔案路徑，請使用引號括住參數。這樣可避免路徑中包含空格時發生任何問題。

範例

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
  IgnorableNamespaces="uap3, desktop">
  <Applications>
    <Application>
      <Extensions>
        <uap3:Extension
          Category="windows.protocol">
          <uap3:Protocol
            Name="myapp-cmd"
            Parameters="/p &quot;%1&quot;" />
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

使用別名啟動您的應用程式

使用者和其他處理程序可以使用別名啟動您的應用程式，而不必指定您應用程式的完整路徑。您可以指定別名名稱。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10/3
http://schemas.microsoft.com/appx/manifest/desktop/windows10

此延伸模組的元素和屬性

<uap3:Extension
    Category="windows.appExecutionAlias"
    Executable="[ExecutableName]"
    EntryPoint="Windows.FullTrustApplication">
    <uap3:AppExecutionAlias>
        <desktop:ExecutionAlias Alias="[AliasName]" />
    </uap3:AppExecutionAlias>
</uap3:Extension>

名稱	描述
類別	一律為 `windows.appExecutionAlias`。
可執行檔	叫用別名時，要啟動的可執行檔相對路徑。
Alias	適用於您應用程式的簡短名稱。其必須一律以副檔名「.exe」結尾。針對套件中的每個應用程式，您僅可指定單一應用程式執行別名。若有多個應用程式註冊相同的別名，系統將會叫用最後一個註冊的別名，因此請務必選擇絕對不會遭其他應用程式覆寫的唯一別名。

範例

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap3">
  <Applications>
    <Application>
      <Extensions>
         <uap3:Extension
                Category="windows.appExecutionAlias"
                Executable="exes\launcher.exe"
                EntryPoint="Windows.FullTrustApplication">
            <uap3:AppExecutionAlias>
                <desktop:ExecutionAlias Alias="Contoso.exe" />
            </uap3:AppExecutionAlias>
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

您可以在這裡找到完整的結構描述參考。

在使用者登入 Windows 時啟動可執行檔

啟動工作能讓您的應用程式在每次使用者登入時，自動執行可執行檔。

注意

使用者必須至少啟動您的應用程式一次，才能使您的應用程式登錄啟動工作。

您的應用程式可以宣告多個啟動工作。每個工作都是獨立啟動的。所有啟動工作皆會顯示在「工作管理員」中的 [啟動] 索引標籤下方，且具有您在應用程式的資訊清單中指定的名稱，以及應用程式的圖示。 [工作管理員] 會自動分析您工作的啟動影響。

使用者可以使用工作管理員手動停用您應用程式的啟動工作。如果使用者停用工作，您將無法以程式設計的方式重新啟用它。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/desktop/windows10

此延伸模組的元素和屬性

<Extension
    Category="windows.startupTask"
    Executable="[ExecutableName]"
    EntryPoint="Windows.FullTrustApplication">
  <StartupTask
      TaskId="[TaskID]"
      Enabled="true"
      DisplayName="[DisplayName]" />
</Extension>

名稱	描述
類別	一律為 `windows.startupTask`。
可執行檔	要啟動的可執行檔相對路徑。
TaskId	您工作的唯一識別碼。應用程式可使用此識別碼呼叫 Windows.ApplicationModel.StartupTask 類別中的 API，運用程式設計方式，啟用或停用啟動工作。
已啟用	指出工作是先啟動啟用或停用。下次使用者登入時，將會執行已啟用的工作 (除非使用者將其停用)。
DisplayName	出現在工作管理員中的工作名稱。您可以使用 `ms-resource`，將字串當地語系化。

範例

<Package
  xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
  IgnorableNamespaces="desktop">
  <Applications>
    <Application>
      <Extensions>
        <desktop:Extension
          Category="windows.startupTask"
          Executable="bin\MyStartupTask.exe"
          EntryPoint="Windows.FullTrustApplication">
        <desktop:StartupTask
          TaskId="MyStartupTask"
          Enabled="true"
          DisplayName="My App Service" />
        </desktop:Extension>
      </Extensions>
    </Application>
  </Applications>
 </Package>

讓使用者在將裝置連接到電腦時，啟動您的應用程式

當使用者將裝置連接至電腦時，「自動播放」會將您的應用程式顯示為選項。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/desktop/windows10/3

此延伸模組的元素和屬性

<Extension Category="windows.autoPlayHandler">
  <AutoPlayHandler>
    <InvokeAction ActionDisplayName="[action string]" ProviderDisplayName="[name of your app/service]">
      <Content ContentEvent="[Content event]" Verb="[any string]" DropTargetHandler="[Clsid]" />
      <Content ContentEvent="[Content event]" Verb="[any string]" Parameters="[Initialization parameter]"/>
      <Device DeviceEvent="[Device event]" HWEventHandler="[Clsid]" InitCmdLine="[Initialization parameter]"/>
    </InvokeAction>
  </AutoPlayHandler>

名稱	描述
類別	一律為 `windows.autoPlayHandler`。
ActionDisplayName	此字串表示使用者可以在連接到電腦的裝置上執行的動作 (例如：「匯入檔案」或「播放影片」)。
ProviderDisplayName	此字串表示您的應用程式或服務 (例如：「Contoso 影片播放程式」)。
ContentEvent	內容事件的名稱，該事件導致向使用者提示您的 `ActionDisplayName` 與 `ProviderDisplayName`。將磁碟區裝置 (例如，相機記憶卡、隨身碟或 DVD) 插入電腦時，就會引發內容事件。您可以在這裡找到那些事件的完整清單。
動詞命令	[動詞] 設定會識別針對選取的選項而傳遞至應用程式的值。您可以為自動播放事件指定多個啟動動作，並使用 [動詞] 設定判斷使用者為應用程式選取的選項。您可以檢查傳遞至應用程式啟動事件引數的 Verb 屬性，以判斷使用者選取的選項。您可以為 [動詞] 設定使用保留字 open 以外的任何值。
DropTargetHandler	實作 IDropTarget 介面的應用程式類別識別碼。抽取式媒體中的檔案將會傳遞至 IDropTarget 實作的 Drop 方法。
參數	您不需要為所有內容事件實作 IDropTarget 介面。對於任何內容事件，您可以提供命令列參數，而不實作 IDropTarget 介面。對於這些事件，自動播放會使用這些命令列參數啟動您的應用程式。您可以在應用程式的初始化程式碼中剖析這些參數，以判斷自動播放是否啟動應用程式，然後提供您的自訂實作。
DeviceEvent	裝置事件的名稱，該事件導致向使用者提示您的`ActionDisplayName`與`ProviderDisplayName`。將裝置連接到電腦時，就會引發裝置事件。裝置事件以字串 `WPD` 開頭，這裡列出這些裝置事件。
HWEventHandler	實作 IHWEventHandler 介面的應用程式類別識別碼。
InitCmdLine	您想要傳遞至 IHWEventHandler 介面的 Initialize 方法的字串參數。

範例

<Package
  xmlns:desktop3="http://schemas.microsoft.com/appx/manifest/desktop/windows10/3"
  IgnorableNamespaces="desktop3">
  <Applications>
    <Application>
      <Extensions>
        <desktop3:Extension Category="windows.autoPlayHandler">
          <desktop3:AutoPlayHandler>
            <desktop3:InvokeAction ActionDisplayName="Import my files" ProviderDisplayName="ms-resource:AutoPlayDisplayName">
              <desktop3:Content ContentEvent="ShowPicturesOnArrival" Verb="show" DropTargetHandler="CD041BAE-0DEA-4472-9B7B-C98043D26EA8"/>
              <desktop3:Content ContentEvent="PlayVideoFilesOnArrival" Verb="play" Parameters="%1" />
              <desktop3:Device DeviceEvent="WPD\ImageSource" HWEventHandler="CD041BAE-0DEA-4472-9B7B-C98043D26EA8" InitCmdLine="/autoplay"/>
            </desktop3:InvokeAction>
          </desktop3:AutoPlayHandler>
      </Extensions>
    </Application>
  </Applications>
</Package>

從 Microsoft Store 接收更新後自動重新開機

如果您的應用程式在使用者安裝更新時已開啟，則會關閉應用程式。

如果您希望完成更新後該應用程式重新啟動，請在每個您想要重新啟動的處理程序中呼叫 RegisterApplicationRestart 函式。

應用程式中的每個使用中視窗都會收到 WM_QUERYENDSESSION 訊息。此時，如有需要，您的應用程式可以再次呼叫 RegisterApplicationRestart 函式，以更新命令列。

當應用程式中的每個使用中視窗收到 WM_ENDSESSION 訊息時，您的應用程式應該會儲存資料並關閉。

注意

使用中視窗也會收到 WM_CLOSE 訊息，以防應用程式未處理 WM_ENDSESSION 訊息。

此時，您的應用程式有 30 秒的時間可以關閉本身的處理程序，否則平台會強制終止。

更新完成後，您的應用程式會重新啟動。

使用其他應用程式

與其他應用程式整合，啟動其他處理程序，或共用資訊。

在支援列印的應用程式中，將您的應用程式作為列印目標顯示
與其他 Windows 應用程式共用字型
從通用 Windows 平台 (UWP) 應用程式中啟動 Win32 處理程序

在支援列印的應用程式中，將您的應用程式作為列印目標顯示

當使用者想要從其他應用程式 (例如，記事本) 列印資料時，您可以讓您的應用程式做為列印目標，顯示在該應用程式的可用列印目標清單中。

您必須修改您的應用程式，使其能接收以 XML 文件規格 (XPS) 格式儲存的列印資料。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

此延伸模組的元素和屬性

<Extension Category="windows.appPrinter">
    <AppPrinter
        DisplayName="[DisplayName]"
        Parameters="[Parameters]" />
</Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.appPrinter`。
DisplayName	您想要在應用程式的列印目標清單中顯示的名稱。
參數	應用程式正確處理要求所需的任何參數。

範例

<Package
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="desktop2">
  <Applications>
  <Application>
    <Extensions>
      <desktop2:Extension Category="windows.appPrinter">
        <desktop2:AppPrinter
          DisplayName="Send to Contoso"
          Parameters="/insertdoc %1" />
      </desktop2:Extension>
    </Extensions>
  </Application>
</Applications>
</Package>

您可以在這裡找到使用此延伸模組的範例。

與其他 Windows 應用程式共用您的自訂字型。

注意

您必須先取得 Microsoft Store 小組的核准，才能向 Store 提交使用此延伸模組的應用程式。若要取得核准，請移至https://aka.ms/storesupport，按一下 [與我們連絡]，然後選擇將應用程式提交到儀表板的相關選項。此核准程序有助於確保應用程式安裝的字型與作業系統所安裝的字型之間沒有衝突。如果未取得核准，則在提交應用程式時，將會收到類似下列的錯誤：「套件接受度驗證錯誤：此帳戶無法與延伸模組 windows.sharedFonts 搭配使用。如果要取得此延伸模組的使用權限，請連絡支援團隊。」

XML 命名空間

http://schemas.microsoft.com/appx/manifest/uap/windows10/4

此延伸模組的元素和屬性

<Extension Category="windows.sharedFonts">
    <SharedFonts>
      <Font File="[FontFile]" />
    </SharedFonts>
  </Extension>

您可以在這裡找到完整的結構描述參考。

名稱	描述
類別	一律為 `windows.sharedFonts`。
檔案	此檔案包含您想要共用的字型。

範例

<Package
  xmlns:uap4="http://schemas.microsoft.com/appx/manifest/uap/windows10/4"
  IgnorableNamespaces="uap4">
  <Applications>
    <Application>
      <Extensions>
        <uap4:Extension Category="windows.sharedFonts">
          <uap4:SharedFonts>
            <uap4:Font File="Fonts\JustRealize.ttf" />
            <uap4:Font File="Fonts\JustRealizeBold.ttf" />
          </uap4:SharedFonts>
        </uap4:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

從通用 Windows 平台 (UWP) 應用程式中啟動 Win32 處理程序

啟動完全信任的 Win32 處理程序。

XML 命名空間

http://schemas.microsoft.com/appx/manifest/desktop/windows10

此延伸模組的元素和屬性

<Extension Category="windows.fullTrustProcess" Executable="[executable file]">
  <FullTrustProcess>
    <ParameterGroup GroupId="[GroupID]" Parameters="[Parameters]"/>
  </FullTrustProcess>
</Extension>

名稱	描述
類別	一律為 `windows.fullTrustProcess`。
GroupID	此字串可識別您要傳遞給可執行檔的一組參數。
參數	您想要傳遞給可執行檔的參數。

範例

<Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
         xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
         xmlns:rescap=
"http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
         xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10">
  ...
  <Capabilities>
      <rescap:Capability Name="runFullTrust"/>
  </Capabilities>
  <Applications>
    <Application>
      <Extensions>
          <desktop:Extension Category="windows.fullTrustProcess" Executable="fulltrustprocess.exe">
              <desktop:FullTrustProcess>
                  <desktop:ParameterGroup GroupId="SyncGroup" Parameters="/Sync"/>
                  <desktop:ParameterGroup GroupId="OtherGroup" Parameters="/Other"/>
              </desktop:FullTrustProcess>
           </desktop:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

如果要建立在所有裝置上執行的通用 Windows 平台使用者介面，但希望 Win32 應用程式的元件能繼續在完全信任的情況下執行，此延伸模組非常有用。

您只需要為 Win32 應用程式建立 Windows 應用程式套件。然後，將此延伸模組新增至 UWP 應用程式的套件檔案。此延伸模組表示您想要在 Windows 應用程式套件中啟動可執行檔。如果您想要在 UWP 應用程式和 Win32 應用程式之間進行通訊，可以設定一或多個應用程式服務。您可以在這裡閱讀更多關於此案例的資訊。

下一步

有任何疑問嗎？請在 Stack Overflow 上發問。我們的團隊會監視這些標籤。您也可以在這裡發問。

共用方式為

使用套件延伸模組將傳統型應用程式與 Windows 整合

將使用者轉換至您的應用程式

將現有的傳統型應用程式重新導向至已封裝的應用程式

新增登錄項目以重新導向至未封裝的傳統型應用程式可執行檔

註冊要啟動的已封裝應用程式

停用重新導向

XML 命名空間

此延伸模組的元素和屬性

將現有的開始畫面磚和工作列按鈕指向您已封裝的應用程式

XML 命名空間

此延伸模組的元素和屬性

範例

相關範例

使用您已封裝的應用程式開啟檔案，而非使用您的傳統型應用程式

XML 命名空間

此延伸模組的元素和屬性

範例

相關範例

將已封裝的應用程式和一組檔案類型建立關聯

XML 命名空間

此延伸模組的元素和屬性

範例

相關範例

將選項新增至具有特定檔案類型的檔案操作功能表

XML 命名空間

此延伸模組的元素和屬性

範例

相關範例

使用 URL 直接開啟特定類型的檔案

XML 命名空間

此延伸模組的元素和屬性

範例

執行設定工作

為您的應用程式建立防火牆例外

XML 命名空間

此延伸模組的元素和屬性

範例

將 DLL 檔案放置在套件的任何資料夾

XML 命名空間

此延伸模組的元素和屬性

範例

與檔案總管整合

定義使用者同時選取和開啟多個檔案時，您的應用程式將會如何反應

XML 命名空間

此延伸模組的元素和屬性

範例

在檔案總管中以縮圖影像顯示檔案內容

XML 命名空間

此延伸模組的元素和屬性

範例

在檔案總管的預覽窗格中顯示檔案內容

XML 命名空間

此延伸模組的元素和屬性

範例

讓使用者在檔案總管中使用種類欄位群組檔案

XML 命名空間

此延伸模組的元素和屬性

範例

讓檔案屬性可供搜尋、索引、屬性對話方塊，以及詳細資料窗格使用

XML 命名空間

此延伸模組的元素和屬性

範例

為檔案類型指定操作功能表處理常式

XML 命名空間

此延伸模組的元素和屬性

指示

範例

讓雲端服務中的檔案出現在檔案總管

XML 命名空間

此延伸模組的元素和屬性

範例

以不同的方式啟動您的應用程式

使用通訊協定啟動您的應用程式

XML 命名空間

此延伸模組的元素和屬性

範例

使用別名啟動您的應用程式

XML 命名空間

此延伸模組的元素和屬性