Erstellen und installieren Sie ein Paket
Pakete sind die Bausteine von Windows 10 IoT Core. Von Gerätetreibern bis hin zu Systemdateien muss jede Komponente für die Installation auf einem Gerät gepackt werden. Pakete sind die kleinsten wartbaren Einheiten auf dem Gerät.
Schritt 1: Richten Sie sich ein
Installieren der Tools
Einrichten der Umgebung
- Starten
IoTCorePShell.cmd
(dieser startet in der Eingabeaufforderung mit erhöhten Rechten) - Erstellen Sie einen neuen Arbeitsbereich mit
new-ws C:\MyWorkspace <oemname> <arch>
Um Ihr eigenes Image (FFU) zu erstellen, befolgen Sie die im Lab „Erstellen eines Basisimages“ im IoT-Herstellungsleitfaden beschriebenen Schritte.
Schritt 2: Erstellen Sie ein neues Paket
Erstellen Sie eine Paketdefinitions-XML-Datei (.wm.xml-Datei) und geben Sie die Dateien und Registrierungsschlüssel an, die Sie hinzufügen möchten. Weitere Informationen finden Sie unter Universelles Windows-OEM-Paketschema.
Erstellen Sie das Paket:
buildpkg filename.wm.xml
. Die .cab-Datei wird im Build-Verzeichnis erstellt<workspace>\Build\<arch>\pkgs
.
Erstellen Sie ein Paket mit Dateien und Registrierungsschlüsseln
Nachfolgend finden Sie ein Beispiel für die Angabe von Dateien und Registrierungsschlüsseln.
<?xml version="1.0" encoding="utf-8"?>
<identity xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
name="SUBNAME" namespace="COMPNAME" owner="Contoso" legacyName="Contoso.COMPNAME.SUBNAME"
xmlns="urn:Microsoft.CompPlat/ManifestSchema.v1.00">
<onecorePackageInfo
targetPartition="MainOS"
releaseType="Production"
ownerType="OEM" />
<regKeys>
<regKey
keyName="$(hklm.software)\Contoso\Test">
<regValue name="StringValue" type="REG_SZ" value="Test string" />
<regValue name="DWordValue" type="REG_DWORD" value="0x12AB34CD" />
<regValue name="BinaryValue" type="REG_BINARY" value="12ABCDEF" />
</regKey>
<regKey
keyName="$(hklm.software)\Contoso\EmptyKey" />
</regKeys>
<files>
<file
destinationDir="$(runtime.system32)"
source="filename.txt" />
<file
destinationDir="$(runtime.bootDrive)\OEMInstall"
source="filename2.txt"
name="filename2.txt" />
</files>
</identity>
Erstellen Sie ein Appx-Paket
Verwenden Sie Add-IoTAppxPackage, um die Datei .wm.xml für eine bestimmte AppX-Datei zu generieren. Dieses Tool erwartet die appx-Abhängigkeiten im Unterverzeichnis namens "dependencies" in dem Ordner, der die appx-Datei enthält.
Add-IoTAppxPackage HelloWorld.appx fga Appx.HelloWorld
(or) newappxpkg HelloWorld.appx fga Appx.HelloWorld
New-IoTCabPackage Appx.HelloWorld
(or) buildpkg Appx.HelloWorld
fga
legt die appx als Vordergrund-Start-App fest, bgt
legt die appx als Hintergrundaufgabe fest und none
überspringt die Startkonfiguration.
Informationen zu älteren Befehlszeilentools finden Sie unter newappxpkg.cmd
Siehe Appx.IoTCoreDefaultApp als Beispiel.
Wenn Sie mehrere Anwendungen installieren müssen, die mit demselben Zertifikat signiert sind, können Sie das Zertifikat zusammen mit einer App hinzufügen und für die verbleibenden Apps können Sie das Hinzufügen des Zertifikats mit dem Flag skipcert überspringen.
newappxpkg AnotherApp.appx none Appx.AnotherApp skipcert
Weitere Informationen
Erstellen eines Treiberpakets
Das Treiberpaket enthält die Verweise (InfSource) auf die Inf-Datei für den Treiber. Sie können die .wm.xml-Treiberdatei manuell erstellen oder Add-IoTDriverPackage verwenden, das Paket-XML basierend auf der INF-Eingabedatei generiert.
Add-IoTDriverPackage C:\Mydriver\GPIO.inf MyDriver.GPIO
(or) newdrvpkg C:\Mydriver\GPIO.inf MyDriver.GPIO
New-IoTCabPackage MyDriver.GPIO
(or) buildpkg MyDriver.GPIO
Verwenden Sie für das ältere Befehlszeilentool inf2cab.command, um die Paket-XML-Datei und auch die CAB-Datei direkt durch internen buildpkg.cmd
Aufruf zu erstellen.
Hinweis
Windows IoT Core unterstützt nur Universal Inf.
Weitere Informationen
Schritt 3: Auf dem Gerät installieren
- Verbinden Sie sich mit dem Gerät (mit SSH oder mit Powershell)
- Kopieren Sie die
<filename>.cab
Datei auf das Gerät in ein Verzeichnis, beispielsweise C:\OemInstall - Initiieren Sie das Staging des Pakets mit
applyupdate -stage C:\OemInstall\<filename>.cab
. Beachten Sie, dass dieser Schritt für jedes Paket wiederholt wird, wenn Sie mehrere Pakete installieren müssen. - Committen Sie die Pakete mit
applyupdate -commit
.
Hinweis
Sie können das Cab auch mithilfe der Windows Update-> CAB-Installationsoption im Windows Device Portal installieren. Das Gerät wird in das aktualisierte Betriebssystem (Zahnräder) neu gestartet, um die Pakete zu installieren, und wird erneut zum Hauptbetriebssystem neu gestartet. Dieser Vorgang kann einige Minuten dauern.