建立並安裝套件

套件是Windows 10 IoT 核心版的建置組塊。 從設備磁碟機到系統檔案,每個元件都必須封裝在裝置上安裝。 套件是裝置上最小的可維護單位。

步驟 1:設定

安裝工具

  1. Windows ADK) (Windows 評定與部署套件
  2. IoT 核心版 ADK 附加元件

設定環境

  • 啟動 (此啟動 IoTCorePShell.cmd 會在提升許可權的提示字元中啟動)
  • 使用 建立新的工作區 new-ws C:\MyWorkspace <oemname> <arch>

若要建立您自己的映射 (FFU) ,請遵循 IoT 製造指南中實驗室中所述的步驟。

步驟 2:建立新的套件

  1. 建立 套件定義 xml 檔案 (.wm.xml 檔案) ,並指定您要新增的檔案和註冊金鑰。 如需詳細資訊,請參閱 Windows 通用 OEM 套件架構

  2. 建置套件: buildpkg filename.wm.xml 。 .cab檔案將會在組建目錄中 <workspace>\Build\<arch>\pkgs 建立。

使用檔案和註冊金鑰建立套件

以下是指定檔案和註冊金鑰的範例。

<?xml version="1.0" encoding="utf-8"?>
<identity xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    name="SUBNAME" namespace="COMPNAME" owner="Contoso" legacyName="Contoso.COMPNAME.SUBNAME" 
    xmlns="urn:Microsoft.CompPlat/ManifestSchema.v1.00">
    <onecorePackageInfo
        targetPartition="MainOS"
        releaseType="Production"
        ownerType="OEM" />
    <regKeys>
        <regKey
            keyName="$(hklm.software)\Contoso\Test">
            <regValue name="StringValue" type="REG_SZ" value="Test string" />
            <regValue name="DWordValue" type="REG_DWORD" value="0x12AB34CD" />
            <regValue name="BinaryValue" type="REG_BINARY" value="12ABCDEF" />
        </regKey>
        <regKey
            keyName="$(hklm.software)\Contoso\EmptyKey" />
    </regKeys>
    <files>
        <file
            destinationDir="$(runtime.system32)"
            source="filename.txt" />
        <file
            destinationDir="$(runtime.bootDrive)\OEMInstall"
            source="filename2.txt"
            name="filename2.txt" />
    </files>
</identity>

建立 Appx 套件

使用 Add-IoTAppxPackage 為指定的 appx 檔案產生 .wm.xml 檔案。 此工具預期 appx 檔案包含 appx 檔案之資料夾中名為 「dependencies」 的子目錄中的 appx 相依性。

Add-IoTAppxPackage HelloWorld.appx fga Appx.HelloWorld
(or) newappxpkg HelloWorld.appx fga Appx.HelloWorld
New-IoTCabPackage Appx.HelloWorld
(or) buildpkg Appx.HelloWorld

fga 會將 appx 設定為前景啟動應用程式、 bgt 將 appx 設定為背景工作,並 none 略過啟動設定。 如需較舊的命令列工具,請參閱 newappxpkg.cmd

請參閱 Appx.IoTCoreDefaultApp 作為範例。

當您必須安裝使用相同憑證簽署的多個應用程式時,您可以新增憑證以及一個應用程式,並針對其餘的應用程式,使用 skipcert 旗標略過新增憑證。

newappxpkg AnotherApp.appx none Appx.AnotherApp skipcert

另請參閱

建立驅動程式套件

驅動程式套件包含驅動程式的 Inf 檔案 (InfSource) 參考。 您可以手動撰寫驅動程式 .wm.xml 檔案,或使用 Add-IoTDriverPackage ,根據輸入 inf 檔案產生封裝 xml。

Add-IoTDriverPackage C:\Mydriver\GPIO.inf MyDriver.GPIO
(or) newdrvpkg C:\Mydriver\GPIO.inf MyDriver.GPIO
New-IoTCabPackage MyDriver.GPIO
(or) buildpkg MyDriver.GPIO

針對較舊的命令列工具,使用 inf2cab.cmd 會建立套件 xml 檔案,並透過在內部叫 buildpkg.cmd 用來直接建置 cab 檔案。

注意

Windows IoT 核心版僅支援通用 Inf。

另請參閱

步驟 3:在裝置上安裝


  • 使用 SSH或使用Powershell) 連線到裝置 (
  • <filename>.cab 檔案複製到裝置,例如 C:\OemInstall
  • 使用 applyupdate -stage C:\OemInstall\<filename>.cab 起始封裝的預備。 請注意,當您有多個要安裝的套件時,每個套件都會重複此步驟。
  • 使用 applyupdate -commit 認可套件。

注意

您也可以在 Windows Device Portal 中使用Windows Update > CAB 安裝選項來安裝 cab。 裝置會重新開機至更新 OS (顯示安裝套件) 齒輪,並再次重新開機至主要 OS。 此程序可能需要幾分鐘的時間。