TargetDeviceFamily (Windows 10)TargetDeviceFamily (Windows 10)

Identifica la famiglia di dispositivi di destinazione del pacchetto.Identifies the device family that your package targets. Per altre informazioni sulle famiglie di dispositivi, vedere programmazione con SDK di estensione.For more info about device families, see Programming with extension SDKs.

Gerarchia degli elementiElement hierarchy

<Pacchetto>
<Package>
<Dipendenze>
<Dependencies>
<TargetDeviceFamily><TargetDeviceFamily>

SintassiSyntax

<TargetDeviceFamily Name             = An alphanumeric string. May contain period and dash characters.
                    MinVersion       = A version string in quad notation, "Major.Minor.Build.Revision".
                    MaxVersionTested = A version string in quad notation, "Major.Minor.Build.Revision". />

Attributi ed elementiAttributes and Elements

AttributiAttributes

AttributoAttribute DescrizioneDescription Tipo di datiData type ObbligatoriaRequired Valore predefinitoDefault value
MaxVersionTestedMaxVersionTested

Versione massima del gruppo di dispositivi a cui è destinata l'app che è stata testata.The maximum version of the device family that your app is targeting that you have tested it against. Viene usato in fase di esecuzione per determinare lo spazio di elaborazione effettivo per le stranezze.This is used at runtime to determine the effective process space for quirks.

Stringa di versione in notazione quad, " Major. minor. Build. Revision " .A version string in quad notation, "Major.Minor.Build.Revision". Yes
MinVersionMinVersion

Versione minima del gruppo di dispositivi a cui è destinata l'app.The minimum version of the device family that your app is targeting. Usato per l'applicabilità al momento della distribuzione.Used for applicability at deployment time. Se la versione della famiglia di dispositivi del sistema è inferiore a MinVersion, l'app non è considerata applicabile.If the device family version of the system is lower than MinVersion, then the app is not considered applicable.

Stringa di versione in notazione quad, " Major. minor. Build. Revision " .A version string in quad notation, "Major.Minor.Build.Revision". Yes
NomeName

Nome della famiglia di dispositivi a cui è destinata l'app.The name of the device family that your app is targeting. Vedere la sezione esempi per ulteriori informazioni sui nomi di famiglia di dispositivi supportati.See the Examples section for more information about the supported device family names.

Stringa alfanumerica.An alphanumeric string. Può contenere caratteri punto e trattino.May contain period and dash characters. Yes

Elementi figlioChild Elements

No.None.

Elementi padreParent Elements

Elemento padreParent Element DescrizioneDescription
Dipendenze Dependencies

Dichiara altri pacchetti da cui dipende un pacchetto per completare il software.Declares other packages that a package depends on to complete its software.

EsempiExamples

Per impostare come destinazione il set di API noto come "famiglia di dispositivi universali", che significa che l'app viene eseguita in tutti i dispositivi, è sufficiente specificare una famiglia di dispositivi, come nell'esempio riportato di seguito.To target the set of APIs known as the "universal device family" (which means your app runs on all devices), just specify that one device family, as in the example below. È comunque possibile scrivere codice adattivo per illuminare le API all'esterno della famiglia di dispositivi universali quando l'app è in esecuzione su dispositivi in famiglie di dispositivi specifici.You can still write adaptive code to light up APIs outside of the universal device family when your app is running on devices in specific device families. Le versioni 10.0. x. 0 e 10.0. y. 0 possono, ovviamente, essere lo stesso valore.Versions 10.0.x.0 and 10.0.y.0 can, of course, be the same value.

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

Nota

Se la destinazione è "Windows. Universal" con "MinVersion" e "MaxVersionTested" impostato sulla versione 10.0.0.0, l'app userà rispettivamente le versioni specificate nella versione minima e nella versione di destinazione del file di progetto.If you target "Windows.Universal" with both "MinVersion" and "MaxVersionTested" set to version 10.0.0.0, your app will use the versions specified in the Target Min Version and Target Version of the project file, respectively. Se si usa "Windows. Universal" con "MinVersion" e "MaxVersionTested" impostato su un valore diverso da 10.0.0.0, l'app verrà destinata a "MinVersion" e "MaxVersionTested" specificati, anziché ai valori specificati nel file di progetto.If you are using "Windows.Universal" with "MinVersion" and "MaxVersionTested" set to a value other than 10.0.0.0, the app will target the specified "MinVersion" and "MaxVersionTested" instead of the values specified in the project file.

Tutte le famiglie di dispositivi figlio "derivano" da (ovvero includono) il set di API "Universal Device Family".All child device families "derive" from (that is, they include) the "universal device family" set of APIs. Una famiglia di dispositivi figlio implica quindi la "Universal Plus altre API specifiche per le famiglie di dispositivi figlio".So, a child device family implies "universal plus other child-device-family-specific APIs". Quando si fa riferimento a una famiglia di dispositivi figlio, non è necessario menzionare Universal.When you target a child device family, you don't need to mention universal. Nell'esempio seguente l'app è destinata al set di API noto come "famiglia di dispositivi mobili" e, di conseguenza, viene eseguita solo su dispositivi che implementano il set di API per dispositivi mobili (dispositivi mobili).In this next example, the app is targeting the set of APIs known as the "mobile device family", and consequently it will run only on devices that implement the mobile device family set of APIs (mobile devices). Sostituire "mobile" con "desktop", "Xbox", "olografico", "IoTHeadless" o "", ad esempio se si vuole usare come destinazione un altro gruppo di dispositivi.Replace "Mobile" with "Desktop", "Xbox", "Holographic", "IoT", or "IoTHeadless" for example, if you want to target another device family.

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

Nota

Se l'app è destinata a una famiglia di dispositivi diversa da "Windows. Universal", è necessario specificare correttamente "MinVersion" e "MaxVersionTested" per la famiglia di dispositivi di destinazione.If the app is targeting a device family other than "Windows.Universal", the "MinVersion" and "MaxVersionTested" must be properly specified for the device family that is targeted.

Per impostare come destinazione il gruppo di dispositivi Xbox, impostare l'attributo Name su "Windows. Xbox".To target the Xbox device family, set the Name attribute to "Windows.Xbox". Si noti che per la destinazione del gruppo di dispositivi Xbox, il MinVersion deve essere impostato almeno su 10.0.14393.0.Note that to target the Xbox device family, the MinVersion must be set to at least 10.0.14393.0.

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

Se l'app è stata creata in modo specifico per HoloLens e non è supportata su altre piattaforme, specificare il gruppo di dispositivi di destinazione "Windows. olografico".If your app is created specifically for HoloLens and is not supported on other platforms, specify the target device family "Windows.Holographic".

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

Se l'app è destinata esclusivamente a Windows 10 Team Edition, impostare l'attributo Name su "Windows. team".If your app targets the Windows 10 Team Edition exclusively, set the Name attribute to "Windows.Team". Questa operazione viene in genere usata per i dispositivi Microsoft Surface Hub.This is commonly used for Microsoft Surface Hub devices.

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

Se si vuole usare come destinazione la piattaforma Internet delle cose core, impostare l'attributo Name su "Windows. Internet".If you want to target the IoT Core platform, set the Name attribute to "Windows.IoT". Usare "Windows. IoTHeadless" per un'app per l'uso di un sacco di cose.For a headless IoT app, use "Windows.IoTHeadless".

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

Nota

Attualmente, le app destinate a IoTHeadless non sono valide nell'App Store e devono essere usate solo a scopo di sviluppo.Currently, apps targeting IoT or IoTHeadless are not valid in the app store and should be used for development purposes only.

In questo esempio l'app è destinata alle famiglie di dispositivi mobili e desktop.In this example, the app targets the mobile and desktop device families. Di conseguenza, l'app può essere eseguita su dispositivi mobili o su dispositivi desktop, ma non su altri.Consequently the app can run on mobile devices or on desktop devices, but no others. Si noti che l'app deve usare codice adattivo per chiamare qualsiasi API che non si trova nel gruppo di API del dispositivo universale (a meno che l'API non sia condivisa da entrambi i gruppi di dispositivi).Note that the app must use adaptive code to call any API that is not in the universal device family set of APIs (unless the API happens to be shared by both device families).

<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>

In questo ultimo esempio, l'app è destinata alla famiglia di dispositivi universali, quindi, per impostazione predefinita, viene eseguita in tutti i dispositivi con la versione minima specificata.In this last example, the app targets the universal device family (so, by default, it runs on all devices with the specified minimum version). L'eccezione è che, per i dispositivi che implementano la famiglia di dispositivi mobili, l'app richiede almeno la versione 10.0. m. 0 per essere presente.The exception being that, for devices that implement the mobile device family, the app requires at least version 10.0.m.0 to be present. Questo è il modo in cui si indica che non sono supportate versioni di famiglie di dispositivi figlio precedenti a una versione minima specificata, anche se la versione è diversa da quella supportata per il caso generale (il caso della famiglia di dispositivi universale).This is how you indicate that you do not support versions of child device families earlier than a specified minimum version, even if that differs from the version you support for the general case (the universal device family case). Si noti anche il valore MaxVersionTested per la dipendenza della famiglia di dispositivi mobili nell'esempio.Also note the MaxVersionTested value for the mobile device family dependency in the example. Dove z > n, l'app verrà eseguita con la versione 10.0. z. 0 di un dispositivo mobile, ma si verificherà 10.0. n. 0-comportamento della versione della piattaforma in tale versione.Where z > n, the app will run on version 10.0.z.0 of a mobile device, but it will experience 10.0.n.0-version behavior from the platform on that version.

<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>

RequisitiRequirements

RequisitoRequirement valoreValue
Spazio dei nomiNamespace http://schemas.microsoft.com/appx/manifest/foundation/windows10