Schritt 2: Erstellen von Gerätemetadaten für Ihre UWP-Geräte-App

Artikel
03/08/2024

device app workflow, step 2.

In diesem Thema wird beschrieben, wie Sie den Assistenten für die Erstellung von Gerätemetadaten verwenden, um neue Gerätemetadaten zu erstellen, die Ihre UWP-Geräte-App einem Gerät ordnet. Der Assistent kann auch eine StoreManifest.xml Datei erstellen, die Sie möglicherweise im nächsten Schritt zu Ihrer App hinzufügen müssen.

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

Um den Assistenten zum Erstellen von Gerätemetadaten zu verwenden, müssen Sie Microsoft Visual Studio Professional, Microsoft Visual Studio Ultimate oder das eigenständige SDK für Windows 8.1 installieren, bevor Sie die Schritte in diesem Thema ausführen. Beim Installieren von Microsoft Visual Studio Express für Windows wird eine Version des SDK installiert, die den Assistenten nicht enthält.

Erstellen neuer Gerätemetadaten

Der Assistent für die Erstellung von Gerätemetadaten wird verwendet, um neue Gerätemetadaten zu erstellen.

Erstellen neuer Gerätemetadaten

Starten Sie den Assistenten für die Erstellung von Gerätedaten aus %ProgramFiles(x86)%\Windows Kits\8.1\bin\x86, indem Sie auf DeviceMetadataWizard.exe doppelklicken.
Klicken Sie auf Neue Gerätemetadaten.
Klicken Sie auf der Seite Metadatenpakettyp auswählen auf UWP-Geräte-App-Metadaten und dann auf Weiter.
Wählen Sie auf der Seite Gerätekategorien auswählen die Gerätekategorien aus, die Ihrem Gerät zugewiesen werden sollen. Ein Gerät kann zu mehreren Gerätekategorien gehören, aber nur eine primäre Kategorie kann zugewiesen werden. Klicken Sie auf Weiter.
Wählen Sie auf der Seite Gebietsschema angeben mindestens ein Gebietsschema aus, das dem Gerätemetadatenpaket zugeordnet werden soll. Sie können auch ein Standardgebietsschema festlegen, das verwendet wird, wenn ein gebietsschemaspezifisches Paket auf dem Computer nicht verfügbar ist. Klicken Sie auf Weiter.
Geben Sie auf der Seite Beschreiben Sie das Gerät die Informationen ein, die Endbenutzern angezeigt werden, die Ihr Gerät anschließen. Für jedes Gebietsschema ist ein Modellname und ein Hersteller erforderlich.
Fügen Sie auf der Seite Hardwareinformationen angeben mindestens eine Hardware-ID und eine Modell-ID hinzu. Die Hardware-ID sollte die Anbieter-ID für Ihr Unternehmen enthalten. Die Modell-ID ist eine GUID und ist die empfohlene Methode zum Zuordnen von Gerätemetadaten zu Geräten, die eine Modell-ID unterstützen. Klicken Sie auf Weiter.
Auf der Seite UWP-Geräte-App-Informationen angeben:
- Wenn Sie die automatische Installation für Ihre Geräte-App aktivieren oder das Kamera- oder Druckererlebnis erweitern möchten (was eine automatische Installation erfordert), geben Sie die Informationen zur Microsoft Store-App in das Feld UWP-Geräte-App ein. Klicken Sie auf UWP-App-Manifestdatei importieren, um automatisch den Paketnamen, Herausgebernamen und UWP app ID einzugeben.
  
  Warnung
  
  Es ist wichtig zu berücksichtigen, dass das Feature für die automatische Installation dem Benutzer beim Installieren der App keine Benachrichtigung bereitstellt. Einige Benutzer finden diese Erfahrung möglicherweise verwirrend und frustrierend und geben Ihrer App eine schlechte Bewertung.
- Wenn Ihre App für Druckerbenachrichtigungen registriert ist, füllen Sie das Benachrichtigungshandlerfeld aus. Geben Sie in der Ereignis-ID den Namen des Druckereignishandlers ein. Geben Sie in "Event Asset" den Namen der Datei ein, in der sich dieser Code befindet.
- Wenn Sie Ihre App als privilegierte App angeben möchten, geben Sie diese Informationen in das Feld Privilegierte Anwendung ein. Mit der Bezeichnung privilegierter Apps kann eine UWP-Geräte-App Geräteupdates ausführen, z. B. Firmwareupdates. Darüber hinaus können OEMs und Komponentenlieferanten Apps für interne Geräte entwickeln.
Wenn Sie alle Details zur automatischen Installation und privilegierten Apps angegeben haben, klicken Sie auf Weiter.
Auf der Seite Windows-Einstellungen festlegen können Sie konfigurieren, ob das Gerät im Geräte-Manager angezeigt wird, wenn die Verbindung getrennt wird, und wie das Gerät auf eine AutoPlay-Aktivierung reagieren soll.

Wenn Sie eine App als Standard-AutoPlay-Handler für Ihr Gerät festlegen möchten, wählen Sie im Feld AutoPlay-Handler die Option UWP-Geräte-App verwenden aus. Sie können eine beliebige UWP-App oder UWP-Geräte-App auswählen, diese App muss jedoch die AutoPlay-Aktivierung für Ihr Gerät übernehmen und die entsprechende Erlebnis-ID im App-Paketmanifest angeben (wie unter AutoPlay für UWP-Geräte-Apps beschrieben).
- Paketname: Im App-Paketmanifest ist dies das Name-Attribut des Identity-Elements.
- Name des Veröffentlichers: Im App-Paketmanifest ist das Name-Attribut des Identity-Elements.
- App-ID: Im App-Paketmanifest ist dies das ID-Attribut des Anwendungselements.
- Verb: Dies ist der Bezeichner für die Aktivierung von AutoPlay. Ihre App verwendet sie, um festzustellen, ob die Aktivierung von Ihrem Gerät stammt. Für die Einstellung „Verb“ kannst du einen beliebigen Wert verwenden. Die einzige Ausnahme ist open, dieser Wert ist reserviert.
- AutoPlay Ereignistyp: Lassen Sie dies als Gerät. In den Gerätemetadaten gibt der Assistent automatisch die Erfahrungs-ID an, die Ihrer UWP-Geräte-App zugeordnet ist.
Wenn Sie möchten, dass andere Apps als AutoPlay-Handler für Ihr Gerät fungieren, wählen Sie AutoPlay für registrierte Apps aktivieren.

Weitere Informationen zu AutoPlay finden Sie unter AutoPlay für UWP-Geräte-Apps.
Wenn Sie bereit zum Fortfahren sind, klicken Sie auf Weiter.
Stellen Sie auf der Seite Überprüfen des Gerätemetadatenpakets sicher, dass alle Einstellungen korrekt sind. Wenn Sie möchten, dass dieses Gerätemetadatenpaket im lokalen Metadatenspeicher verfügbar ist, aktivieren Sie das Kontrollkästchen Gerätemetadatenpaket in den Metadatenspeicher auf dem lokalen Computer kopieren und klicken Sie dann auf Speichern.
Wenn Sie bereit sind, Ihr Gerätemetadatenpaket zu übermitteln, oder wenn Sie es bearbeiten müssen, müssen Sie die .devicemanifest-ms-Datei verwenden. Die .devicemetadata-ms-Datei sollte nur verwendet werden, um Gerätemetadaten lokal zu testen.