Freigeben über

Konfigurieren von Einstellungen

  • Artikel

In diesem Thema wird beschrieben, wie Sie klassische Einstellungsanpassungen für Ihre Factory OS-Images konfigurieren. Diese Einstellungen werden in ein Image aufgenommen und gelten für alle Geräte, die mit dem Image geflasht werden.

Generieren einer Einstellungsanpassungsdatei

Verwenden Sie das CreateWSKCustomizationsXML-Skript in der WSK, um eine Datei zur Anpassung der Einstellungen zu erstellen:

  1. Montieren Sie das WSK-ISO und öffnen Sie die Windows System Kit-Umgebung als Administrator:

    D:\SetWSKImagGenEnv.cmd

  2. Legen Sie Ihren Arbeitsbereich als Stammverzeichnis des Arbeitsbereichs fest:

    cd c:\workspace
SetWSKWorkspaceRoot.cmd

  3. Erzeugen Sie eine Anpassungs-XML-Datei:

    CreateWSKCustomizationsXML

    • Sie können wahlweise einen Satz von Anpassungs-XML-Dateien erstellen, indem Sie die Option -categorize hinzufügen. Dadurch wird eine Reihe von XML-Anpassungsdateien generiert, die nach Kategorie unterteilt sind:

      CreateWSKCustomizationsXML -Categorize

    • Sie können auch jede Anpassungs-XML manuell weiter trennen, vorausgesetzt, die von Ihnen erstellten Anpassungs-XML-Dateien enthalten nicht dasselbe <FeatureArea>, das in mehr als einer Anpassungs-XML wiederholt wird.

    CreateWSKCustomizationsXML nutzt die Workspace-Konfigurationsdatei, um die Anzahl der erforderlichen Parameter zu verringern. Die folgenden optionalen Parameter sind verfügbar:

    Parameter Optionen
    -Kategorisieren Teilt die CustomizationXML in mehrere Dateien auf, eine Datei pro Personalisierung. Wenn diese Option nicht verwendet wird, wird eine große Anpassungsdatei erstellt
    -OutputFolder Gibt den Ordner an, in dem die Anpassungs-XML erstellt wird

    Hinweis

    Dieses Skript überschreibt jede vorhandene Anpassungs-XML-Datei im Ausgabeverzeichnis. Falls Sie eine bestehende XML-Anpassungsdatei haben, sichern Sie diese entweder vor der Ausführung dieses Skripts oder verwenden Sie die Option -OutputFolder, um einen anderen Ausgabeordner anzugeben.

  4. Wenn das Skript ausgeführt wird, haben Sie eine oder mehrere Einstellungskonfigurationsdateien in Ihrem Arbeitsbereich, in %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.

Passen Sie Ihre Anpassungsdatei für die Einstellungen an

  1. Öffnen Sie die Datei zur Anpassung der Einstellungen in einem Texteditor.

  2. Legen Sie die Attribute im <Identity>-Element fest:

    <Identity OwnerName="OEMName" ReleaseType="Test" />
    attribute Beschreibung
    OwnerName Der Name der Entität, die das Image erstellt
    ReleaseType Diese sollte mit dem ReleaseType OEMinput-Element des Images übereinstimmen. Der gültige Wert ist: Test. Weitere Informationen zum Auswählen des richtigen Werts finden Sie unten.

  3. Konfigurieren Sie die Einstellungen. Jede Einstellung befindet sich in einem XML-Element namens <Customization>. So sieht ein Element <Customization> aus:

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

    In diesem Beispiel werden verschiedene Attribute für die Einstellung gezeigt, die Informationen über die Einstellung und mögliche Werte enthalten. Es enthält auch ein leeres Element namens <Value>, das Sie zum Konfigurieren der Einstellung verwenden werden.

  4. Passen Sie eine Einstellung an, indem Sie die <Value>-Elemente der Einstellungen ändern, die Sie anpassen möchten. Wenn Sie fertig sind, speichern Sie die XML-Datei.

    Das folgende Beispiel zeigt dieSplitLayoutFile-Einstellung, die mit dem Pfad zur DeviceLayoutOEM.xml-Datei gefüllt ist.

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

Erzeugen Sie Pakete zur Anpassung der Einstellungen und fügen Sie sie zu Ihrer OEMInput-Datei hinzu

Hinweis

Um die Anpassungen schneller zu testen, können Sie Ihre Anpassungspakete nach der Erstellung direkt zu einem Testimage hinzufügen.

  1. Öffnen Sie die Windows System Kit-Umgebung als Administrator

  2. Legen Sie das Stammverzeichnis Ihres Arbeitsbereichs fest:

    cd c:\workspace
SetWSKWorkspaceRoot.cmd

  3. Das Skript CreateWSKCustomizationsFM im WSK generiert Einstellungenpakete und ein Featuremanifest zum Anpassen von Einstellungen, das die Einstellungspakete enthält. Das Skript fügt dann das Manifest der Anpassungsfunktion zu Ihrer OEMInput-Datei hinzu. Standardmäßig verarbeitet CreateWSKCustomizationsFM alle Anpassungs-XML-Dateien im %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML-Ordner des Arbeitsbereichs.

    CreateWSKCustomizationsFM

    Hinweis

    Dieser Befehl akzeptiert nicht mehr die Parameter -OEMInput, -OEMName, oder -Architecture.

    • Wenn Sie eine Reihe von kategorisierten Anpassungsdateien erstellt haben, verwenden Sie die Option -customizationXML, um auf den Ordner zu verweisen, in dem Ihre Anpassungs-XML-Dateien gespeichert sind. Zum Beispiel:

      CreateWSKCustomizationsFM -customizationXML %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML

    CreateWSKCustomizationsFM nutzt die Workspace-Konfigurationsdatei, um die Anzahl der erforderlichen Parameter zu verringern. Sie können die folgenden optionalen Parameter mit CreateWSKCustomizationsFM verwenden:

    Parameter Optionen
    -OEMPackagesFolder Geben Sie den Ordnerpfad an, in dem Ihre Anpassungspakete gespeichert sind. Alle Anpassungspakete in diesem Ordner werden in das Featuremanifest aufgenommen. Der Standardpfad ist %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.
    -Version Ermöglicht das Hinzufügen einer Versionsnummer, die an Paketnamen angefügt wird. Das Format lautet xxxx.y.z.z. Der Standardwert ist 1000.0.0.0.
    -FMFile Ermöglicht es Ihnen, den Pfad der Manifestdatei der Anpassungsfunktion anzugeben, in der Ihre benutzerdefinierten Einstellungen definiert sind. Dieses FM wird zu Ihrer OEMInput-Datei hinzugefügt, so dass die Einstellungen in Ihr Image übernommen werden. Der Standardwert ist %WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml.
    -CustomizationXML Pfad zu einer CustomizationXML-Datei oder einem Ordner, der Anpassungsdateien enthält. Wenn Sie den Pfad eines Ordners angeben, werden alle xml-Dateien mit den Anpassungseinstellungen verarbeitet und ein einziges FM mit den Einstellungen ausgegeben. Wenn diese Option nicht angegeben ist, lautet der Standardpfad %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.xml.

  4. Vergewissern Sie sich, dass sich Ihre Datei OEMCustomizationsFM.xml in Ihrer OEMInput-Datei befindet. Sie finden es im <AdditionalFMs>-Element:

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

  5. Generieren eines Images. Wenn Sie ein Image generieren, werden die von Ihnen konfigurierten Einstellungen in Ihrem Image festgelegt.

    Hinweis

    Es ist möglich, Anpassungspakete direkt zu Images hinzuzufügen, damit Sie beim Testen schneller iterieren können. Weitere Informationen finden Sie unter Patchen eines Factory OS-Images zum Testen.

Schema der Einstellungsanpassungsdatei

Die Einstellungsdateien bestehen aus mehreren Elementen, die die Einstellungen in verschiedene Gruppen einteilen. Die Einstellungen innerhalb jeder Gruppe sind miteinander verbunden. Jede Einstellung hat Attribute, die zeigen, wie die jeweilige Einstellung konfiguriert werden kann. Um eine Einstellung zu konfigurieren, fügen Sie einen Wert in das <Value>-Element der Einstellung ein, die Sie anpassen möchten.

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

Prüfen Sie die Einstellungen in einem Image

Wenn Sie ein Image generieren, enthält Ihr Arbeitsbereich-Ordner ein Protokoll, das Informationen über die Einstellungen enthält. Weitere Informationen finden Sie unter WCOSCustomizationReport.xml.