Erstellen und installieren Sie ein Paket

Artikel
10/15/2018

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

Lab 1b: Hinzufügen einer App zu Ihrem Image

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.