TargetDeviceFamily (Windows 10)

Identifiziert die Gerätefamilie, die Ihr Paket angibt. Weitere Informationen zu Gerätefamilien finden Sie unter Programmierung mit Erweiterungs-SDKs.

Elementhierarchie

<Paket>

    <Abhängigkeiten>

         <TargetDeviceFamily>

Syntax

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

Attribute und Elemente

Attributes

attribute BESCHREIBUNG Datentyp Erforderlich Standardwert
Name Der Name der Gerätefamilie, auf die Ihre App ausgerichtet ist. Weitere Informationen zu den unterstützten Gerätefamiliennamen finden Sie im Abschnitt "Beispiele ". Eine alphanumerische Zeichenfolge, die Punkt- und Strichzeichen enthalten kann. Ja
Minversion Die Mindestversion der Gerätefamilie, auf die Ihre App ausgerichtet ist. Wird zur Anwendbarkeit zur Bereitstellungszeit verwendet. Wenn die Gerätefamilienversion des Systems niedriger als MinVersion ist, gilt die App nicht als anwendbar. Eine Versionszeichenfolge in Vierfach-Notation (Major.Minor.Build.Revision), wo Major nicht .0 Ja
MaxVersionTested Die maximale Version der Gerätefamilie, auf die Ihre App ausgerichtet ist, für die Sie es getestet haben. Dies wird zur Laufzeit verwendet, um den effektiven Prozessraum für Quirks zu bestimmen. Eine Versionszeichenfolge in Vierfach-Notation (Major.Minor.Build.Revision), wo Major nicht .0 Ja

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Übergeordnetes Element Beschreibung
Abhängigkeiten Deklariert andere Pakete, von denen ein Paket abhängig ist, um seine Software abzuschließen.

Beispiele

Um den Satz von APIs zu zielen, die als "universelle Gerätefamilie" bezeichnet werden (was bedeutet, dass Ihre App auf allen Geräten ausgeführt wird), geben Sie einfach an, dass eine Gerätefamilie wie im folgenden Beispiel angegeben wird. Sie können weiterhin adaptiven Code schreiben, um APIs außerhalb der universellen Gerätefamilie zu erleichtern, wenn Ihre App auf Geräten in bestimmten Gerätefamilien ausgeführt wird. Versionen 10.0.x.0 und 10.0.y.0 können natürlich den gleichen Wert sein.

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

Hinweis

Wenn Sie auf "Windows.Universal" mit "MinVersion" und "MaxVersionTested" abzielen, die auf Version 10.0.0.0 festgelegt ist, verwendet Ihre App die in der Ziel-Min-Version und der Zielversion der Projektdatei angegebenen Versionen. Wenn Sie "Windows.Universal" mit "MinVersion" und "MaxVersionTested" verwenden, die auf einen anderen Wert als 10.0.0.0 festgelegt ist, zielt die App auf die angegebene "MinVersion" und "MaxVersionTested" anstelle der in der Projektdatei angegebenen Werte ab.

Alle untergeordneten Gerätefamilien "abgeleitet" (d. h. sie enthalten) die Gruppe "universelle Gerätefamilie" von APIs. So bedeutet eine untergeordnete Gerätefamilie "universelle plus andere untergeordnete Geräte-familienspezifische APIs". Wenn Sie auf eine untergeordnete Gerätefamilie abzielen, müssen Sie keine universelle Erwähnung geben. In diesem nächsten Beispiel zielt die App auf die Gruppe der APIs ab, die als "mobile Gerätefamilie" bezeichnet werden, und daher nur auf Geräten ausgeführt werden, die die Gruppe der mobilen Gerätefamilie von APIs (mobile Geräte) implementieren. Ersetzen Sie "Mobile" durch "Desktop", "Xbox", "Holographic", "IoT" oder "IoTHeadless", z. B. wenn Sie eine andere Gerätefamilie anzielen möchten.

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

Hinweis

Wenn die App auf eine andere Gerätefamilie als "Windows.Universal" ausgerichtet ist, muss die "MinVersion" und "MaxVersionTested" ordnungsgemäß für die Gerätefamilie angegeben werden, die gezielt ist.

Legen Sie zum Ziel der Xbox-Gerätefamilie das Name-Attribut auf "Windows.Xbox" fest. Beachten Sie, dass die Xbox-Gerätefamilie auf mindestens 10.0.14393.0 festgelegt werden muss.

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

Wenn Ihre App speziell für HoloLens erstellt wird und auf anderen Plattformen nicht unterstützt wird, geben Sie die Zielgerätfamilie "Windows.Holographic" an.

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

Wenn Ihre App ausschließlich auf die Windows 10 Team Edition ausgerichtet ist, legen Sie das Name-Attribut auf "Windows.Team" fest. Dies wird häufig für Microsoft Surface Hub Geräte verwendet.

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

Wenn Sie auf die IoT Core-Plattform abzielen möchten, legen Sie das Name-Attribut auf "Windows.IoT" fest. Verwenden Sie für eine kopflose IoT-App "Windows.IoTHeadless".

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

Hinweis

Derzeit sind Apps für IoT oder IoTHeadless nicht im App Store gültig und sollten nur für Entwicklungszwecke verwendet werden.

In diesem Beispiel zielt die App auf die Familien mobiler und Desktopgeräte ab. Folglich kann die App auf mobilen Geräten oder auf Desktopgeräten ausgeführt werden, aber keine anderen. Beachten Sie, dass die App adaptiven Code verwenden muss, um eine API aufzurufen, die sich nicht im universellen Gerätefamiliensatz von APIs befindet (es sei denn, die API wird von beiden Gerätefamilien freigegeben).

<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 diesem letzten Beispiel zielt die App auf die universelle Gerätefamilie ab (daher wird sie standardmäßig auf allen Geräten mit der angegebenen Mindestversion ausgeführt). Die Ausnahme ist, dass für Geräte, die die Familie mobiler Geräte implementieren, die App mindestens Version 10.0.m.0 benötigt, um vorhanden zu sein. Dies zeigt, wie Sie angeben, dass Sie keine Versionen von untergeordneten Gerätefamilien vor einer angegebenen Mindestversion unterstützen, auch wenn sich dies von der version unterscheidet, die Sie für den allgemeinen Fall unterstützen (der universelle Gerätefamilienfall). Beachten Sie auch den MaxVersionTested-Wert für die Abhängigkeit der Mobilen Gerätefamilie im Beispiel. Wo z > n ausgeführt wird, wird die App auf Version 10.0.z.0 eines mobilen Geräts ausgeführt, aber es wird 10.0.0.n.0-Versionverhalten der Plattform auf dieser Version auftreten.

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

Anforderungen

Anforderung Wert
Namespace http://schemas.microsoft.com/appx/manifest/foundation/windows10