Erstellen von UWP-Geräte-Apps

Artikel
03/08/2024

Gerätehersteller können eine UWP-Geräte-App erstellen, die als Ergänzung zu ihrem Gerät dient. In diesem Thema werden die Komponenten einer UWP-Geräte-App, die grundlegenden Schritte zum Erstellen einer solchen und die Reihenfolge beschrieben, in der Sie Ihre App- und Gerätemetadaten an das Microsoft Store-Dashboard bzw. das Windows Dev Center-Hardware-Dashboard übermitteln müssen. Ausführlichere Informationen zu den einzelnen Schritten finden Sie unter Schrittweises Erstellen einer UWP-Geräte-App.

Die Bausteine

Auf der einfachsten Ebene ist eine UWP-Geräte-App eine UWP-App, die einem bestimmten Gerät über Gerätemetadaten zugeordnet ist. Es gibt vier Komponenten für eine UWP-Geräte-App: ein Gerät, eine App, ein Gerätemetadatenpaket und einen Gerätetreiber. Sie müssen keine Gerätemetadaten verwenden, um mithilfe der Geräteprotokoll-APIs (USB, HID, Bluetooth GATT und Bluetooth RFCOMM) auf ein Peripheriegerät zuzugreifen. Sie müssen jedoch Gerätemetadaten verwenden, um spezielle Features wie automatische Installation, AutoPlay und Geräteaktualisierung zu aktivieren.

Komponente	Beschreibung
Sicherungsmedium	Dies ist das physische Gerät. Peripheriegeräte sind außerhalb des PC-Gehäuses. Interne Geräte sind Geräte , die sich innerhalb oder in das PC-Gehäuse befinden oder integriert sind.
App	Eine UWP-Geräte-App ist eine UWP-App, die eine angepasste Benutzeroberfläche für das Gerät bietet, sodass der Benutzer auf die einzigartigen Features des Geräts zugreifen kann. Eine Geräte-App enthält eine Datei mit dem Namen StoreManifest.xml, die die Erfahrungs-ID angibt. Die Benutzeroberflächen-ID ist eine GUID, die ein Gerätemetadatenpaket eindeutig identifiziert.
Gerätemetadaten	Dies ist eine erweiterte Version eines Gerätemetadatenpakets, das Sie möglicherweise bereits für Windows 7 erstellt haben. In Windows 8.1 erstellt Gerätemetadaten eine Verknüpfung zwischen dem Gerät und der App. Dieser Link wird in der Erfahrungs-ID identifiziert. Zusätzlich zum UI-Inhalt für den PC (lokalisierbarer Modellname, Beschreibung und fotorealistische Symbole) gibt das Gerätemetadatenpaket die AutoPlay-Konfiguration an und welche App Zugriffsrechte auf das Gerät hat. Windows lädt Gerätemetadaten automatisch aus dem Windows-Metadaten-Internetdienst (WMIS) herunter.
Treiber	Alle UWP-Geräte-Apps verwenden indirekt Treiber für den Zugriff auf Geräte. Die in Windows 8.1 eingeführten Windows-Runtime-Geräteprotokoll-APIs verwenden beispielsweise Boxtreiber, damit Ihre App über USB, HID und Bluetooth kommunizieren kann. Weitere Informationen zu den von diesen APIs verwendeten Treibern finden Sie in Schritt 1: Erstellen einer UWP-Geräte-App.

Wichtig

Der Gerätezugriff mit benutzerdefinierten Treibern erfordert eine Genehmigung von Microsoft. Weitere Informationen finden Sie im UWP-Geräte-App-Designhandbuch für spezielle PC-interne Geräte.

Entwicklungsworkflow

Es gibt sechs Schritte zum Erstellen einer UWP-Geräte-App, vorausgesetzt, Sie haben Ihr Gerät bereits erstellt und alle erforderlichen Treiber an das Hardwaredashboard übermittelt. Klicken Sie auf die Links, um weitere Details zu den einzelnen Schritten anzuzeigen.

the device app development workflow.

Schritt 1: Erstellen Sie die App. Ordnen Sie Ihre App dem Microsoft Store zu, entwickeln Sie die App, und testen Sie sie.

Schritt 2: Erstellen der Gerätemetadaten Verwenden Sie den Assistenten zum Erstellen von Gerätemetadaten, um Ihre App Ihrem Gerät zuzuordnen, ein Gerätemetadatenpaket zu erstellen und eine StoreManifest.xml Datei zu erstellen (die die Benutzeroberflächen-ID angibt).

Schritt 3: Hinzufügen einer Erfahrungs-ID zur App Integrieren Sie die StoreManifest.xml-Datei in Ihre App.

Wenn Ihre App eine privilegierte App ist und nicht für die automatische Installation konfiguriert ist, ist Schritt 3 nicht erforderlich.

Schritt 4: Testen der Gerätemetadaten (lokal) Verwenden Sie den Assistenten zum Erstellen von Gerätemetadaten, um die Gerätemetadaten zu validieren und auf Ihrer lokalen Entwicklungsarbeitsstation bereitzustellen.

Schritt 5: Übermitteln Sie die App an das Microsoft Store-Dashboard. Verwenden Sie das Dashboard, um Verkaufsdetails zu bestätigen und Testern anzugeben, dass es sich bei der App um eine UWP-Geräte-App handelt.

Wenn Ihre App eine privilegierte App ist und nicht für die automatische Installation konfiguriert ist, können Sie Ihre App nach Schritt 6 an das Microsoft Store-Dashboard übermitteln. Weitere Informationen finden Sie unter Privilegierte App-Übermittlungssequenz.

Schritt 6: Übermitteln von Gerätemetadaten an das Windows Dev Center-Hardwaredashboard. Senden Sie Gerätemetadatenpakete manuell oder verwenden Sie den Gerätemetadaten-Erstellungsassistenten, um ein Massenübermittlungspaket zu erstellen, das Sie an das Hardware-Dashboard übermitteln können.

Standardübermittlungssequenz

Wenn Sie Ihre App- und Gerätemetadaten zum ersten Mal an die verschiedenen Dashboards übermitteln, müssen die Ereignisse in einer bestimmten Sequenz auftreten. In der folgenden Tabelle wird auch gezeigt, wann ein Gerätetreiber übermittelt werden soll, falls zutreffend.

Sequenz	Beschreibung	Bevor Sie fortfahren...
1	Übermitteln Sie den Gerätetreiber an das Hardware-Dashboard.	Warten Sie, bis der Treiber über Windows Update verfügbar ist.
2	Schritt 5: Übermitteln Sie die App an das Microsoft Store-Dashboard.	Warten Sie auf die Annahme, und bis die App im Microsoft Store live ist.
3	Übermitteln Sie den Gerätemetadaten an das Hardware-Dashboard. Die App muss sich im Microsoft Store befindet, bevor die Metadaten die Überprüfung im Hardware-Dashboard bestehen können.	Warten Sie 10 Tage auf Annahme und Verteilung.
4	Fertigstellen: Benutzer können von allen Features der Microsoft Store-Geräte-App profitieren. Beachten Sie, dass Geräte-App-Features wie automatische Installation, AutoPlay und Geräteaktualisierung erst funktionieren, wenn der Benutzer über die Gerätemetadaten und die App auf dem PC verfügt. Wenn für die App ein Treiber erforderlich ist, der nicht von Microsoft bereitgestellt wird, muss dieser Treiber auch vorhanden sein, damit die App funktioniert.

Sequenz der Privileged App-Übermittlung

In einigen Fällen müssen UWP-Geräte-Apps nicht im Microsoft Store live sein, bevor Sie die Gerätemetadaten übermitteln. Wenn Ihre UWP-Geräte-App:

Als privilegierte App angegeben ist.
Nicht für die automatische Installation konfiguriert ist

Wenn dies bei Ihrer App zutrifft, können Sie die Gerätemetadaten an das Hardwaredashboard übermitteln, bevor Sie Ihre UWP-Geräte-App an das Microsoft Store-Dashboard übermitteln. In solchen Fällen müssen Sie ihrer App nicht die Erfahrungs-ID hinzufügen; Die Angabe Ihrer App als privilegierte App in den Gerätemetadaten reicht aus, damit Berechtigungen wirksam werden.

UWP-Geräte-Apps für Drucker und Kameras werden automatisch installiert. Daher müssen diese Arten von UWP-Geräte-Apps der Standardübermittlungssequenz entsprechen und an den Microsoft Store übermittelt werden, bevor die Gerätemetadaten übermittelt werden.

Einschränkungen für UWP-Geräte-Apps

Gerätehersteller sind in der Anzahl der UWP-Apps beschränkt, die in Gerätemetadaten für die automatische Installation und die App-Berechtigungen angegeben werden können. Beispielsweise können Hersteller von Peripheriegeräten (IHVs) bis zu eine App einreichen, die für die automatische Installation konfiguriert ist, und bis zu eine App, die als privilegierte App angegeben ist. Ein IHV kann eine App übermitteln, die beide Einschränkungen oder zwei Apps erfüllt, wobei jede Besprechung nur eine der Einschränkungen erfüllt.

Wichtig

Es gibt keine Beschränkung auf die Gesamtzahl der UWP-Geräte-Apps, die ein Gerätehersteller an den Microsoft Store übermitteln kann; Diese Grenzwerte gelten nur für ein einzelnes Gerätemetadatenpaket.

Mobilfunkanbieter und OEMs haben unterschiedliche Grenzwerte für die Anzahl der Apps, die sie in Gerätemetadaten angeben können. Weitere Informationen erhalten OEMs, die sich an ihren Microsoft OEM-Vertreter wenden sollten.

In jedem Gerätemetadatenpaket gelten die folgenden Grenzwerte: