Bagikan melalui

desktop8:Extension (dalam Paket/Ekstensi)

  • Artikel

Mendeklarasikan titik ekstensibilitas untuk aplikasi.

Hierarki Elemen

<Paket>

    <Ekstensi>

         <desktop8:Extension>

Sintaks

<desktop8:Extension
  Category = 'A string that can be one of the following values: "windows.mutablePackageDirectories", "windows.userMutablePackageDirectories", or "windows.eventTracing".'
  Executable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value between 1 and 256 characters in length, representing the  task handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type. If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
  RuntimeType = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' 
  uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
  uap11:SupportsMultipleInstances = 'An optional boolean value.'
  uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
  uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".' >

  <!-- Child Elements -->
  desktop8:MutablePackageDirectories
  desktop8:UserMutablePackageDirectories
  desktop8:EventTracing

</desktop8:Extension>

Atribut dan elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
Kategori Kategori ekstensi. String yang dapat memiliki salah satu nilai berikut: windows.mutablePackageDirectories, windows.userMutablePackageDirectories, atau windows.eventTracing. Ya
Eksekusi Peluncuran default yang dapat dieksekusi. String opsional dengan nilai antara 1 dan 256 karakter yang harus diakhir dengan .exe dan tidak boleh berisi karakter ini: <, , >, :", |, ?, atau *. Ini menentukan executable default untuk ekstensi. Jika tidak ditentukan, executable yang ditentukan untuk aplikasi akan digunakan. Jika ditentukan, properti EntryPoint juga digunakan. Jika properti EntryPoint tersebut tidak ditentukan, EntryPoint yang ditentukan untuk aplikasi akan digunakan. Tidak
EntryPoint ID kelas yang dapat diaktifkan. String opsional dengan nilai antara 1 dan 256 karakter, mewakili tugas yang menangani ekstensi. Ini biasanya nama yang sepenuhnya memenuhi syarat namespace layanan dari jenis Windows Runtime. Jika EntryPoint tidak ditentukan, EntryPoint yang ditentukan untuk aplikasi akan digunakan sebagai gantinya. Tidak
RuntimeType Penyedia runtime. Atribut ini digunakan biasanya ketika ada kerangka kerja campuran dalam aplikasi. String opsional dengan nilai antara 1 dan 255 karakter yang tidak dapat dimulai atau diakhir dengan titik atau berisi karakter ini: <, , :">, /, , \, |, , ?, atau .* Tidak
StartPage Halaman web yang menangani titik ekstensibilitas. String opsional dengan nilai antara 1 dan 256 karakter yang tidak boleh berisi karakter ini: <, , >, :", |, ?, atau *. Tidak
uap10:TrustLevel Menentukan tingkat kepercayaan ekstensi. String opsional yang dapat memiliki salah satu nilai berikut: appContainer atau mediumIL. Tidak
uap10:RuntimeBehavior Menentukan perilaku run time ekstensi. String opsional yang dapat memiliki salah satu nilai berikut: windowsApp, packagedClassicApp, atau win32App. Tidak
uap10:HostId Menentukan ID runtime host untuk ekstensi. String alfanumerik dengan panjang nilai antara 1 dan 255 karakter. Harus dimulai dengan surat. Tidak
uap10:Parameters Berisi parameter baris perintah untuk diteruskan ke ekstensi. Hanya didukung untuk aplikasi desktop yang memiliki identitas paket. String opsional dengan nilai antara 1 dan 32767 karakter dengan karakter non-spasi di awal dan akhir. Tidak
uap11:Id Pengidentifikasi untuk ekstensi. ID harus unik untuk semua ekstensi dalam paket. String opsional dengan nilai antara 1 dan 255 karakter dengan karakter non-spasi di awal dan akhir. Tidak
uap11:Subsistem Atribut ini diwarisi dari sintaks ekstensi dasar dan tidak berlaku untuk ekstensi com4. Selain validasi sintaksis, nilai ini diabaikan. String opsional yang dapat memiliki salah satu nilai berikut: konsol atau jendela. Tidak
uap11:SupportsMultipleInstances Menentukan apakah instans harus berjalan dalam proses yang berbeda. Nilai defaultnya adalah false. Nilai boolean opsional. Tidak
uap11:ResourceGroup Tag yang dapat Anda gunakan untuk mengelompokkan aktivasi ekstensi bersama-sama untuk tujuan manajemen sumber daya (misalnya, CPU dan memori). Nilai yang dapat Anda atur ResourceGroup adalah bentuk bebas dan fleksibel. Lihat Application@ResourceGroup. String alfanumerik opsional dengan panjang nilai antara 1 dan 255 karakter. Harus dimulai dengan surat. Tidak
uap11:CurrentDirectoryPath Menentukan direktori awal saat proses aplikasi diluncurkan. Atribut ini mendukung makro. Untuk informasi selengkapnya, lihat Makro dalam skema manifes paket. String opsional yang tidak boleh berisi karakter ini: <, , >|, ?, atau *. > Tidak
uap11:Parameters Atribut ini diwarisi dari sintaks ekstensi dasar dan tidak berlaku untuk ekstensi com4. Selain validasi sintaksis, nilai ini diabaikan. Atribut ini mendukung makro. Untuk informasi selengkapnya, lihat Makro dalam skema manifes paket. String opsional dengan nilai antara 1 dan 32767 karakter dengan karakter non-spasi di awal dan akhir. Tidak
desktop7:CompatMode Menentukan apakah informasi ekstensi ini terdaftar dengan Windows dengan cara klasik (misalnya, aplikasi yang tidak dikemas mendaftarkan jenis dengan COM melalui registri) atau dengan cara baru yang lebih tercakup. Nilai defaultnya adalah "modern". CompatMode="classic" memerlukan kemampuan Microsoft.classicAppCompat_8wekyb3d8bbwe . String opsional dapat memiliki salah satu nilai berikut: klasik atau modern. Tidak
desktop7:Scope Menentukan apakah pendaftaran hanya terlihat oleh aplikasi lain yang berjalan sebagai pengguna yang memiliki paket ini terdaftar (pengguna), atau apakah mereka terlihat oleh semua pengguna dan layanan pada mesin (mesin). Nilai defaultnya adalah "user". Scope="machine" memerlukan kemampuan Microsoft.classicAppCompatElevated_8wekyb3d8bbwe . String opsional yang dapat memiliki salah satu nilai berikut: mesin atau pengguna. Tidak

Elemen anak

elemen anak Deskripsi
desktop8:MutablePackageDirectories Memungkinkan aplikasi desktop Anda menentukan satu atau beberapa folder tempat Anda dapat mengubah file penginstalan untuk aplikasi Anda.
desktop8:UserMutablePackageDirectories Memungkinkan aplikasi desktop Anda menentukan satu atau beberapa folder di mana pengguna dapat memodifikasi file penginstalan untuk aplikasi Anda (misalnya, untuk menginstal mod).
desktop8:EventTracing Memungkinkan aplikasi desktop Anda untuk mencatat peristiwa yang ditentukan aplikasi untuk dikonsumsi secara real time atau disimpan ke file log.

Elemen induk

elemen induk Deskripsi
Ekstensi (dalam Paket/Aplikasi) Menentukan satu atau beberapa titik ekstensibilitas untuk aplikasi.

Persyaratan

Item Nilai
Ruang nama http://schemas.microsoft.com/appx/manifest/desktop/windows10/8
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Versi OS Minimum Windows 11 versi 21H2 (Build 22000)