Baca dalam bahasa Inggris

Bagikan melalui

Ekstensi (dalam Aplikasi/Ekstensi) (Windows 10)

  • Artikel

Menyatakan titik ekstensibilitas untuk paket.

Hierarki elemen

<Paket>

    <Aplikasi>

         <Aplikasi>

              <Ekstensi>

                   <Ekstensi>

Sintaks

<Extension
  Category = 'One of the following values: "windows.backgroundTasks", "windows.preInstalledConfigTask", "windows.updateTask", or "windows.restrictedLaunch".'
  Executable = 'A string with an optional value between 1 and 256 characters in length, that must end with ".exe", and cannot contain the following characters: <, >, :, ", |, ?, or *. 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 the EntryPoint property is not specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'A string with an optional value between 1 and 256 characters in length. Represents the task handling the extension (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 = 'A string with an optional value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'A string with an optional value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ResourceGroup = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:TrustLevel = 'An optional string value. If specified, it must be either "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior  = 'An optional string value. If specified, it must be one of the following values:  "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with an letter.'
  uap10:Parameters = 'A string with an optional value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
/>

  <!-- Child elements -->
  BackgroundTasks?

</Extension>

Kunci

? opsional (nol atau satu)

Atribut dan elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
Kategori Jenis titik ekstensibilitas paket. Dapat berupa salah satu nilai berikut: windows.backgroundTasks, windows.preInstalledConfigTask, windows.updateTask, atau windows.restrictedLaunch. Ya
EntryPoint ID kelas yang dapat diaktifkan. String dengan panjang nilai antara 1 dan 256 karakter. Mewakili tugas yang menangani ekstensi (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
Eksekusi Peluncuran default yang dapat dieksekusi. String dengan panjang nilai antara 1 dan 256 karakter, yang harus diakhir dengan .exe, dan tidak boleh berisi karakter ini: <, , >, :", |, ?, atau *. 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
RuntimeType Penyedia runtime. Biasanya digunakan saat ada kerangka kerja campuran dalam aplikasi. String dengan nilai antara 1 dan 255 karakter yang panjangnya tidak dapat dimulai atau diakhir . dengan atau berisi karakter di sana: <, , >, :", |, , ?atau *. Tidak
StartPage Halaman web yang menangani titik ekstensibilitas. String dengan nilai antara 1 dan 256 karakter yang panjangnya tidak boleh berisi karakter ini: <, , >, :", |, ?, atau *. Tidak
ResourceGroup Tag opsional yang digunakan untuk mengelompokkan aktivasi ekstensi bersama-sama untuk tujuan manajemen sumber daya (misalnya, CPU dan memori). Lihat bagian Keterangan di Application@ResourceGroup. Panjang string alfanumerik antara 1 dan 255 karakter. Harus dimulai dengan huruf. Tidak
uap10:TrustLevel Menentukan tingkat kepercayaan ekstensi. Nilai string opsional. Jika ditentukan, ini bisa menjadi salah satu nilai berikut: appContainer atau mediumIL. Tidak
uap10:RuntimeBehavior Menentukan perilaku runtime ekstensi.

Untuk informasi dan persyaratan selengkapnya, lihat uap10:RuntimeBehavior di topik untuk elemen Aplikasi (Windows 10).		 Nilai string opsional. Jika ditentukan, itu bisa menjadi salah satu nilai berikut: "packagedClassicApp", "win32App", atau "windowsApp". Tidak
uap10:HostId Menentukan ID runtime host untuk ekstensi. String alfanumerik dengan nilai opsional antara 1 dan 255 karakter. Harus dimulai dengan huruf. Tidak
uap10:Parameters Berisi parameter baris perintah untuk diteruskan ke ekstensi. Hanya didukung untuk aplikasi desktop. String dengan panjang nilai antara 1 dan 32767 karakter dengan karakter non-spasi di awal dan akhir. Tidak

Elemen anak

elemen anak Deskripsi
BackgroundTasks Menentukan titik ekstensibilitas aplikasi jenis windows.backgroundTasks. Tugas latar belakang berjalan di host latar belakang khusus; yaitu, tanpa UI.

Elemen induk

elemen induk Deskripsi
Ekstensi (jenis: CT_ApplicationExtensions) Menentukan satu atau beberapa titik ekstensibilitas untuk aplikasi.

Elemen berikut memiliki nama yang sama dengan yang satu ini, tetapi konten atau atribut yang berbeda:

Keterangan

Jika atribut info aktivasi tidak ditentukan pada Ekstensi, atribut tersebut diwarisi dari Aplikasi induk. Lihat bagian keterangan untuk elemen Aplikasi .

Titik ekstensibilitas adalah mekanisme di mana paket dapat menambahkan fungsionalitas dengan cara yang ditentukan oleh sistem operasi. Titik ekstensibilitas adalah lokasi di mana aplikasi dapat mendaftar untuk menjalankan kode atau menggunakan sumber daya paket saat ini. Untuk menambahkan fungsionalitas untuk aplikasi tertentu, gunakan elemen anak Aplikasi dari elemen Aplikasi .

Titik ekstensibilitas windows.certificates tidak dapat dideklarasikan beberapa kali dalam manifes.

Catatan

Atribut EntryPoint atau StartPage diperlukan jika atribut Category adalah windows.UpdateTask atau windows.preInstalledConfigTask untuk versi Windows 10 sebelum Windows 10, versi 1607. Dimulai dengan Windows 10, versi 1607, Anda tidak perlu lagi menentukan nilai untuk EntryPoint atau StartPage saat Kategori adalah windows.Use, UpdateTask, atau windows.preInstalledConfigTask untuk menargetkan hanya perangkat yang berjalan Windows 10, versi 1607 atau yang lebih baru.

Lihat juga

KonsepKontrak dan ekstensi Aplikasi

Persyaratan

Item Nilai
Ruang nama http://schemas.microsoft.com/appx/manifest/foundation/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10