配置設定
本主題描述如何為您的 Factory OS 映像設定傳統設定自定義。 這些設定會包含在映像中,並會套用至映像閃爍的所有裝置。
- 請參閱 Factory OS 的可用設定,以查看 Factory OS 中可用的傳統設定。
產生設定自定義檔案
CreateWSKCustomizationsXML
使用 WSK 中的腳本來產生 [設定] 自訂檔案:
掛接 WSK ISO,並以系統管理員身分開啟 Windows 系統套件環境:
D:\SetWSKImagGenEnv.cmd
將您的工作區設定為工作區根目錄:
cd c:\workspace SetWSKWorkspaceRoot.cmd
產生自訂 XML 檔案:
CreateWSKCustomizationsXML
您可以藉由新增
-categorize
選項,選擇性地建立一組自定義 XML 檔案。 這會產生一組自定義 XML 檔案,除以類別:CreateWSKCustomizationsXML -Categorize
您也可以進一步個別自定義 XML,前提是您所建立的自定義 XML 檔案在多個自定義 XML 中沒有相同的
<FeatureArea>
重複。
CreateWSKCustomizationsXML
會 利用工作區組態檔來減少所需的參數數目。 下列選擇性參數可供使用:參數 選項。 -分類 將 CustomizationXML 分割成多個檔案,每個自定義一個檔案。 如果未使用此選項,將會建立一個大型自定義檔案 -OutputFolder 指定建立自訂 XML 的資料夾 注意
此文稿將會覆寫輸出目錄中任何現有的自定義 XML 檔案。 如果您有現有的自定義 XML 檔案,請在執行此腳本之前先備份它,或使用
-OutputFolder
選項來指定不同的輸出資料夾。腳本執行之後,您的工作區中將會有一或多個設定組態檔,在 中
%WSKWorkspaceRoot%\OEMCustomization\CustomizationXML
。
自訂您的設定自定義檔案
在文字編輯器中開啟您設定自定義檔案。
在 元素設定
<Identity>
屬性:<Identity OwnerName="OEMName" ReleaseType="Test" />
屬性 描述 OwnerName 建立映像的實體名稱 ReleaseType 這應該符合影像的 ReleaseType
OEMinput 元素。 有效值為:Test
。 請參閱下方以瞭解如何選擇正確的值。設定設定。 每個設定都位於名為
<Customization>
的 XML 元素中。 以下是<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>
此範例顯示設定的各種屬性,這些屬性涵蓋設定和可能值的相關信息。 它也有名為
<Value>
的空白元素,您將用來設定設定。修改您要自定義之設定的元素,
<Value>
以自訂設定。 完成時,請儲存 XML 檔案。- 若要查看處理站OS的所有可用設定,請參閱 Factory OS 可用設定。
下列代碼段顯示
SplitLayoutFile
填入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>
產生設定自定義套件,並將其新增至 OEMInput 檔案
注意
若要加快自定義測試的速度,一旦您產生自定義套件,即可 將它們直接新增至測試映像。
以系統管理員身分開啟 Windows System Kit 環境
設定工作區根目錄:
cd c:\workspace SetWSKWorkspaceRoot.cmd
CreateWSKCustomizationsFM
WSK 中的文稿會產生設定套件,以及包含設定套件的設定自定義功能指令清單。 然後,腳本會將自定義功能指令清單新增至您的 OEMInput 檔案。 根據預設,CreateWSKCustomizationsFM
將會處理工作區%WSKWorkspaceRoot%\OEMCustomization\CustomizationXML
資料夾的所有自定義 XML 檔案。CreateWSKCustomizationsFM
注意
此命令不再接受
-OEMInput
、-OEMName
或-Architecture
參數。如果您已建立一組分類的自定義檔案,請使用
-customizationXML
選項來指向儲存自定義 XML 檔案的資料夾。 例如:CreateWSKCustomizationsFM -customizationXML %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML
CreateWSKCustomizationsFM
會 利用工作區組態檔來減少所需的參數數目。 您可以使用下列選擇性參數搭配CreateWSKCustomizationsFM
:參數 選項。 -OEMPackagesFolder 指定儲存自定義套件的資料夾路徑。 此資料夾中的所有自定義套件都會包含在功能指令清單中。 預設路徑為 %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML
。-版本 允許新增附加至套件名稱的版本號碼。 格式為 xxxx.y.z.z
。 預設值為1000.0.0.0
。-FMFile 可讓您指定定義自訂設定的自訂功能指令清單檔路徑。 此 FM 會新增至 OEMInput 檔案,讓設定包含在映射中。 預設值為 %WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml
。-CustomizationXML 包含自定義檔案之 CustomizationXML 檔案或資料夾的路徑。 如果您指定資料夾路徑,則會處理所有自訂設定 xml 檔案,並輸出單一設定 FM。 如果未指定這個選項,預設路徑為 %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.xml
。確認您的OEMCustomizationsFM.xml檔案位於 OEMInput 檔案中。 您會在
<AdditionalFMs>
元素中找到它:<AdditionalFMs> ... <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml</AdditionalFM> <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml</AdditionalFM> <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml</AdditionalFM> </AdditionalFMs>
產生影像。 當您產生映像時,您設定的設定將會在映像中設定。
注意
在測試時,可以將自定義套件直接新增至映像,以加快反覆專案的速度。 如需詳細資訊,請參閱 修補處理站OS映像以進行測試 。
設定自定義檔案架構
設定自定義檔案是由數個元素所組成,這些元素會將設定分類為各種群組。 每個群組內的設定都相關。 每個設定都有屬性,顯示如何設定每個設定。 若要設定設定,您會將值新增至 <Value>
您想要自定義之設定的 元素。
<?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>
稽核映像中的設定
當您產生映像時,工作區輸出資料夾會包含包含設定相關信息的記錄檔。 如需詳細資訊,請參閱 WCOSCustomizationReport.xml 。