Ekstensi (dalam jenis: CT_ApplicationExtensions)
Mendeklarasikan titik ekstensibilitas untuk aplikasi.
Hierarki elemen
- <Paket>
-
- <Aplikasi>
-
- <Aplikasi>
-
- <Ekstensi>
- <Ekstensi>
Sintaks
<Extension Category = "windows.fileTypeAssociation" | "windows.protocol" | "windows.autoPlayContent" | "windows.autoPlayDevice" | "windows.shareTarget" | ...
Executable? = A string 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 isn't specified, the EntryPoint defined for the app is used.
EntryPoint? = A string 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? = A string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, %, ", /, \, |, ?, or *.
StartPage? = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >
<!-- Child elements -->
( FileTypeAssociation
| Protocol
| AutoPlayContent
| AutoPlayDevice
| ShareTarget
| FileOpenPicker
| FileSavePicker
| BackgroundTasks
)?
</Extension>
Kunci
?
opsional (nol atau satu)
Atribut dan Elemen
Atribut
Atribut | Deskripsi | Jenis Data | Diperlukan | Nilai default |
---|---|---|---|---|
Kategori | Jenis titik ekstensibilitas aplikasi. |
Atribut ini dapat memiliki salah satu nilai berikut:
|
Ya | |
EntryPoint | ID kelas yang dapat diaktifkan. |
Panjang string antara 1 dan 256 karakter, mewakili tugas yang menangani ekstensi. Ini biasanya merupakan nama yang sepenuhnya memenuhi syarat namespace dari jenis Windows Runtime. Jika EntryPoint tidak ditentukan, EntryPoint yang ditentukan untuk aplikasi akan digunakan sebagai gantinya. | Tidak | |
Eksekusi | Peluncuran default yang dapat dieksekusi. |
Panjang string antara 1 dan 256 karakter yang harus diakhbungi 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 | |
RuntimeType | Penyedia runtime. Atribut ini biasanya digunakan ketika ada kerangka kerja campuran dalam aplikasi. |
Panjang string antara 1 dan 255 karakter yang tidak dapat dimulai atau diakhbungi dengan titik atau berisi karakter ini: <, , >:, %, ", /, \, |, ?, atau *. | Tidak | |
StartPage | Halaman web yang menangani titik ekstensibilitas. |
Panjang string antara 1 dan 256 karakter yang tidak boleh berisi karakter ini: <, , >:, %, ", |, ?, atau *. | Tidak |
Elemen Anak
Elemen Anak | Deskripsi |
---|---|
AutoPlayContent | Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.autoPlayContent. Aplikasi ini menyediakan tindakan konten AutoPlay yang ditentukan. |
AutoPlayDevice | Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.autoPlayDevice. Aplikasi ini menyediakan tindakan perangkat AutoPlay yang ditentukan. |
BackgroundTasks | Menentukan titik ekstensibilitas aplikasi jenis windows.backgroundTasks. Tugas latar belakang berjalan di host latar belakang khusus; yaitu, tanpa UI. |
FileOpenPicker | Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.fileOpenPicker. Aplikasi ini memungkinkan pengguna memilih dan membuka jenis file yang ditentukan. |
FileSavePicker | Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.fileSavePicker. Aplikasi ini memungkinkan pengguna memilih nama file, ekstensi, dan lokasi penyimpanan untuk jenis file yang ditentukan. |
FileTypeAssociation | Mendeklarasikan titik ekstensibilitas aplikasi jenis windows.fileTypeAssociation. Asosiasi jenis file menunjukkan bahwa aplikasi terdaftar untuk menangani file dari jenis yang ditentukan. |
Protokol | Mendeklarasikan titik ekstensibilitas aplikasi dari jenis windows.protocol. Asosiasi URI menunjukkan bahwa aplikasi terdaftar untuk menangani URI dengan skema yang ditentukan. |
ShareTarget | Mendeklarasikan titik ekstensi aplikasi jenis windows.shareTarget. Aplikasi ini dapat berbagi jenis file yang ditentukan. |
Elemen Induk
Elemen Induk | Deskripsi |
---|---|
Ekstensi (jenis: CT_ApplicationExtensions) | Menentukan satu atau beberapa titik ekstensibilitas untuk aplikasi. |
Elemen terkait
Elemen berikut memiliki nama yang sama dengan yang satu ini, tetapi konten atau atribut yang berbeda:
Keterangan
Titik ekstensibilitas ini hanya dapat dideklarasikan sekali per aplikasi:
- windows.accountPictureProvider
- windows.cachedFileUpdater
- windows.cameraSettings
- windows.contactPicker
- windows.fileOpenPicker
- windows.fileSavePicker
- windows.printTaskSettings
- windows.search
- windows.shareTarget
**Catatan tentang aturan semantik untuk ekstensi: **Untuk elemen Ekstensi apa pun, aturan semantik berikut diberlakukan dalam API manifes:
Jika /Application/@StartPage ditentukan, ini adalah aplikasi Windows menggunakan JavaScript dan Ekstensi Aplikasi :
- Bisa kosong
- Hanya dapat menentukan StartPage
- Dapat menentukan Executable dan EntryPoint (RuntimeType opsional diizinkan), kecuali jika itu adalah ekstensi BackgroundTask, dalam hal ini dapat menghilangkan Executable dan default ke BackgroundTaskHost.exe dapat dieksekusi.
Jika /Application/@StartPage tidak ditentukan, ini adalah aplikasi UWP menggunakan C# atau VB dan XAML dan Ekstensi Aplikasi :
- Bisa kosong
- Hanya dapat menentukan StartPage
- Harus menentukan EntryPoint jika Executable atau RuntimeType ditentukan.
Contoh
Contoh berikut diambil dari manifes paket salah satu sampel SDK.
<Applications>
<Application Id="App" StartPage="default.html">
<VisualElements DisplayName="Assocation launching sample"
Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png"
Description="SDK sample"
ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
<DefaultTile ShowName="allLogos" />
<SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
</VisualElements>
<Extensions>
<Extension Category="windows.fileTypeAssociation">
<FileTypeAssociation Name=".alsdkjs">
<SupportedFileTypes>
<FileType>.alsdkjs</FileType>
</SupportedFileTypes>
</FileTypeAssociation>
</Extension>
<Extension Category="windows.protocol">
<Protocol Name="alsdkjs" />
</Extension>
</Extensions>
</Application>
</Applications>
Lihat juga
KonsepKontrak dan ekstensi Aplikasi
Persyaratan
Nilai | |
---|---|
Ruang nama | http://schemas.microsoft.com/appx/2010/manifest |