TargetDeviceFamily (Windows 10)

Mengidentifikasi keluarga perangkat yang ditargetkan paket Anda. Untuk informasi selengkapnya tentang keluarga perangkat, lihat Pemrograman dengan SDK ekstensi.

Hierarki elemen

<Paket>

    <Dependensi>

         <TargetDeviceFamily>

Sintaks

<TargetDeviceFamily
    Name = 'An alphanumeric string that can contain period and dash characters.'
    MinVersion = 'A version string in quad notation ("Major.Minor.Build.Revision"), where Major cannot be 0.'
    MaxVersionTested = 'A version string in quad notation ("Major.Minor.Build.Revision"), where Major cannot be 0.' />

Atribut dan elemen

Atribut

Atribut Deskripsi Jenis Data Diperlukan Nilai default
Nama Nama keluarga perangkat yang ditargetkan aplikasi Anda. Lihat bagian Contoh untuk informasi selengkapnya tentang nama keluarga perangkat yang didukung. String alfanumerik yang dapat berisi karakter titik dan tanda hubung. Ya
MinVersion Versi minimum keluarga perangkat yang ditargetkan aplikasi Anda. Digunakan untuk penerapan pada waktu penyebaran. Jika versi keluarga perangkat sistem lebih rendah dari MinVersion, maka aplikasi tidak dianggap berlaku. String versi dalam notasi quad (Major.Minor.Build.Revision), di mana Major tidak dapat 0. Ya
MaxVersionTested Versi maksimum keluarga perangkat yang ditargetkan aplikasi Anda yang telah Anda uji. Ini digunakan pada runtime untuk menentukan ruang proses yang efektif untuk kedaluwarsa. String versi dalam notasi quad (Major.Minor.Build.Revision), di mana Major tidak dapat 0. Ya

Elemen anak

Tidak ada.

Elemen induk

elemen induk Deskripsi
Dependensi Menyatakan paket lain yang bergantung pada paket untuk menyelesaikan perangkat lunaknya.

Contoh

Untuk menargetkan kumpulan API yang dikenal sebagai "keluarga perangkat universal" (yang berarti aplikasi Anda berjalan di semua perangkat), cukup tentukan bahwa satu keluarga perangkat, seperti dalam contoh di bawah ini. Anda masih dapat menulis kode adaptif untuk menyalakan API di luar keluarga perangkat universal saat aplikasi Anda berjalan di perangkat di keluarga perangkat tertentu. Versi 10.0.x.0 dan 10.0.y.0, tentu saja, menjadi nilai yang sama.

<Dependencies>
    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

Catatan

Jika Anda menargetkan "Windows.Universal" dengan "MinVersion" dan "MaxVersionTested" diatur ke versi 10.0.0.0, aplikasi Anda akan menggunakan versi yang ditentukan dalam Versi Target Min dan Versi Target dari file proyek. Jika Anda menggunakan "Windows.Universal" dengan "MinVersion" dan "MaxVersionTested" yang diatur ke nilai selain 10.0.0.0, aplikasi akan menargetkan "MinVersion" dan "MaxVersionTested" yang ditentukan, bukan nilai yang ditentukan dalam file proyek.

Semua keluarga perangkat anak "berasal" dari (yaitu, mereka termasuk) kumpulan API "keluarga perangkat universal". Jadi, keluarga perangkat anak menyiratkan "universal plus API khusus keluarga perangkat anak lainnya". Ketika Anda menargetkan keluarga perangkat anak, Anda tidak perlu menyebutkan universal. Dalam contoh berikutnya, aplikasi menargetkan sekumpulan API yang dikenal sebagai "keluarga perangkat seluler", dan akibatnya hanya akan berjalan pada perangkat yang mengimplementasikan rangkaian API keluarga perangkat seluler (perangkat seluler). Ganti "Seluler" dengan "Desktop", "Xbox", "Holographic", "IoT", atau "IoTHeadless" misalnya, jika Anda ingin menargetkan keluarga perangkat lain.

<Dependencies>
    <TargetDeviceFamily Name="Windows.Mobile" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

Catatan

Jika aplikasi menargetkan keluarga perangkat selain "Windows.Universal", "MinVersion" dan "MaxVersionTested" harus ditentukan dengan benar untuk keluarga perangkat yang ditargetkan.

Untuk menargetkan keluarga perangkat Xbox, atur atribut Name ke "Windows.Xbox". Perhatikan bahwa untuk menargetkan keluarga perangkat Xbox, MinVersion harus diatur ke setidaknya 10.0.14393.0.

<Dependencies>
    <TargetDeviceFamily Name="Windows.Xbox" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

Jika aplikasi Anda dibuat khusus untuk HoloLens dan tidak didukung di platform lain, tentukan keluarga perangkat target "Windows.Holographic".

<Dependencies>
    <TargetDeviceFamily Name="Windows.Holographic" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

Jika aplikasi Anda menargetkan Windows 10 Team Edition secara eksklusif, atur atribut Name ke "Windows.Team". Ini biasanya digunakan untuk perangkat Microsoft Surface Hub.

<Dependencies>
    <TargetDeviceFamily Name="Windows.Team" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

Jika Anda ingin menargetkan platform IoT Core, atur atribut Name ke "Windows.IoT". Untuk aplikasi IoT tanpa kepala, gunakan "Windows.IoTHeadless".

<Dependencies>
    <TargetDeviceFamily Name="Windows.IoT" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

Catatan

Saat ini, aplikasi yang menargetkan IoT atau IoTHeadless tidak valid di app store dan harus digunakan hanya untuk tujuan pengembangan.

Dalam contoh ini, aplikasi menargetkan keluarga perangkat seluler dan desktop. Akibatnya aplikasi dapat berjalan di perangkat seluler atau di perangkat desktop, tetapi tidak ada yang lain. Perhatikan bahwa aplikasi harus menggunakan kode adaptif untuk memanggil API apa pun yang tidak ada dalam kumpulan API keluarga perangkat universal (kecuali api kebetulan dibagikan oleh kedua keluarga perangkat).

<Dependencies>
    <TargetDeviceFamily Name="Windows.Mobile" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
    <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
</Dependencies>

Dalam contoh terakhir ini, aplikasi menargetkan keluarga perangkat universal (jadi, secara default, aplikasi berjalan di semua perangkat dengan versi minimum yang ditentukan). Pengecualiannya adalah bahwa, untuk perangkat yang mengimplementasikan keluarga perangkat seluler, aplikasi memerlukan setidaknya versi 10.0.m.0 untuk hadir. Ini adalah bagaimana Anda menunjukkan bahwa Anda tidak mendukung versi keluarga perangkat anak lebih awal dari versi minimum yang ditentukan, bahkan jika itu berbeda dari versi yang Anda dukung untuk kasus umum (kasus keluarga perangkat universal). Perhatikan juga nilai MaxVersionTested untuk dependensi keluarga perangkat seluler dalam contoh. Jika z > n, aplikasi akan berjalan pada versi 10.0.z.0 dari perangkat seluler, tetapi akan mengalami perilaku versi 10.0.n.0 dari platform pada versi tersebut.

<Dependencies>
    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.x.0" MaxVersionTested="10.0.y.0"/>
    <TargetDeviceFamily Name="Windows.Mobile" MinVersion="10.0.m.0" MaxVersionTested="10.0.n.0"/>
</Dependencies>

Persyaratan

Persyaratan Nilai
Ruang nama http://schemas.microsoft.com/appx/manifest/foundation/windows10