Freigeben über


Schritt 1: Erstellen Sie eine UWP-Geräte-App

device app workflow, step 1.

In diesem Thema wird der grundlegende Prozess zum Erstellen einer UWP-Geräte-App mithilfe von Microsoft Visual Studio beschrieben. Erfahren Sie mehr über die Aufgaben, die für alle UWP-Geräte-Apps gemeinsam sind.

Eine UWP-Geräte-App ist eine spezielle UWP-App, die Gerätehersteller als Ergänzung zu ihrem internen oder Peripheriegerät erstellen. Mithilfe von Gerätemetadaten können Geräte-Apps privilegierte Vorgänge ausführen und automatisch installiert werden, wenn ein Gerät angeschlossen wird. Weitere Informationen zu UWP-Geräte-Apps finden Sie unter Lernen Sie UWP-Geräte-Apps kennen.

Dieses Thema ist Teil einer Schritt-für-Schritt-Reihe. Eine Einführung finden Sie unter Schritt-für-Schritt-Anleitung zum Erstellen einer UWP-Geräte-App .

Voraussetzungen

In dieser schrittweisen Anleitung wird davon ausgegangen, dass Sie ein UWP-App-Projekt erstellt haben und dass alle erforderlichen Gerätetreiber bereits vorhanden sind.

Erstellen des Microsoft Store-App-Projekts

Bevor Sie beginnen können, müssen Sie Visual Studio installiert und ein UWP-App-Projekt erstellt haben. Wenn Sie dies noch nicht getan haben, können Sie die Tools hier herunterladen. Informationen zu den ersten Schritten mit Microsoft Visual Studio finden Sie unter Entwickeln von UWP-Apps mit Visual Studio.

Anforderungen an Gerätetreiber

Einige UWP-Geräte-Apps und -APIs erfordern, dass Ihr Gerät einen von Microsoft bereitgestellten Treiber unterstützt oder dass Ihr Treiber ein bestimmtes Treibermodell unterstützt. In dieser Tabelle sind die Treiberanforderungen für einige Geräte-Apps und APIs aufgeführt.

Geräte-App oder -API Treiberinformationen
UWP-Geräte-Apps für Kameras Der Kameratreiber muss das AvStream-Treibermodell verwenden. Weitere Informationen zum AvStream-Treibermodell finden Sie in der AVStream-Übersicht im Windows Driver Kit. Eine zusätzliche Komponente, die als Driver MFT (media foundation transform) bezeichnet wird, kann mit dem Treiberinstallationspaket bereitgestellt werden, um benutzerdefinierte Effekte für die Kamera bereitzustellen. Weitere Informationen finden Sie unter Windows Store-Geräte-Apps für Kameras.
UWP-Geräte-Apps für Drucker Drucker müssen den v4-Druckertreiber verwenden. Weitere Informationen finden Sie unter Entwickeln des v4-Drucktreibers .
USB-APIs Um die Windows-Runtime Windows.Devices.Usb-APIszu verwenden, muss Ihr Gerät mit dem Winusb.sys Treiber kompatibel sein.
Human Interface Device (HID)-APIs Die HID-APIs sind für die Verwendung über USB, Bluetooth, Bluetooth Smart und die I2C-Transporte ausgelegt. Um die Windows-Runtime Windows.Devices.HumanInterfaceDevice-APIs zu verwenden, muss Ihr Gerät mit dem HIDClass.sys Treiber und dem treiber kompatibel sein, der vom Transport benötigt wird. Weitere Informationen finden Sie unter HID-Architektur.
Bluetooth GATT-APIs Um die Windows-Runtime Bluetooth GATT-APIs, Windows.Devices.Bluetooth.GenericAttributeProfile, zu verwenden, muss Ihr Gerät mit dem BthLEEnum.sys Treiber kompatibel sein.
Bluetooth-RFCOMM-APIs Um die Windows-Runtime Bluetooth RFCOMM-APIs, Windows.Devices.Bluetooth.Rfcomm, zu verwenden, muss Ihr Gerät mit den Treibern Rfcomm.sys und BthEnum.sys kompatibel sein.

Wichtig

Der Gerätezugriff mit benutzerdefinierten Treibern erfordert eine Genehmigung von Microsoft. OEMs und IHVs, die den Gerätezugriff für ein spezielles Gerät mithilfe eines benutzerdefinierten Treibers implementieren möchten, sollten sich zunächst an ihren Microsoft-Ansprechpartner wenden, um ihr Szenario mit dem Windows Ecosystem-Team zu besprechen. Weitere Informationen finden Sie im Abschnitt „Benutzerdefiniertes Treiberzugriffsmodell“ im UWP-Geräte-App-Designleitfaden für spezielle PC-interne Geräte.

Erstellen Sie ein Microsoft Store-Konto

Ein Entwicklerkonto im Microsoft Store ist erforderlich. Sie benötigen den Herausgebernamen, wenn Sie das App-Manifest und die Gerätemetadaten in späteren Schritten erstellen. Sie können auch einen Namen für Ihre App reservieren, nachdem Sie ein Store-Profil erstellt haben.

Um ein Microsoft Store-Konto zu erstellen, gehen Sie zur UWP-Apps-Anmeldeseite und klicken auf Registrieren.

Wenn Sie den Anzeigenamen des Herausgebers eingeben, geben Sie den Namen ein, unter dem Ihre Apps im Microsoft Store aufgeführt werden sollen. Sie können diesen Namen erst ändern, wenn die Kontoüberprüfung abgeschlossen ist. Wählen Sie den Namen sorgfältig aus, da Kunden diesen Namen beim Durchsuchen sehen und Ihre Apps unter diesem Namen kennen.

Ordnen Sie Ihre App dem Microsoft Store zu.

Nachdem Sie ein Microsoft Store-Konto erstellt und einen Herausgebernamen ausgewählt haben, ordnen Sie Ihre App dem Microsoft Store zu. Dadurch werden die folgenden Werte automatisch in die lokale App-Paketmanifestdatei mit dem Namen "Package.appxmanifest" heruntergeladen.

  • Anzeigename des Pakets

  • Paketname

  • Herausgeber-ID

  • Publisher display name

Wenn Sie bereits Gerätemetadaten entwickelt haben, müssen Sie nach dem Zuordnen der App zum Microsoft Store die Gerätemetadaten mit den Werten aus dem App-Manifest aktualisieren.

Um Ihre App mit dem Microsoft Store zu verknüpfen

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt und wählen Sie dann Store > App mit Store verknüpfen.

  2. Klicken Sie im Dialogfeld Ihre App mit dem Microsoft Store verknüpfen auf Weiter. Sie werden aufgefordert, sich beim Microsoft Store anzumelden.

  3. Melden Sie sich auf der Anmeldeseite beim Microsoft Store an, und klicken Sie dann auf Weiter.

  4. Wählen Sie auf der Seite App-Name für dieses Paket auswählen den App-Namen aus, den Sie reserviert haben. Sie können auch auf Namen reservieren klicken, um zum Microsoft Store zu wechseln, um einen Namen zu reservieren.

  5. Nachdem ein App-Name ausgewählt wurde, klicken Sie auf Weiter.

  6. Überprüfen Sie auf der Zusammenfassungsseite die von Ihnen ausgewählten Werte. Wenn es gut aussieht, klicken Sie auf Zuordnen. Klicken Sie andernfalls auf Zurück, um zurückzugehen und alle Fehler zu beheben. Wenn Sie auf Zuordnen klicken, werden der Anzeigename des Herausgebers und andere Werte automatisch in das App-Paketmanifest heruntergeladen.

Überprüfen des App-Paketmanifests

Nachdem Sie Ihre App mit dem Microsoft Store verknüpft haben, überprüfen Sie das Paketmanifest Ihrer App, um festzustellen, ob der Anzeigename des Herausgebers und andere Werte wie erwartet eingefügt wurden. Stellen Sie sicher, dass der App-Titel und -Name eine starke Verbindung mit dem Gerät demonstrieren. Beachten Sie außerdem, dass nur eine App im App-Paket zulässig ist.

Überprüfen des App-Paketmanifests

  1. Doppelklicken Sie im Projektmappen-Explorer auf die Datei package.appxmanifest. Dadurch wird der Maniest Designer geöffnet. Der Manifest-Designer ist eine grafische Benutzeroberfläche für die zugrunde liegende XML-Datei.

  2. Nachdem die Datei im Manifest-Designer geöffnet wurde, klicken Sie auf die Registerkarte "Verpackung ", um die Informationen zu "Paket" und "Herausgeber" anzuzeigen.

    Wenn Sie die gleichen Informationen in XML anzeigen möchten, klicken Sie mit der rechten Maustaste auf package.appxmanifest und wählen Sie Öffnen mit > XML(Text)-Editor aus.

  3. Notieren Sie sich den Paketnamen, den Herausgebernamen und die App-ID. Sie benötigen sie für den nächsten Schritt, Schritt 2: Erstellen von Gerätemetadaten.

Auswählen eines Herausgeberzertifikats

Während Sie das App-Paketmanifest mit dem Manifest-Designer überprüfen, wählen Sie ein Herausgeberzertifikat aus, das dem Herausgebernamen im Manifest entspricht. Während der Manifest-Designer auf der Registerkarte Paketierung geöffnet ist, klicken Sie auf Zertifikat auswählen, um das entsprechende Zertifikat auszuwählen.

Entwickeln Ihrer UWP-Geräte-App

Berücksichtigen Sie beim Entwickeln Ihrer UWP-Geräte-App die folgenden Punkte.

Gerätefunktionen

Um auf Ihr Gerät zuzugreifen, müssen Sie möglicherweise eine Gerätefunktion im App-Paketmanifest angeben. Diese werden mit dem DeviceCapability-Element der Datei Package.appxmanifest im Projekt Ihrer App angegeben. Beachten Sie, dass einige Gerätefunktionen manuell angegeben werden müssen. Weitere Informationen finden Sie unter Angeben von Gerätefunktionen im Paketmanifest.

AutoPlay für UWP-Geräte-Apps

Die automatische Wiedergabe startet Ihre App standardmäßig, wenn Ihr Gerät angeschlossen ist. Um dieses Feature zu verwenden, müssen Sie das App-Paketmanifest und die Gerätemetadaten bearbeiten. Weitere Informationen finden Sie unter Automatische Wiedergabe für UWP-Geräte-Apps.

Synchronisieren oder Aktualisieren Ihres Geräts im Hintergrund

Sie können Ihr Gerät über eine UWP-Geräte-App synchronisieren oder aktualisieren, indem Sie Hintergrundaufgaben für Geräte verwenden. Um dieses Feature zu verwenden, müssen Sie Ihre App als privilegierte App in den Gerätemetadaten angeben. Weitere Informationen finden Sie unter Gerätesynchronisierung und -update für UWP-Geräte-Apps.

Weitere Informationen

UWP-Geräte-Apps für Drucker: Druckerstatus anzeigen und die Druckeinstellungen erweitern. Ab Windows 8.1 kann Ihre App auch Druckaufträge verwalten und Druckerwartungen durchführen.

UWP-Geräte-Apps für Kameras: Erweitern Sie die Kameraoptionen. Ihre App kann auch benutzerdefinierte Effekte mit einem Treiber-MFT bereitstellen.

Integrieren von Geräten: Erfahren Sie mehr über Windows-Runtime-APIs für USB, HID, Bluetooth, Scanning und vieles mehr.

UWP-Geräte-Apps für interne Geräte: Erfahren Sie, wie OEMs Geräte-Apps für PC-interne Geräte schreiben können.

Verwenden Sie den Zertifizierungskit für Windows-Apps

Um Ihrer App die besten Chancen auf eine Zertifizierung zu geben, validieren und testen Sie sie auf Ihrem Computer, bevor Sie sie zur Zertifizierung und Auflistung im Microsoft Store einreichen. Weitere Informationen finden Sie unter Zertifizierungskit für Windows-Apps.

Nächster Schritt

Schritt 2: Erstellen von Gerätemetadaten