uap:Extension (Windows 10)
Mendeklarasikan titik ekstensibilitas untuk aplikasi.
Hierarki elemen
<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.'
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 -->
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 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 tidak dapat dimulai atau diakhir . dengan atau berisi karakter: <, , :>, ", |, ?, atau *. |
Tidak | |
| StartPage | Halaman web yang menangani titik ekstensibilitas. | String dengan nilai antara 1 dan 256 karakter yang 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 surat. | Tidak | |
| uap10:TrustLevel | Menentukan tingkat kepercayaan ekstensi. | Nilai string opsional. Jika ditentukan, itu 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 runtime host untuk ekstensi. | String alfanumerik dengan nilai opsional 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. | String 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. | 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. | 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 |
|---|---|
| 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 dari 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 | Menyatakan 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, 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 dari 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 yang 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 Cari. 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 aplikasi 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 |
| Versi OS Minimum | Windows 10 versi 1511 (Build 10586) |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk