Condividi tramite

Controllo delle immagini

  • Articolo

Quando si esegue BuildWSKImg, vengono generati diversi file insieme all'immagine del sistema operativo Factory flashable. Due di questi file contengono informazioni sui componenti inclusi in un'immagine del sistema operativo Factory. È possibile usare questi file per controllare il contenuto di un'immagine predefinita. Questi file si trovano nella cartella di output dell'immagine del sistema operativo Factory:

File Descrizione
<imagename>.DeviceDB.xml Inventario di tutti i componenti del sistema operativo
<imageame>.BSPDB.xml Inventario di tutti i componenti personalizzati OEM
<imageame>.WCOSCustomizationReport.xml Informazioni sui pacchetti di personalizzazione in un'immagine

Questi nomi di file avranno lo stesso nome dell'immagine con cui vengono generati, ma con estensioni di file diverse. Ad esempio:

  • FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.DeviceDB.xml
  • FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.BSPDB.xml
  • FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.WCOSCustomizationReport.xml

DeviceDB.xml

DeviceDB.xml file contengono informazioni su tutti i pacchetti del sistema operativo (pacchetti forniti da Microsoft e inclusi in WSK) inclusi in un'immagine. I pacchetti aggiunti a un'immagine dipendono da ciò che viene specificato nel file OEMInput (Image Configuration) usato per generare un'immagine del sistema operativo Factory. Le informazioni in DeviceDB.xml includono:

  • Funzionalità selezionate in un'immagine
  • I pacchetti del sistema operativo, forniti da Microsoft e inclusi in WSK, che costituiscono un'immagine specificata. Le informazioni sui pacchetti del sistema operativo includono:
    • ID pacchetto del sistema operativo
    • Versioni del pacchetto del sistema operativo

Quando si usa questo file per controllare il contenuto dell'immagine, basare il controllo sui pacchetti elencati. I pacchetti offrono una granularità maggiore rispetto alle funzionalità e i pacchetti dietro una funzionalità potrebbero cambiare dalla versione alla versione.

Nome file di esempio: FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.DeviceDB.xml

DeviceDB.xml di esempio

Si tratta di un file di DeviceDB.xml parziale che mostra i pacchetti del sistema operativo inclusi nell'immagine.

<?xml version="1.0" encoding="utf-8"?>
<CompDB xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" CreatedDate="2019-04-15T17:00:53.0428689Z" Revision="1" SchemaVersion="1.2" Product="FactoryOS" BuildID="737b6f27-951a-1b5e-f0ae-0e9b8924999b" BuildInfo="rs_prerelease.18865.1000.190322-1503" OSVersion="10.0.18865.1000" BuildArch="AMD64" ReleaseType="Test" Type="Device" BSPBuildID="00000000-0000-0000-0000-000000000000" xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate">
<Tags Type="Device">
  <Tag Name="UpdateType" Value="Canonical" />
</Tags>
<Features>
    <Feature Type="MobileFeature" FeatureID="BASE" FMID="WCPFM" Group="Microsoft">
      <Packages>
        <Package ID="Microsoft.FactoryOS.WindowsCoreProductionFM~31bf3856ad364e35~AMD64~~" FIP="true" PackageType="FeaturePackage" />
      </Packages>
    </Feature>
    <Feature Type="MobileFeature" FeatureID="MS_WCOS_DEVICEPORTAL" FMID="WCPFM" Group="Microsoft">
      <Packages>
        <Package ID="WindowsDevicePortal-WCOS-Package~31bf3856ad364e35~AMD64~~" PackageType="FeaturePackage" />
        <Package ID="WindowsDevicePortal-WCOS-Package_en-us~31bf3856ad364e35~AMD64~en-us~" PackageType="FeaturePackage" />
        <Package ID="Microsoft.FactoryOS.MS_WCOS_DEVICEPORTAL.WCPFM.FIP~31bf3856ad364e35~amd64~~" FIP="true" PackageType="FeaturePackage" />
      </Packages>
    </Feature>

Ogni pacchetto del sistema operativo è elencato in questo file dal relativo PackageID. Oltre all'ID pacchetto, alcuni pacchetti includono informazioni aggiuntive, ad esempio dimensioni e versione installate:

    <Package ID="Microsoft-OneCore-SS-Boot-Package~31bf3856ad364e35~AMD64~~" Partition="mainos" PublicKeyToken="31bf3856ad364e35" InstalledSize="278039" Version="10.0.18865.1000">
      <Payload />
    </Package>

BSPDB.xml

BSPDB.xml file contengono informazioni sulle personalizzazioni OEM incluse in un'immagine del sistema operativo factory, tra cui:

  • Driver personalizzati aggiunti dall'OEM
    • Elencato nella <Packages> sezione
    • Include informazioni sui driver installati, incluse le versioni e le dimensioni
  • Archiviare le app incluse nell'immagine
    • Elencato nella <AppxPackages> sezione
    • Include informazioni sulle app di Store installate
    • Elenca le dipendenze installate

    Nota

    Anche le app che vengono fornite con WSK sono considerate personalizzazioni OEM e sono elencate in questo file. Questo è dovuto al fatto che i prodotti del sistema operativo Factory non includono app per impostazione predefinita e qualsiasi app inclusa in un'immagine è stata scelta da un OEM per l'inclusione in un'immagine.

Quando si usa questo file per controllare il contenuto dell'immagine, basare il controllo sui pacchetti elencati. I pacchetti offrono una granularità maggiore rispetto alle funzionalità e i pacchetti dietro una funzionalità potrebbero cambiare dalla versione alla versione.

Nome file di esempio: FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.BSPDB.xml

File di esempio BSPDB.xml

Il frammento di codice seguente illustra come vengono visualizzati i driver installati e le app installate nel file BSPDB.xml. I driver e le app sono separati in due sezioni diverse, una contenente e una contenente <Packages><AppxPackages>.

<?xml version="1.0" encoding="utf-8"?>
<CompDB xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" CreatedDate="2019-04-15T17:00:53.0428689Z" Revision="1" SchemaVersion="1.3" Product="FactoryOS" BuildID="737b6f27-951a-1b5e-f0ae-0e9b8924999b" BuildInfo="rs_prerelease.18865.1000.190322-1503" OSVersion="10.0.18865.1000" BuildArch="AMD64" ReleaseType="Test" Type="BSP" BSPVersion="" BSPProductName="Factory OS.BSP." xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate">
  <Tags Type="BSP">
    <Tag Name="UpdateType" Value="Canonical" />
  </Tags>
  <Features>
    <Feature Type="DriverSet" FeatureID="BASE-DRIVERSET "Group="OEM" />
  </Features>
  <Packages>
      <Package ID="Microsoft-universalblender.inf" Partition="BSP" OwnerType="OEM" InstalledSize="42703" CompressedSize="26212" Type="DriverPackage" Version="19.7.8.216">
        <Payload />
      </Package>
  </Package>
...
  <AppX>
    <AppXPackages>
      <Package OwnerType="OEM" AppXPackageType="AppXFramework" FullName="Microsoft.VCLibs.140.00_14.0.26706.0_x64__8wekyb3d8bbwe" FamilyName="Microsoft.VCLibs.140.00_8wekyb3d8bbwe">
        <Payload>
          <PayloadItem PayloadSize="848261" Path="Appx\Frameworks\Microsoft.VCLibs.x64.14.00.appx" PayloadType="Canonical" />
        </Payload>
      </Package>
...
    </AppXPackages>
  </AppX>

WCOSCustomizationReport.xml

WCOSCustomizationReport contiene informazioni rilevanti sui pacchetti di personalizzazione OEM inclusi in un'immagine, relativi ai pacchetti del sistema operativo Microsoft inclusi nell'immagine.

Il report include elementi per:

  • Personalizzazioni applicabili , personalizzazioni in cui è presente il pacchetto del sistema operativo che espone la personalizzazione.
  • Personalizzazioni inapplicabili, personalizzazioni in cui il pacchetto del sistema operativo che espone la personalizzazione non è presente.
  • Tutte le personalizzazioni disponibili, tutte le personalizzazioni disponibili nell'immagine. Se vengono rilevate personalizzazioni inapplicabili nell'immagine, il report registra un avviso per ognuno di essi.

Per le personalizzazioni create dall'OEM, il valore di ogni personalizzazione viene visualizzato nel log per tutte le impostazioni del Registro di sistema (stringhe, numeri e così via), ma non le impostazioni del tipo di file.

È possibile disabilitare la creazione di questo report per ridurre il tempo di creazione dell'immagine. Per disabilitare la creazione del report, dall'ambiente del kit di sistema Windows impostare la DISABLE_CUSTOMIZATION_REPORT variabile su 1 prima di eseguire BuildWSKImage:

DISABLE_CUSTOMIZATION_REPORT=1

Impostazioni di personalizzazione avanzate

Per i file di personalizzazione delle impostazioni specificati usando il -advanced parametro, le impostazioni non verranno visualizzate nella sezione "Tutte le personalizzazioni disponibili" del log. Verranno tuttavia visualizzate nella sezione "Personalizzazioni applicabili".

WCOSCustomizationReport.xml di esempio

<?xml version="1.0" encoding="utf-8"?>
<WCOSCustomizationReport xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate">
  <ApplicableCustomizationsAuthored>
    <Customization FeatureArea="Cellular" Name="OEM COSA Provisioning package" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableCommandPromptPage" Value="1" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableFileTransferPage" Value="1" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableManageTasklistsPage" Value="1" />
    <Customization FeatureArea="FactoryProduct" Name="HideMouseCursor" Value="1" />
    <Customization FeatureArea="OOBE" Name="OOBE_Assets" />
    <Customization FeatureArea="TextInput" Name="InputPanelImageCustomization" />
  </ApplicableCustomizationsAuthored>
  <InapplicableCustomizationsAuthored>
    <Customization FeatureArea="DisplayEnhancement" Name="DefaultAdaptiveColorAdaptationStrength" Value="66" />
    <Customization FeatureArea="DisplayEnhancement" Name="DefaultBatterySaverBrightnessMultiplier" Value="99" />
    <Customization FeatureArea="DisplayEnhancement" Name="IsAdaptiveColorOnByDefault" Value="1" />
  </InapplicableCustomizationsAuthored>
  <AllAvailableCustomizationsInThisImage>
    <Customization FeatureArea="Cellular" Name="OEM COSA Provisioning package" />
    <Customization FeatureArea="DeviceLayout" Name="SplitLayoutFile" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableCommandPromptPage" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableFileTransferPage" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableManageTasklistsPage" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableNetworkAccess" />
    <Customization FeatureArea="FactoryOrchestrator" Name="DisableUWPAppsPage" />
    <Customization FeatureArea="FactoryProduct" Name="BackgroundImagePath" />
    <Customization FeatureArea="FactoryProduct" Name="DisableSSHUser" />
    <Customization FeatureArea="FactoryProduct" Name="HideMouseCursor" />
    <Customization FeatureArea="FactoryProduct" Name="OEMVersion" />
    <Customization FeatureArea="FactoryProduct" Name="SSHPassword" />
    <Customization FeatureArea="FactoryProduct" Name="SSHUsername" />
    <Customization FeatureArea="FactoryProduct" Name="UWPLaunchOnBoot" />
    <Customization FeatureArea="OOBE" Name="OOBE_Assets" />
    <Customization FeatureArea="Start" Name="PrimaryOEMApps" />
    <Customization FeatureArea="Start" Name="SecondaryOEMApps" />
    <Customization FeatureArea="TextInput" Name="InputPanelImageCustomization" />
    <Customization FeatureArea="Theme" Name="DefaultBackgroundImage" />
    <Customization FeatureArea="Theme" Name="OEMBackgrounds" />
    <Customization FeatureArea="Theme" Name="SystemUsesLightTheme" />
  </AllAvailableCustomizationsInThisImage>
</WCOSCustomizationReport>