TargetDeviceFamily (Windows 10)TargetDeviceFamily (Windows 10)

Identifica la familia de dispositivos a la que se destina el paquete.Identifies the device family that your package targets. Para obtener más información acerca de las familias de dispositivos, consulte Programming with EXTENSION SDK.For more info about device families, see Programming with extension SDKs.

Jerarquía de elementoElement hierarchy

<Configura>
<Package>
<Dependencias>
<Dependencies>
<TargetDeviceFamily><TargetDeviceFamily>

SintaxisSyntax

<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". />

Atributos y elementosAttributes and Elements

AtributosAttributes

AtributoAttribute DescripciónDescription Tipo de datosData type ObligatorioRequired Valor predeterminadoDefault value
MaxVersionTestedMaxVersionTested

La versión máxima de la familia de dispositivos a la que se destina la aplicación y con la que se ha comprobado.The maximum version of the device family that your app is targeting that you have tested it against. Se utiliza en tiempo de ejecución para determinar el espacio de proceso efectivo para las peculiaridades.This is used at runtime to determine the effective process space for quirks.

Una cadena de versión en notación cuádruple, " principal. secundaria. compilación. revisión " .A version string in quad notation, "Major.Minor.Build.Revision". Yes
MinVersionMinVersion

La versión mínima de la familia de dispositivos a la que se destina la aplicación.The minimum version of the device family that your app is targeting. Se usa para la aplicabilidad en el momento de la implementación.Used for applicability at deployment time. Si la versión del sistema de la familia del dispositivo es inferior a MinVersion, la aplicación no se considera aplicable.If the device family version of the system is lower than MinVersion, then the app is not considered applicable.

Una cadena de versión en notación cuádruple, " principal. secundaria. compilación. revisión " .A version string in quad notation, "Major.Minor.Build.Revision". Yes
NombreName

El nombre de la familia de dispositivos que tiene como destino la aplicación.The name of the device family that your app is targeting. Vea la sección ejemplos para obtener más información sobre los nombres de familia de dispositivos compatibles.See the Examples section for more information about the supported device family names.

Cadena alfanumérica.An alphanumeric string. Puede contener caracteres de punto y Guion.May contain period and dash characters. Yes

Elementos secundariosChild Elements

Ninguno.None.

Elementos primariosParent Elements

Elemento primarioParent Element DescripciónDescription
Dependencias Dependencies

Declara otros paquetes de los que depende un paquete para completar su software.Declares other packages that a package depends on to complete its software.

EjemplosExamples

Para elegir como destino el conjunto de API que se conoce como "familia de dispositivos universales" (lo que significa que la aplicación se ejecuta en todos los dispositivos), solo tiene que especificar una familia de dispositivos, como en el ejemplo siguiente.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. Todavía puede escribir código adaptable para aclarar las API fuera de la familia de dispositivos universales cuando la aplicación se ejecuta en dispositivos de familias de dispositivos específicas.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. Las versiones 10.0. x. 0 y 10.0. y 0 pueden, por supuesto, tener el mismo valor.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

Si el destino es "Windows. universal" con "MinVersion" y "MaxVersionTested" establecido en la versión 10.0.0.0, la aplicación usará las versiones especificadas en la versión de destino min y la versión de destino del archivo de proyecto, respectivamente.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. Si usa "Windows. universal" con "MinVersion" y "MaxVersionTested" establecido en un valor distinto de 10.0.0.0, la aplicación tendrá como destino "MinVersion" y "MaxVersionTested" en lugar de los valores especificados en el archivo de proyecto.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.

Todas las familias de dispositivos secundarios "derivan" de (es decir, incluyen) el conjunto de API de "familia de dispositivos universales".All child device families "derive" from (that is, they include) the "universal device family" set of APIs. Por lo tanto, una familia de dispositivos secundarios implica "universal y otras API específicas de la familia de dispositivos secundarios".So, a child device family implies "universal plus other child-device-family-specific APIs". Cuando el destino es una familia de dispositivos secundarios, no es necesario mencionar universal.When you target a child device family, you don't need to mention universal. En el ejemplo siguiente, la aplicación tiene como destino el conjunto de API conocido como "familia de dispositivos móviles" y, por lo tanto, se ejecutará solo en dispositivos que implementen el conjunto de API de la familia de dispositivos móviles (dispositivos móviles).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). Reemplace "Mobile" por "Desktop", "Xbox", "Holographic", "IoT" o "IoTHeadless" por ejemplo, si desea establecer como destino otra familia de dispositivos.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

Si la aplicación está destinada a una familia de dispositivos distinta de "Windows. universal", se debe especificar correctamente "MinVersion" y "MaxVersionTested" para la familia de dispositivos de destino.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.

Para dirigirse a la familia de dispositivos Xbox, establezca el atributo de nombre en "Windows. xbox".To target the Xbox device family, set the Name attribute to "Windows.Xbox". Tenga en cuenta que para tener como destino la familia de dispositivos Xbox, el valor de MinVersion debe ser al menos 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>

Si la aplicación se crea específicamente para HoloLens y no se admite en otras plataformas, especifique la familia de dispositivos de destino "Windows. Holographic".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>

Si su aplicación tiene como destino Windows 10 Team Edition exclusivamente, establezca el atributo de nombre en "Windows. Team".If your app targets the Windows 10 Team Edition exclusively, set the Name attribute to "Windows.Team". Esto se usa normalmente para dispositivos de 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>

Si desea establecer como destino la plataforma de IoT Core, establezca el atributo name en "Windows. IoT".If you want to target the IoT Core platform, set the Name attribute to "Windows.IoT". Para una aplicación de IoT sin periféricos, use "Windows. IoTHeadless".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

Actualmente, las aplicaciones que tienen como destino IoT o IoTHeadless no son válidas en App Store y deben usarse solo con fines de desarrollo.Currently, apps targeting IoT or IoTHeadless are not valid in the app store and should be used for development purposes only.

En este ejemplo, la aplicación tiene como destino las familias de dispositivos móviles y de escritorio.In this example, the app targets the mobile and desktop device families. Por lo tanto, la aplicación se puede ejecutar en dispositivos móviles o en dispositivos de escritorio, pero no en otras.Consequently the app can run on mobile devices or on desktop devices, but no others. Tenga en cuenta que la aplicación debe usar código adaptable para llamar a cualquier API que no esté en el conjunto de API de la familia de dispositivos universales (a menos que la API se comparta entre ambas familias de dispositivos).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>

En este último ejemplo, la aplicación tiene como destino la familia de dispositivos universales (de forma predeterminada, se ejecuta en todos los dispositivos con la versión mínima especificada).In this last example, the app targets the universal device family (so, by default, it runs on all devices with the specified minimum version). La excepción es que, en el caso de los dispositivos que implementan la familia de dispositivos móviles, la aplicación requiere que haya al menos la versión 10.0. m. 0.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. Este es el modo en que indica que no se admiten las versiones de las familias de dispositivos secundarias anteriores a una versión mínima especificada, incluso si difiere de la versión que admite para el caso general (el caso de la familia de dispositivos universales).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). Tenga en cuenta también el valor MaxVersionTested de la dependencia de la familia de dispositivos móviles en el ejemplo.Also note the MaxVersionTested value for the mobile device family dependency in the example. Donde z > n, la aplicación se ejecutará en la versión 10.0. z. 0 de un dispositivo móvil, pero se producirá un comportamiento de la versión 10,0. n. 0 de la plataforma en esa versión.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>

RequisitosRequirements

RequisitoRequirement ValorValue
Espacio de nombresNamespace http://schemas.microsoft.com/appx/manifest/foundation/windows10