TargetDeviceFamily (Windows 10)

Определяет семейство устройств, предназначенное для пакета. Дополнительные сведения о семействах устройств см. в разделе "Программирование с помощью пакетов SDK для расширений".

Иерархия элементов

<Пакет>

    <Зависимости>

         <TargetDeviceFamily>

Синтаксис

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

Элементы и атрибуты

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
имя; Имя семейства устройств, на которое предназначено ваше приложение. Дополнительные сведения о поддерживаемых именах семейств устройств см. в разделе "Примеры". Буквенно-цифровой строки, которая может содержать символы точки и тире. Да
MinVersion Минимальная версия семейства устройств, на которую нацелено ваше приложение. Используется для применимости во время развертывания. Если версия семейства устройств системы ниже , чем MinVersion, приложение не считается применимым. Строка версии в четырехугольной нотации (Major.Minor.Build.Revision), где Major не может быть 0. Да
MaxVersionTested Максимальная версия семейства устройств, на которую нацелено ваше приложение, на которое оно было протестировано. Он используется во время выполнения для определения эффективного пространства процессов для причудливых процедур. Строка версии в четырехугольной нотации (Major.Minor.Build.Revision), где Major не может быть 0. Да

Дочерние элементы

Отсутствует.

Родительские элементы

Родительский элемент Описание
Зависимости Объявляет другие пакеты, от которые пакет зависит от завершения своего программного обеспечения.

Примеры

Чтобы выбрать набор API, известный как "универсальное семейство устройств" (что означает, что приложение выполняется на всех устройствах), просто укажите одно семейство устройств, как показано в примере ниже. Вы по-прежнему можете написать адаптивный код, чтобы включить API за пределами универсального семейства устройств, когда приложение работает на устройствах в определенных семействах устройств. Версии 10.0.x.0 и 10.0.y.0 могут быть одинаковыми.

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

Примечание

Если вы используете windows.Universal с параметром MinVersion и MaxVersionTested версии 10.0.0.0, ваше приложение будет использовать версии, указанные в целевой минимальной версии и целевой версии файла проекта соответственно. Если вы используете "Windows.Universal" с параметром MinVersion и MaxVersionTested значение, отличное от 10.0.0.0, приложение будет нацелено на указанные значения MinVersion и MaxVersionTested вместо значений, указанных в файле проекта.

Все семейства дочерних устройств являются производными от (т. е. они включают) набор API универсального семейства устройств. Таким образом, семейство дочерних устройств подразумевает "универсальные и другие API для конкретного семейства дочерних устройств". При выборе семейства дочерних устройств не нужно упоминать универсальные. В следующем примере приложение предназначено для набора API, известного как "семейство мобильных устройств", и, следовательно, оно будет работать только на устройствах, реализующих набор API семейства мобильных устройств (мобильных устройств). Замените "Mobile" на "Desktop", "Xbox", "Holographic", "IoT" или "IoTHeadless", например, если вы хотите выбрать другое семейство устройств.

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

Примечание

Если приложение предназначено для семейства устройств, отличных от Windows.Universal, для семейства устройств, предназначенных для семейства устройств, необходимо правильно указать "MinVersion" и "MaxVersionTested".

Чтобы выбрать семейство устройств Xbox, задайте для атрибута Name значение "Windows.Xbox". Обратите внимание, что для семейства устройств Xbox параметр MinVersion должен иметь значение не менее 10.0.14393.0.

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

Если приложение создано специально для HoloLens и не поддерживается на других платформах, укажите семейство целевых устройств Windows.Holographic.

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

Если приложение предназначено исключительно для выпуска Windows 10 для совместной работы Edition, задайте для атрибута Name значение "Windows.Team". Обычно это используется для Microsoft Surface Hub устройств.

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

Если вы хотите нацелиться на платформу IoT Core, задайте для атрибута Name значение "Windows.IoT". Для приложения Интернета вещей без головы используйте Windows.IoTHeadless.

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

Примечание

В настоящее время приложения, предназначенные для Интернета вещей или IoTHeadless, недопустимы в магазине приложений и должны использоваться только для целей разработки.

В этом примере приложение предназначено для семейств мобильных и настольных устройств. Следовательно, приложение может работать на мобильных устройствах или на настольных устройствах, но не на других устройствах. Обратите внимание, что приложение должно использовать адаптивный код для вызова любого API, который не входит в универсальный набор API семейства устройств (если API не будет совместно использоваться обоими семействами устройств).

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

В этом последнем примере приложение предназначено для универсального семейства устройств (поэтому по умолчанию оно выполняется на всех устройствах с указанной минимальной версией). Исключением является то, что для устройств, реализующих семейство мобильных устройств, для приложения требуется по крайней мере версия 10.0.m.0. Это означает, что вы не поддерживаете версии дочерних семейств устройств, предшествующих указанной минимальной версии, даже если это отличается от версии, поддерживаемой для общего случая (вариант универсального семейства устройств). Также обратите внимание на значение MaxVersionTested для зависимости семейства мобильных устройств в примере. Где z > n, приложение будет работать в версии 10.0.z.0 мобильного устройства, но оно будет работать с версией 10.0.n.0 от платформы в этой версии.

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

Требования

Требование Значение
Пространство имен http://schemas.microsoft.com/appx/manifest/foundation/windows10