TargetDeviceFamily (Windows 10)

Gibt die Gerätefamilie an, auf die Ihr Paket abzielt. Weitere Informationen zu Gerätefamilien finden Sie unter Programmieren 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

Attribute

Attribut BESCHREIBUNG Datentyp Erforderlich Standardwert
Name Der Name der Gerätefamilie, auf die Ihre App abzielt. Weitere Informationen zu den unterstützten Gerätefamiliennamen finden Sie im Abschnitt Beispiele . Eine alphanumerische Zeichenfolge, die Punkt- und Bindestrichzeichen enthalten kann. Ja
Minversion Die Mindestversion der Gerätefamilie, auf die Ihre App abzielt. Wird für die Anwendbarkeit zur Bereitstellungszeit verwendet. Wenn die Gerätefamilieversion des Systems niedriger als MinVersion ist, wird die App nicht als zutreffend betrachtet. Eine Versionszeichenfolge in vierfacher Notation (Major.Minor.Build.Revision), wobei Major nicht sein 0kann. Ja
MaxVersionTested Die maximale Version der Gerätefamilie, mit der Ihre App getestet wurde. Dies wird zur Laufzeit verwendet, um den effektiven Prozessraum für Macken zu bestimmen. Eine Versionszeichenfolge in vierfacher Notation (Major.Minor.Build.Revision), wobei Major nicht sein 0kann. Ja

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Übergeordnetes Element Beschreibung
Abhängigkeiten Deklariert andere Pakete, von denen ein Paket abhängig ist, um seine Software zu vervollständigen.

Beispiele

Um die gruppe von APIs, die als "universelle Gerätefamilie" (d. h. ihre App auf allen Geräten ausgeführt wird) zu verwenden, geben Sie einfach die eine Gerätefamilie an, wie im folgenden Beispiel dargestellt. Sie können weiterhin adaptiven Code schreiben, um APIs außerhalb der universellen Gerätefamilie zu beleuchten, wenn Ihre App auf Geräten in bestimmten Gerätefamilien ausgeführt wird. Die Versionen 10.0.x.0 und 10.0.y.0 können natürlich den gleichen Wert aufweisen.

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

Hinweis

Wenn Sie "Windows.Universal" als Ziel verwenden, wobei sowohl "MinVersion" als auch "MaxVersionTested" auf Version 10.0.0.0 festgelegt sind, verwendet Ihre App die versionen, die in der Zielversion und der Zielversion der Projektdatei angegeben sind. Wenn Sie "Windows.Universal" verwenden, wobei "MinVersion" und "MaxVersionTested" auf einen anderen Wert als 10.0.0.0 festgelegt sind, zielt die App auf die angegebenen "MinVersion" und "MaxVersionTested" anstelle der in der Projektdatei angegebenen Werte ab.

Alle untergeordneten Gerätefamilien "leiten" von (d. h. sie enthalten) den Satz von APIs für die "universelle Gerätefamilie". Daher impliziert eine untergeordnete Gerätefamilie "universelle und andere untergeordnete Gerätefamilie-spezifische APIs". Wenn Sie eine untergeordnete Gerätefamilie als Ziel verwenden, müssen Sie nicht universell Erwähnung. In diesem nächsten Beispiel zielt die App auf den Satz von APIs ab, die als "mobile Gerätefamilie" bezeichnet werden, und daher wird sie nur auf Geräten ausgeführt, die die Gruppe der APIs der mobilen Gerätefamilie (mobile Geräte) implementieren. Ersetzen Sie beispielsweise "Mobile" durch "Desktop", "Xbox", "Holographic", "IoT" oder "IoTHeadless", wenn Sie eine andere Gerätefamilie als Ziel verwenden 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" abzielt, müssen "MinVersion" und "MaxVersionTested" ordnungsgemäß für die Gerätefamilie angegeben werden, die als Ziel verwendet wird.

Um die Xbox-Gerätefamilie als Ziel festzulegen, legen Sie das Name-Attribut auf "Windows.Xbox" fest. Beachten Sie, dass minVersion auf mindestens 10.0.14393.0 festgelegt werden muss, um die Xbox-Gerätefamilie als Ziel zu verwenden.

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

Wenn Ihre App speziell für HoloLens erstellt und auf anderen Plattformen nicht unterstützt wird, geben Sie die Zielgerätefamilie "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 abzielt, 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 die IoT Core-Plattform als Ziel verwenden 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, die auf IoT oder IoTHeadless abzielen, im App Store nicht gültig und sollten nur für Entwicklungszwecke verwendet werden.

In diesem Beispiel richtet sich die App auf die Gerätefamilien mobiler Geräte und Desktopgeräte. Folglich kann die App auf mobilen Geräten oder auf Desktopgeräten ausgeführt werden, aber nicht auf anderen. Beachten Sie, dass die App adaptiven Code verwenden muss, um jede API aufzurufen, die sich nicht im Satz der universellen Gerätefamilie befindet (es sei denn, die API wird von beiden Gerätefamilien gemeinsam genutzt).

<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 (standardmäßig wird sie also auf allen Geräten mit der angegebenen Mindestversion ausgeführt). Die Ausnahme besteht darin, dass für Geräte, die die mobile Gerätefamilie implementieren, die App mindestens Version 10.0.m.0 benötigt, um vorhanden zu sein. So geben Sie an, dass Sie keine Versionen von untergeordneten Gerätefamilien vor einer angegebenen Mindestversion unterstützen, auch wenn dies von der version abweicht, die Sie für den allgemeinen Fall (die universelle Gerätefamilie) unterstützen. Beachten Sie auch den MaxVersionTested-Wert für die Abhängigkeit der Mobilen Gerätefamilie im Beispiel. Wenn z > n, wird die App in Version 10.0.z.0 eines mobilen Geräts ausgeführt, aber es wird ein 10.0.n.0-Version-Verhalten von 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>

Hinweise

Ein Paket hat nur Zugriff auf Betriebssystemverhalten bis zu <TargetDeviceFamily [...] MaxVersionTested="version">. Wenn der Wert eines Pakets MaxVersionTested also höher als die Version des Betriebssystems auf dem Zielcomputer ist, liegt möglicherweise das Betriebssystemverhalten vor, das vom Paket verstanden wird, aber vom Zielbetriebssystem nicht für das Paket verfügbar gemacht wird. Wenn das Zielbetriebssystem upgradest (näher an oder übereinstimmend), MaxVersionTestedwird potenziell das vom Paket verstandene Betriebssystemverhalten verfügbar, das zuvor nicht verfügbar war. Folglich verarbeitet das Betriebssystem das Paket erneut, um ein solches Verhalten zu erhellen .

Der Prozess, mit dem die Bereitstellung dieses Lichtszenarios ermöglicht, wird als ReIndexing bezeichnet.

Anforderungen

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