uap:Ekstensi (Windows 10)

Mendeklarasikan titik ekstensibilitas untuk aplikasi.

Hierarki elemen

<Paket>

    <Aplikasi>

         <Aplikasi>

              <Ekstensi>

                   <uap:Extension>

Sintaks

<uap:Extension
  Category = 'A string that can have one of the following values: "windows.fileTypeAssociation", "windows.protocol", "windows.autoPlayContent", "windows.autoPlayDevice", "windows.shareTarget", "windows.search", "windows.fileOpenPicker", "windows.fileSavePicker", "windows.cachedFileUpdater", "windows.cameraSettings", "windows.accountPictureProvider", "windows.printTaskSettings", "windows.lockScreenCall", "windows.appointmentsProvider", "windows.alarm", "windows.webAccountProvider", "windows.dialProtocol", "windows.appService", "windows.mediaPlayback", "windows.print3DWorkflow", "windows.lockScreen", "windows.aboveLockScreen", "windows.personalAssistantLaunch", or "windows.voipCall".'
  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 -->
  uap:FileTypeAssociation?
  uap:Protocol?
  uap:AutoPlayContent?
  uap:AutoPlayDevice?
  uap:ShareTarget?
  uap:FileOpenPicker?
  uap:FileSavePicker?
  uap:AppointmentsProvider?
  uap:WebAccountProvider?
  uap:DialProtocol?
  uap:AppService?
  uap:MediaPlayback?
  uap:VoipCall?

</uap:Extension>

Kunci

? opsional (nol atau satu)

Atribut dan elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
Kategori Jenis titik ekstensibilitas paket. String yang dapat memiliki salah satu nilai berikut: windows.fileTypeAssociation, windows.protocol, windows.autoPlayContent, windows.autoPlayDevice, windows.shareTarget, windows.search, windows.fileOpenPicker, windows.fileSavePicker, windows.cachedFileUpdater, windows.cameraSettings, windows.accountPictureProvider, windows.printTaskSettings, windows.lockScreenCall, windows.appointmentsProvider, windows.alarm, windows.webAccountProvider, windows.dialProtocol, windows.appService, windows.mediaPlayback, windows.print3DWorkflow, windows.lockScreen, windows.aboveLockScreen, windows.personalAssistantLaunch, atau windows.voipCall. 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 diakhbungi . 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. Nilai string opsional. Jika ditentukan, itu bisa menjadi salah satu nilai berikut: windowsApp, packagedClassicApp, atau win32App. Tidak
uap10:HostId Menentukan ID aplikasi aplikasi 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 yang memiliki identitas paket. String dengan panjang nilai antara 1 dan 32767 karakter dengan karakter non-spasi di awal dan akhir. Tidak

Elemen anak

elemen anak Deskripsi
uap:AppService Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.appService. Kontrak Aplikasi adalah cara bagi aplikasi untuk memanggil tugas latar belakang milik aplikasi lain; atau untuk tugas latar belakang yang dipanggil untuk melayani kontrak aplikasi dengan cara untuk berkomunikasi dengan pemanggilnya.
uap:AppointmentsProvider Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.appointmentsProvider.
uap:AutoPlayContent Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.autoPlayContent. Aplikasi ini menyediakan tindakan konten AutoPlay yang ditentukan.
uap:AutoPlayDevice Mendeklarasikan titik ekstensibilitas aplikasi jenis *windows.autoPlayDevice. Aplikasi ini menyediakan tindakan perangkat AutoPlay yang ditentukan.
uap:DialProtocol Mendeklarasikan titik ekstensibilitas aplikasi dari jenis windows.dialProtocol*.
uap:FileOpenPicker Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.fileOpenPicker. Aplikasi ini memungkinkan pengguna memilih dan membuka jenis file yang ditentukan.
uap:FileSavePicker Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.fileSavePicker. Aplikasi ini memungkinkan pengguna memilih nama file, ekstensi, dan lokasi penyimpanan untuk jenis file yang ditentukan.
uap:FileTypeAssociation Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.fileTypeAssociation. Asosiasi jenis file menunjukkan bahwa aplikasi terdaftar untuk menangani file dari jenis yang ditentukan.
uap:MediaPlayback Mendeklarasikan titik ekstensibilitas aplikasi dari jenis mediaPlayback sehingga aplikasi Anda dapat menyatakan bahwa aplikasi tersebut melakukan transcoding video.
uap:Protocol Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.protocol. Asosiasi URI menunjukkan bahwa aplikasi terdaftar untuk menangani URI dengan skema yang ditentukan.
uap:ShareTarget Mendeklarasikan titik ekstensi aplikasi jenis windows.shareTarget. Aplikasi ini dapat berbagi jenis file yang ditentukan.
uap:VoipCall Mendeklarasikan titik ekstensibilitas aplikasi dari jenis windows.voipCall sehingga aplikasi Anda dapat menyatakan bahwa aplikasi dapat melakukan peningkatan dari panggilan seluler ke panggilan video VoIP, dan/atau apakah itu adalah aplikasi VoIP yang mendukung panggilan nomor telepon secara langsung.
uap:WebAccountProvider Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.webAccountProvider.

Elemen induk

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

Keterangan

Untuk sebagian besar jenis ekstensi, Extension@ResourceGroup harus cocok dengan Application@ResourceGroup (jika Application@ResourceGroup dihilangkan maka Extension@ResourceGroup juga harus dihilangkan).

Untuk kontrak berbasis UI: jika Extension@ResourceGroup tidak ditentukan maka kontrak tersebut akan dikelompokkan secara implisit dengan Aplikasi; jika Extension@ResourceGroup tidak cocok dengan Application@ResourceGroup maka manifes akan gagal dalam validasi skema.

Jika Extension@ResourceGroup tidak ditentukan untuk tugas latar belakang, atau untuk kontrak yang didasarkan pada tugas latar belakang, itu akan dikaitkan dengan grup default untuk semua tugas latar belakang. Kontrak tugas latar belakang diizinkan untuk menentukan nilai yang sama dengan Application@ResourceGroup.

Untuk Ekstensi berikut, Extension@ResourceGroup memungkinkan tugas latar belakang yang dijalankan untuk dikelompokkan ke dalam berbagai proses yang akan dikelola sumber daya dan siklus hidup secara independen dari grup lain: windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask, dan windows.updateTask.

Misalnya, jika manifes memiliki tiga entri ini.

<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask" ResourceGroup="Group1">
  <BackgroundTasks>
    <Task Type="timer"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask2" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="controlChannel"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask3" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="pushNotification"/>
  </BackgroundTasks>
</Extension>

Kemudian dua tugas latar belakang terakhir akan diaktifkan ke dalam instans backgroundtaskhost.exe yang sama jika diaktifkan secara bersamaan. Namun, instans terpisah backgroundtaskhost.exe akan dipisahkan untuk entri pertama karena memiliki ResourceGroup yang berbeda.

Jika tidak ada ResourceGroup yang ditentukan untuk ekstensi, semua tugas latar belakang diaktifkan ke dalam instans yang sama dari backgroundtaskhost.exe.

Selain itu jika salah satu ekstensi ini (windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask, atau windows.updateTask) menentukan nilai yang sama dari atribut ResourceGroup dari elemen Aplikasi induk, mereka akan diaktifkan dalam proses yang sama dengan UI.

Ekstensi berikut dapat ditemukan di tab deklarasi UI perancang paket - lihat deskripsi untuk setiap elemen ini:

  • Pencarian: Mendaftarkan aplikasi sebagai penyedia pencarian. Konten terindeks aplikasi dapat muncul sebagai hasil pencarian dalam pengalaman pencarian global yang diluncurkan melalui tombol Pencarian. Hanya satu instans deklarasi ini yang diizinkan per aplikasi.
  • CachedFileUpdater: Mendaftarkan aplikasi sebagai pembaruan file yang di-cache, memungkinkan aplikasi untuk menyediakan pembaruan ke file yang diakses oleh aplikasi Microsoft Store lainnya. Hanya satu instans deklarasi ini yang diizinkan per aplikasi.
  • Pengaturan Kamera: Memungkinkan aplikasi menyediakan panel kontrol kustom untuk perangkat kamera web. Hanya satu instans deklarasi ini yang diizinkan per aplikasi.
  • AccountPictureProvider: Mendaftarkan aplikasi sebagai penyedia gambar akun, memungkinkannya diluncurkan dalam mode gambar akun dan untuk mengatur gambar pengguna tanpa permintaan tambahan. Hanya satu instans deklarasi ini yang diizinkan per aplikasi.
  • PrintTaskSettings: Memungkinkan aplikasi menggantikan pengalaman pengaturan cetak dasar. Hanya satu instans deklarasi ini yang diizinkan per aplikasi.
  • LockScreen: Jika ponsel dikunci, ada sejumlah interaksi terbatas yang dapat dilakukan pengguna. Dalam beberapa kasus, pengguna ingin dapat menjawab panggilan VoIP tanpa membuka kunci telepon. Kontrak ini memungkinkan hal itu. Hanya satu instans deklarasi ini yang diizinkan per aplikasi.
  • Alarm: Aplikasi dapat mendeklarasikan dirinya sebagai Aplikasi Alarm Sistem. Ketika pengguna melalui UI pilihan untuk mengatur Alarm Sistem mereka, hanya aplikasi yang dinyatakan sebagai Aplikasi Alarm Sistem yang dapat dipilih. Hanya satu instans deklarasi ini yang diizinkan per aplikasi.
  • BackgroundTasks: Tugas latar belakang memungkinkan aplikasi berkomunikasi satu sama lain dan memungkinkan satu aplikasi untuk memanggil yang lain. Untuk menggunakan kontrak untuk menyediakan atau meluncurkan tugas latar belakang ini, aplikasi perlu dideklarasikan sebagai layanan aplikasi. Beberapa instans deklarasi ini diizinkan di setiap aplikasi.
  • Print3DWorkFlow: Produsen printer 3D dapat menyediakan aplikasi Universal Windows untuk memberikan pengalaman unik dalam dialog cetak 3D. Jika tidak, Windows menyediakan pengalaman pencetakan 3D default. Hanya satu instans deklarasi ini yang diizinkan per aplikasi.
  • PersonalAssistantLaunch: Memungkinkan aplikasi untuk berintegrasi dengan Cortana. Hanya satu instans deklarasi ini yang diizinkan per aplikasi.

Persyaratan

Item Nilai
rescap4 http://schemas.microsoft.com/appx/manifest/uap/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10