Partager via

Configurer les paramètres

  • Article

Cette rubrique décrit comment configurer les personnalisations des paramètres classiques pour vos images Factory OS. Ces paramètres seront inclus dans une image et s’appliqueront à tous les appareils flashés avec l’image.

Générer un fichier de personnalisation des paramètres

Utilisez le CreateWSKCustomizationsXML script dans le WSK pour générer un fichier de personnalisation des paramètres :

  1. Montez l’ISO WSK et ouvrez l’environnement Windows System Kit en tant qu’administrateur :

    D:\SetWSKImagGenEnv.cmd

  2. Définissez votre espace de travail comme racine de l’espace de travail :

    cd c:\workspace
SetWSKWorkspaceRoot.cmd

  3. Générez un fichier XML de personnalisation :

    CreateWSKCustomizationsXML

    • Vous pouvez éventuellement créer un ensemble de fichiers XML de personnalisation en ajoutant l’option -categorize. Cela génère un ensemble de fichiers XML de personnalisation, divisés par catégorie :

      CreateWSKCustomizationsXML -Categorize

    • Vous pouvez également séparer manuellement chaque XML de personnalisation, à condition que les fichiers XML de personnalisation que vous créez ne contiennent pas le même <FeatureArea> répété dans plus d’un XML de personnalisation.

    CreateWSKCustomizationsXML tire profit du fichier de configuration de l’espace de travail pour réduire le nombre de paramètres requis. Les paramètres optionnels suivants sont disponibles :

    Paramètres Options
    -Categorize Divise le CustomizationXML en plusieurs fichiers, un fichier par personnalisation. Si cette option n’est pas utilisée, un seul fichier de personnalisation volumineux sera créé.
    -OutputFolder Spécifie le dossier où le XML de personnalisation est créé

    Remarque

    Ce script écrasera tout fichier XML de personnalisation existant dans le répertoire de sortie. Si vous avez un fichier XML de personnalisation existant, sauvegardez-le avant d’exécuter ce script ou utilisez l’option -OutputFolder pour spécifier un dossier de sortie différent.

  4. Après l’exécution du script, vous aurez un ou plusieurs fichiers de configuration des paramètres dans votre espace de travail, dans %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.

Personnalisez votre fichier de personnalisation des paramètres

  1. Ouvrez votre fichier de personnalisation des paramètres dans un éditeur de texte.

  2. Définissez les attributs dans l’élément <Identity> :

    <Identity OwnerName="OEMName" ReleaseType="Test" />
    Attribut Description
    OwnerName Le nom de l’entité créant l’image
    ReleaseType Cela doit correspondre à ReleaseType l’élément OEMinput de l’image. La valeur valide est : Test. Voir ci-dessous pour savoir comment choisir la valeur correcte.

  3. Configurez les paramètres. Chaque paramètre se trouve dans un élément XML appelé <Customization>. Voici à quoi ressemble un élément <Customization> :

    <Customization Name="SplitLayoutFile">
  <ReadOnlyMetadata Description="OEM/SV-owned split layout file. (File must be named DeviceLayoutOEM.xml)" Type="FILE" DefaultValue="" SupportedExtensions="xml" />
  <Value />
</Customization>

    Cet exemple montre divers attributs pour le paramètre qui couvrent les informations sur le paramètre et les valeurs possibles. Il contient également un élément vide nommé <Value>, que vous utiliserez pour configurer le paramètre.

  4. Personnalisez un paramètre en modifiant les éléments <Value> des paramètres que vous souhaitez personnaliser. Lorsque vous avez terminé, enregistrez le fichier XML.

    L’extrait ci-dessous montre le paramètre SplitLayoutFile rempli avec le chemin vers le fichier DeviceLayoutOEM.xml.

    <Customization Name="SplitLayoutFile">
  <ReadOnlyMetadata Description="OEM/SV-owned split layout file. (File must be named DeviceLayoutOEM.xml)" Type="FILE" DefaultValue="" SupportedExtensions="xml" />
  <Value>%WSKWorkspaceRoot%\OEMCustomization\DeviceLayout\DeviceLayoutOEM.xml</Value>
</Customization>

Générez des packages de personnalisation des paramètres et ajoutez-les à votre fichier OEMInput

Remarque

Pour des tests de personnalisation plus rapides, une fois que vous avez généré vos packages de personnalisation, vous pouvez les ajouter directement à une image de test.

  1. Ouvrez l’environnement Windows System Kit en tant qu’administrateur

  2. Définissez la racine de votre espace de travail :

    cd c:\workspace
SetWSKWorkspaceRoot.cmd

  3. Le script CreateWSKCustomizationsFM dans le WSK génère des packages de paramètres et un manifeste de fonctionnalité de personnalisation des paramètres qui inclut les packages de paramètres. Le script ajoute ensuite le manifeste de fonctionnalité de personnalisation à votre fichier OEMInput. Par défaut, CreateWSKCustomizationsFM traitera tous les fichiers XML de personnalisation d’un dossier %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML de l’espace de travail.

    CreateWSKCustomizationsFM

    Remarque

    Cette commande n’accepte plus les paramètres -OEMInput, -OEMName ou -Architecture.

    • Si vous avez créé un ensemble de fichiers de personnalisation catégorisés, utilisez l’option -customizationXML pour indiquer le dossier où vos fichiers XML de personnalisation sont enregistrés. Par exemple :

      CreateWSKCustomizationsFM -customizationXML %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML

    CreateWSKCustomizationsFM tire profit du fichier de configuration de l’espace de travail pour réduire le nombre de paramètres requis. Vous pouvez utiliser les paramètres optionnels suivants avec CreateWSKCustomizationsFM :

    Paramètre Options
    -OEMPackagesFolder Spécifie le chemin du dossier où vos packages de personnalisation sont stockés. Tous les packages de personnalisation de ce dossier seront inclus dans le manifeste de fonctionnalité. Le chemin par défaut est %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.
    -Version Permet d’ajouter un numéro de version aux noms de packages. Son format est xxxx.y.z.z. La valeur par défaut est 1000.0.0.0.
    -FMFile Permet de spécifier le chemin du fichier manifeste de fonctionnalité de personnalisation qui définit vos paramètres personnalisés. Ce FM est ajouté à votre fichier OEMInput afin que les paramètres soient inclus dans votre image. La valeur par défaut est %WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml.
    -CustomizationXML Chemin vers un fichier CustomizationXML ou un dossier contenant des fichiers de personnalisation. Si vous spécifiez un chemin de dossier, tous les fichiers XML de personnalisation des paramètres seront traités et produiront un seul FM des paramètres. Si cette option n’est pas spécifiée, le chemin par défaut est %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.xml.

  4. Vérifiez que votre fichier OEMCustomizationsFM.xml se trouve dans votre fichier OEMInput. Vous le trouverez dans l’élément <AdditionalFMs> :

    <AdditionalFMs>
...
  <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml</AdditionalFM>
  <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml</AdditionalFM>
  <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml</AdditionalFM>
</AdditionalFMs>

  5. Générez une image. Lorsque vous générez une image, les paramètres que vous avez configurés seront définis dans votre image.

    Remarque

    Il est possible d’ajouter directement des packages de personnalisation aux images pour une itération plus rapide lors des tests. Pour plus d’informations, consultez la section Patch d’une image Factory OS pour les tests.

Schéma de fichier de personnalisation des paramètres

Les fichiers de personnalisation des paramètres sont composés de plusieurs éléments qui catégorisent les paramètres en différents groupes. Les paramètres de chaque groupe sont liés. Chaque paramètre a des attributs qui montrent comment chaque paramètre peut être configuré. Pour configurer un paramètre, vous ajoutez une valeur dans l’élément <Value> du paramètre que vous souhaitez personnaliser.

<?xml version="1.0" encoding="utf-8"?>
<CustomizationFile xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" SchemaVersion="1.0" BuildArch=" " Product=" " BuildInfo=" " xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate">
  <Identity OwnerName="" ReleaseType="" />
  <Categories>
    <Category Name="Default">
      <FeatureAreas>
        <FeatureArea Name="Area1">
          <Customizations>
            <Customization Name="Example1">
              <ReadOnlyMetadata Description="Attributes in this element describe values for configuring this setting" Type="REG_DWORD" DefaultValue="1" Minimum="0" Maximum="1" />
              <Value />
            </Customization>
            <Customization Name="Example2">
              <ReadOnlyMetadata Description="Set the value element to configure settings" Type="REG_SZ" DefaultValue="" />
              <Value />
            </Customization>
          </Customizations>
        </FeatureArea>
      </FeatureAreas>
    </Category>
    <Category Name="Category2">
      <FeatureAreas>
        <FeatureArea Name="Area2">
          <Customizations>
            <Customization Name="Example3">
              <ReadOnlyMetadata Description="Set the value element to configure settings" Type="REG_SZ" DefaultValue="" />
              <Value />
            </Customization>
          </Customizations>
        </FeatureArea>
      </FeatureAreas>
    </Category>
  </Categories>
</CustomizationFile>

Vérifiez les paramètres dans une image

Lorsque vous générez une image, le dossier de sortie de votre espace de travail comprend un journal contenant des informations sur les paramètres. Consultez WCOSCustomizationReport.xml pour plus d’informations.