Hinzufügen von Apps zu Ihrem Factory OS-Image

Das Windows System Kit enthält Skripts, um das Hinzufügen universeller Windows-Apps zu Ihren Factory OS-Images zu erleichtern. Diese Skripts erstellen oder aktualisieren automatisch eine Featuremanifestdatei basierend auf den Apps, die Sie einem Arbeitsbereich hinzufügen.

Informationen zum Hinzufügen von Apps zu einem bereits ausgeführten Bild finden Sie unter Über das Geräteportal verbinden.

Voraussetzungen

• Ein WSK-Arbeitsbereich
• Eine oder mehrere ordnungsgemäß verpackte universelle Windows-Apps

Erfassen Ihrer Apps

1. Sammeln Sie alle Ihre .msix, .msixbundles, .appx und .appxbundle-Dateien, einschließlich aller Abhängigkeits- und Lizenzdateien, für alle Architekturen, die Ihre App unterstützt (x64, x86 und arm) auf Ihrem Techniker-PC.

2. Speichern Sie die Apps im Standard-Apps-Ordner in Ihrem Arbeitsbereich, z. B.: C:\Workspace\Apps\ Wenn Ihre Apps sich jeweils in ihren eigenen Ordnern befinden, ist es OK, Unterordner zu verwenden. Die Skripts können Ihre Apps finden.

   Es ist auch OK, mehrere Apps zu haben, die dieselbe Abhängigkeitsdatei enthalten. Die Abhängigkeitsdatei wird nur einmal zum endgültigen Image hinzugefügt.

   In unserem Beispiel wird die Taschenrechner-App verwendet, die entlang des WSK als von Microsoft-bereitgestellte Universelle Windows-Plattform (UWP)-App gebündelt ist. Sie können die Apps aus UWP-App-Beispielen verwenden oder durch eigene Apps ersetzen.

Hinzufügen von Apps zum AppFM im Arbeitsbereich

Ihr Arbeitsbereich enthält einen leeren App-FM, der bereits in Ihrer OEMInput.xml-Datei enthalten ist. Verwenden Sie zum Hinzufügen von Apps zu einem Bild die Skripts im WSK, um Apps zum App-FM hinzuzufügen. Wenn Sie diesen FM nicht verwenden möchten und erfahren möchten, wie Sie einen neuen App-FM erstellen und in eine OEMInput.xml-Datei aufnehmen können, lesen Sie Erstellen eines neuen App-FM.

Hinzufügen von Apps zum App-FM Ihres Arbeitsbereichs:

1. Starten Sie die Windows System Kit-Buildumgebung als Administrator (z. B. aus der bereitgestellten WSK-ISO, klicken Sie mit der rechten Maustaste auf E:\SetImagGenEnv.cmd und klicken Sie dann auf Als Administrator ausführen.)

2. Navigieren Sie in der Windows System Kit-Buildumgebung zu Ihrem Arbeitsbereichsordner:

   cd c:\Workspace
   

3. Legen Sie ihre Arbeitsbereichsstammvariable so fest, dass sie auf die Umgebungsvariable „WSKWorkspaceRoot" verweist, um auf Ihren Arbeitsbereich zu verweisen.

   C:\Workspace\SetWSKWorkspaceRoot.cmd
   

4. Fügen Sie die Apps in Ihrem Arbeitsbereich zum enthaltenen App-FM hinzu: Verwenden Sie die Skripts im WSK, um Ihren App-FM zu aktualisieren, damit dieser die Apps in Ihrem Arbeitsbereich aufnimmt.

   Führen Sie das Skript UpdateWSKAppsFM aus, um alle Apps im Ordner „Arbeitsbereich-Apps" (%WSKWorkspaceRoot%\Apps) zu OEMAppsFM.xml hinzuzufügen. Alle in diesem FM aufgeführten Apps werden in Ihr Image aufgenommen.

   UpdateWSKAppsFM
   

   Wenn Sie keine Optionen angeben, aktualisiert das Skript die Datei %WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml, um alle Apps im Ordner "Apps" des Arbeitsbereichs aufzunehmen. Weitere Informationen finden Sie nachstehend unter UpdateWSKAppsFM-Syntax.

   Standardmäßig sind die Apps in allen Bilddesigns enthalten, aber Sie können App-Bezeichner hinzufügen und Apps als optional markieren , wenn Sie mehrere Bilddesigns mithilfe einer zentralen Gruppe von Sicherheiten erstellen.

   Wenn Sie Ihre Apps hinzufügen, entfernen oder aktualisieren, führen Sie diese erneut aus UpdateWSKAppsFM, um Änderungen zu Ihrem Featuremanifest hinzuzufügen. Es ist OK, wenn Sie andere Änderungen an Ihrem Featuremanifest vorgenommen haben, z. B. eine App als optional festgelegt haben. Das Skript wirkt sich auf diese Änderungen nicht aus.

Erstellen eines neuen App-FM

Sie können die Skripts im Windows System Kit verwenden, um ein neues App-FM zu erstellen:

Aus der Windows System Kit-Umgebung:

1. Platzieren Sie die Apps, die Sie in einen Ordner aufnehmen möchten.

2. Führen Sie das Skript CreateWSKAppsFM aus, um alle Apps in Ihren App-Ordner aufzunehmen. Geben Sie den Namen des neuen AppFM und Ihren Apps-Ordner an:

   CreateWSKAppsFM -fmfile %WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml -AppsFolder C:\NewApps
   

   Informationen zu Skriptoptionen finden Sie nachstehend unter CreateWSKAppsFM-Syntax.

   Dieses Skript erstellt beispielsweise eine neue Featuremanifestdatei, %WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml, die den Speicherort jeder App enthält.

   Standardmäßig sind die Apps in allen Bilddesigns enthalten, aber Sie können App-Bezeichner hinzufügen und Apps als optional markieren , wenn Sie mehrere Bilddesigns mithilfe einer zentralen Gruppe von Sicherheiten erstellen.

3. Fügen Sie den neuen App-FM zu Ihrer OEMInput.xml-Datei hinzu, indem Sie ihn als <AdditionalFM> hinzufügen:

   <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml</AdditionalFM>
   

4. Wenn Sie Ihre Apps hinzufügen, entfernen oder aktualisieren, führen Sie UpdateWSKAppsFM aus, um die Apps zu Ihrem Featuremanifest hinzuzufügen. Es ist OK, wenn Sie andere Änderungen an Ihrem Featuremanifest vorgenommen haben, z. B. eine App als optional festgelegt haben. Das Skript wirkt sich auf diese Änderungen nicht aus:

   UpdateWSKAppsFM -fmfile %WSKWorkspaceRoot%\FMFiles\NewOEMAppsFM.xml -AppsFolder C:\NewApps
   

Syntax von App-FM-Skripts

CreateWSKAppsFM Syntax

CreateWSKAppsFM {-FMFile: [path]} {-AppsFolder [Path]} {-IncludeWow}

UpdateWSKAppsFM syntax

UpdateWSKAppsFM {-FMFile: [path]} {-AppsFolder [Path]} {-IncludeWow}

Zugehörige Themen

• Hinzufügen von Treibern
• Ändern der optionalen Features
• Erstellen eines Images