Créer et installer un package

Article
10/15/2018

Les packages sont les blocs de construction de Windows 10 IoT Standard. Des pilotes de périphérique aux fichiers système, chaque composant doit être empaqueté pour être installé sur un appareil. Les packages sont les plus petites unités servicables sur l’appareil.

Étape 1 : Configurer

Installer les outils

Configurer votre environnement

Lancer IoTCorePShell.cmd ( celui-ci démarre dans l’invite avec élévation de privilèges )
Créer un espace de travail à l’aide de new-ws C:\MyWorkspace <oemname> <arch>

Pour créer votre propre image (FFU), suivez les étapes décrites dans le labo « Créer une image de base » dans le guide de fabrication IoT.

Étape 2 : Créer un package

Créez un fichier xml de définition de package (fichier .wm.xml) et spécifiez les fichiers et les clés reg que vous souhaitez ajouter. Pour plus d’informations, consultez Schéma de package OEM universel Windows.
Générez le package : buildpkg filename.wm.xml. Le fichier .cab sera créé dans le répertoire <workspace>\Build\<arch>\pkgsde build .

Créer un package avec des fichiers et des clés reg

Voici un exemple de spécification de fichiers et de clés reg.

<?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>

Créer un package Appx

Utilisez Add-IoTAppxPackage pour générer le fichier .wm.xml pour un fichier appx donné. Cet outil attend les dépendances appx dans le sous-répertoire nommé « dépendances » dans le dossier contenant le fichier appx.

Add-IoTAppxPackage HelloWorld.appx fga Appx.HelloWorld
(or) newappxpkg HelloWorld.appx fga Appx.HelloWorld
New-IoTCabPackage Appx.HelloWorld
(or) buildpkg Appx.HelloWorld

fga définit appx comme application de démarrage au premier plan, bgt définit l’appx comme tâche en arrière-plan et none ignore la configuration de démarrage. Pour l’outil de ligne de commande plus ancien, consultez newappxpkg.cmd

Consultez Appx.IoTCoreDefaultApp comme exemple.

Lorsque vous devez installer plusieurs applications signées avec le même certificat, vous pouvez ajouter le certificat avec une application. Pour les autres applications, vous pouvez ignorer l’ajout du certificat à l’aide de l’indicateur skipcert.

newappxpkg AnotherApp.appx none Appx.AnotherApp skipcert

Voir aussi

Labo 1b : ajouter une application à votre image

Créer un package de pilotes

Le package de pilotes contient les références (InfSource) au fichier Inf du pilote. Vous pouvez créer manuellement le fichier .wm.xml du pilote ou utiliser Add-IoTDriverPackage qui génère du xml de package en fonction du fichier inf d’entrée.

Add-IoTDriverPackage C:\Mydriver\GPIO.inf MyDriver.GPIO
(or) newdrvpkg C:\Mydriver\GPIO.inf MyDriver.GPIO
New-IoTCabPackage MyDriver.GPIO
(or) buildpkg MyDriver.GPIO

Pour l’outil de ligne de commande plus ancien, l’utilisation de inf2cab.cmd crée le fichier xml du package et génère également le fichier cab directement en appelant buildpkg.cmd en interne.

Notes

Windows IoT Core prend uniquement en charge Universal Inf.