【Windows 10 IoT】为Win10 IoT镜像添加默认应用（树莓派）

 

【Windows 10 IoT】为Win10 IoT镜像添加默认应用（树莓派）

 
 
 

【Windows 10 IoT】为Win10 IoT镜像添加默认应用（树莓派）

   在Windows 10 IoT应用程序开发好之后，一般通过IoT WebManagement或者直接用vs将应用部署上去。并且执行命令iotstartup.exe add headed/headless AppxID，将应用设置为开机启动。但是，如果想基于一个开发板，量产某种硬件设备，这种方式肯定是不可行的。
    我们会想到，是否可以将我们的应用直接打包到镜像中，并设置成为开机自启的默认应用呢？当然可以。
    基本原理是这样的：IoT设备第一次启动时，会执行一个OEMCustomization.cmd脚本，安装指定目录下的appx应用并执行iotstartup.exe将其设置为startup应用。
    参考：[Add an app to your image][1]
 

用到的工具：

1. Windows Assessment and Deployment Kit (Windows ADK)    [http://go.microsoft.com/fwlink/?LinkId=526803][2]
2. Windows Driver Kit (WDK)             [http://go.microsoft.com/fwlink/p/?linkid=261797][3]
3. IoT Core ADK Add-Ons             [https://github.com/ms-iot/iot-adk-addonkit/][4]
4. Windows 10 IoT Core Dashboard    [http://go.microsoft.com/fwlink/p/?LinkId=708576][5]

上面这些工具，主要修改的是 IoT Core ADK Add-Ons。这个工具包中包含了用于打包一个ffu镜像的一系列脚本和xml模板。Tools文件夹下是一些打包boot相关、驱动、应用以及生成FFU的一些脚本。在Source-arm和Source-x86下的Products文件夹中，包含了一些设备样本。

例：
iot-adk-addonkit\Source-arm\Products\SampleA是树莓派2的sample；
iot-adk-addonkit\Source-arm\Products\SampleB是可以添加自定义驱动的树莓派2的sample；
iot-adk-addonkit\Source-x86\Products\SampleA是intel MBM的sample；
iot-adk-addonkit\Source-x86\Products\SampleB是可以添加自定义驱动的intel MBM的sample。

 

主要步骤：

 

1. 先后先当然是先build并打包你的应用程序。注意只生成对应平台的appx就可以了，不要生成appxbundle。

 

2. 将应用打包成cab包：

  1. 以管理员身份运行IoT Core ADK Add-Ons中的脚本：IoT-ADK-AddonKit\IoTCoreShell.cmd。选择对应的CPU平台：arm或者x86.
  2. 执行buildpkg all，这个命令会将IoT-ADK-AddonKit\Common和Source-arm(x86)\Packages目录下已有的Package文件夹打包成cab包。build成功后，我们可以在IoT-ADK-AddonKit\arm(x86)\pkgs目录下看到生成的cab包。
  3. 使用newappxpkg命令，为你的应用生成一个预打包的工作目录：
    newAppxPkg "..\HelloWorld\AppPackages\HelloWorld_1.0.0.0_ARM_Debug_Test\HelloWorld_1.0.0.0_ARM_Debug.appx" Appx.HelloWorld
    PS：不要把appx拷贝出来，因为newappxpkg命令会扫面appx所在目录下是否有dependency appx，如果有，会一同拷贝到工作目录与你的appx应用一起打包。一般是Microsoft.NET.Native.Framework、Microsoft.NET.Native.Runtime和Microsoft.VCLibs.ARM这三个依赖。
  4. 执行buildpkg Appx.HelloWorld命令，就可以将应用打包成cab包了。执行成功后，我们可以在IoT-ADK-AddonKit\arm(x86)\pkgs目录下找到OEM_NAME.Appx.HelloWorld.cab这个包（OEM_NAME是在setoem.cmd脚本中指定的）。
 

3. 修改feature manifest（以下简称FM）: IoT-ADK-AddonKit\Source-\Packages\OEMFM.xml

将appx应用打包成的cab包，添加到feature manifest中声明。格式如下：

 
  1. <?xml version="1.0"encoding="utf-8"?>
  2. <FeatureManifestxmlns: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">
  3. <BasePackages/>
  4. <Features>
  5. <OEM>
  6. <!-- Feature definitions below -->
  7. <PackageFilePath="%PKGBLD_DIR%"Name="%OEM_NAME%.Appx.Main.cab">
  8. <FeatureIDs>
  9. <FeatureID>OEM_AppxMain</FeatureID>
  10. </FeatureIDs>
  11. </PackageFile>
  12. <PackageFilePath="%PKGBLD_DIR%"Name="%OEM_NAME%.Appx.HelloWorld.cab">
  13. <FeatureIDs>
  14. <FeatureID>OEM_AppxHelloWorld</FeatureID>
  15. </FeatureIDs>
  16. </PackageFile>
  17. </OEM>
  18. <OEMFeatureGroups/>
  19. </Features>
  20. </FeatureManifest>
 

4. 更新配置文件 IoT-ADK-AddonKit\Source-\Products\ProductA\TestOEMInput.xml

添加步骤3中修改的feature manifest到AdditionalFM标签下：

 
  1. <AdditionalFMs>
  2. <AdditionalFM>%AKROOT%\FMFiles\arm\IoTUAPNonProductionPartnerShareFM.xml</AdditionalFM>
  3. <AdditionalFM>%AKROOT%\FMFiles\arm\IoTUAPRPi2FM.xml</AdditionalFM>
  4. <AdditionalFM>%AKROOT%\FMFiles\arm\RPi2FM.xml</AdditionalFM>
  5. <!--步骤3中修改的feature manifest-->
  6. <AdditionalFM>%SRC_DIR%\Packages\OEMFM.xml</AdditionalFM>
  7. <AdditionalFM>%COMMON_DIR%\Packages\OEMCommonFM.xml</AdditionalFM>
  8. </AdditionalFMs>

然后，将你的应用的featureID添加到标签下：

 
  1. <OEM>
  2. <Feature>RPI2_DRIVERS</Feature>
  3. <Feature>RPI2_DEVICE_TARGETINGINFO</Feature>
  4. <Feature>PRODUCTION</Feature>
  5. <Feature>OEM_CustomCmd</Feature>
  6. <Feature>OEM_AppxHelloWorld</Feature>
  7. </OEM>

注意：一个镜像中只能有一个默认的前台应用(startup headed app)，所以我们需要注释掉之前的默认app：IOT_BERTHA

 
  1. <Feature>IOT_ENABLE_TESTSIGNING</Feature>
  2. <Feature>IOT_DISABLE_UMCI</Feature>
  3. <Feature>IOT_CRT140</Feature>
  4. <!-- <Feature>IOT_BERTHA</Feature> -->
  5. <Feature>IOT_APP_TOOLKIT</Feature>
  6. <Feature>IOT_CP210x_MAKERDRIVER</Feature>
  7. <Feature>IOT_FTSER2K_MAKERDRIVER</Feature>

步骤3中的FM文件，相当于app cab包的声明，标识某个featureID所对应的cab包；只有在步骤4中的OEMInput文件中添加后相应的featureID后，打包程序才会将对应的cab包打包到镜像中。

 

5. 设置自动安装脚本

自动安装脚本位于：IoT-ADK-AddonKit\Source-\Products\SampleX\OEMCustomization.cmd，代码如下：

 
  1. @echooff
  2. REM OEMCustomizationScriptfile
  3. REMThisscriptifincludedinthe image,iscalled everytime the system boots.
  6. REMEnableAdministratorUser
  7. net userAdministratorp@ssw0rd/active:yes
  9. ifexist C:\AppInstall\AppInstall.cmd(
  10. REMEnableApplicationInstallationforonetime only,afterthisthe files are deleted.
  11. call C:\Appinstall\AppInstall.cmd>%temp%\AppInstallLog.txt
  13. REMCleanupApplicationInstallationFiles.Changedir to root so that the dirs can be deleted
  14. cd \
  15. rmdir/S/Q C:\AppInstall
  16. )

可以看到，脚本执行时，会判断C:\下是否存在AppInstall\AppInstall.cmd脚本（实际上这个AppInstall目录，就是从步骤2.appx打包成的cab包中提取出来的所有文件），如果有，则执行。而AppInstall.cmd脚本，就会将AppInstall目录下的appx应用程序安装并且设置为startup app。

PS: 自动安装脚本OEMCustomization.cmd，同样以cab包的形式打包进ffu镜像的。在步骤4中的OEMInput.xml文件中，OEM_CustomCmd这个feature就是自动安装脚本的cab。OEM_CustomCmd的声明在iot-adk-addonkit\Common\Packages\OEMCommonFM.xml中可以找到。

 

6. 最后，打包ffu镜像

执行createimage.cmd SampleA Test打包镜像。SampleA就是树莓派的sample。
生成的ffu位于：IoT-ADK-AddonKit\Build\\ProductA\Flash.FFU

大功告成！赶紧烧写到sd卡里测试一下吧！

 

可能会遇到的小问题

如果系统启动后，一直无法启动默认应用，一定是哪里出了问题（这是废话）。
可以到SD卡的Data\Users\DefaultAccount\AppData\Local\Temp目录下，看是否有你的应用的安装log（名字是****_result.txt）。
如果没有，可能是OEMCustomization.cmd脚本没有成功执行，需要检查下OEM_CustomCmd这个cab包是不是成功生成并打包到ffu中了；
如果有，就打开看一下log，应该会有错误原因。
我遇到的一个蛋疼的问题是：
安装appx时，找不到某个依赖（就是上面说的Microsoft.NET.Native.Framework、Microsoft.NET.Native.Runtime和Microsoft.VCLibs.ARM这三个appx），可是三个依赖包明明都在我的应用cab包中啊！这个时候用文本编辑器打开应用cab包中的AppxConfig.cmd这个脚本看了一下：

 
  1. setAppxName=IoTCoreMediaPlayer_1.0.4.0_ARM
  2. setcertslist=IoTCoreMediaPlayer_1.0.4.0_ARM
  3. setdependencylist=Microsoft.NET.Native.Framework.1.3Microsoft.NET.Native.Runtime.1.3Microsoft.VCLibs.ARM.14.00

第三行，注意到没有，三个依赖包的名字之间没有空格！！！再继续查找原因，根源在newappxpkg.cmd这个脚本。查看代码：

 
  1. ::Runsetenv before runningthisscript
  2. ::Thisscript creates the folder structureandcopies thetemplatefilesforanewpackage
  3. @echooff
  5. gotoSTART
  7. :Usage
  8. echoUsage:newappxpkg filename.appx[CompName.SubCompName]
  9. echo filename.appx...........Required,Inputappxpackage.Expectsdependenciesinasubfolder
  10. echoCompName.SubCompName....Optional,defaultisAppx.filename
  11. echo[/?]............Displaysthisusagestring.
  12. echoExample:
  13. echo newappxpkg C:\test\MainAppx_1.0.0.0_arm.appxAppx.Main
  14. echoExistingpackages are
  15. dir/b/AD%SRC_DIR%\Packages
  17. exit/b1
  19. :START
  20. setlocal ENABLEDELAYEDEXPANSION
  22. if[%1]==[/?]gotoUsage
  23. if[%1]==[-?]gotoUsage
  24. if[%1]==[]gotoUsage
  26. setFILE_TYPE=%~x1
  27. setFILE_NAME=%~n1
  28. set"FILE_PATH=%~dp1"
  30. if[%FILE_TYPE%]==[.appx](
  31. setCOMP_NAME=Appx
  32. for/f"tokens=1 delims=_"%%iin("%FILE_NAME%")do(
  33. setSUB_NAME=%%i
  34. )
  35. )else(
  36. echo.Unsupportedfiletype.
  37. gotoUsage
  38. )
  39. ifnot[%2]==[](
  40. for/f"tokens=1,2 delims=."%%iin("%2")do(
  41. setCOMP_NAME=%%i
  42. setSUB_NAME=%%j
  43. )
  44. )
  46. ifNOT DEFINED SRC_DIR(
  47. echoEnvironmentnotdefined.Callsetenv
  48. gotoEnd
  49. )
  50. SET"NEWPKG_DIR=%SRC_DIR%\Packages\%COMP_NAME%.%SUB_NAME%"
  52. ::ErrorChecks
  53. if/i EXIST%NEWPKG_DIR%(
  54. echoError:%COMP_NAME%.%SUB_NAME%already exists
  55. rmdir/s/q%NEWPKG_DIR%
  56. echoDeleteold%NEWPKG_DIR%
  57. )
  59. ::Startprocessing command
  60. echoCreating%COMP_NAME%.%SUB_NAME%package
  62. mkdir"%NEWPKG_DIR%"
  64. if[%FILE_TYPE%]==[.appx](
  65. ::CreateAppxPackageusingtemplatefiles
  66. mkdir"%NEWPKG_DIR%\AppInstall"
  67. echo.Creatingpackagexml file
  68. call appx2pkg.cmd%1%COMP_NAME%.%SUB_NAME%
  69. REMCopythe files to thepackagedirectory
  70. move"%FILE_PATH%\%COMP_NAME%.%SUB_NAME%.pkg.xml""%NEWPKG_DIR%\%COMP_NAME%.%SUB_NAME%.pkg.xml">nul
  71. ifexist"%FILE_PATH%\Dependencies\%ARCH%"(
  72. copy"%FILE_PATH%\Dependencies\%ARCH%\*.appx""%NEWPKG_DIR%\AppInstall\" >nul
  73. ) else (
  74. copy "%FILE_PATH%\Dependencies\*.appx" "%NEWPKG_DIR%\AppInstall\">nul
  75. )
  77. copy"%FILE_PATH%\*.cer""%NEWPKG_DIR%\AppInstall\" >nul
  78. copy "%FILE_PATH%\%FILE_NAME%.appx" "%NEWPKG_DIR%\AppInstall\%FILE_NAME%.appx" >nul
  79. copy "%IOTADK_ROOT%\Templates\AppInstall\*.cmd" "%NEWPKG_DIR%\AppInstall" >nul
  80. REM Update AppxConfig.cmd
  81. echo set AppxName=%FILE_NAME%> %NEWPKG_DIR%\AppInstall\AppxConfig.cmd
  82. for /f "useback delims=" %%i in ("%FILE_PATH%\appx_cerlist.txt") do (
  83. set certslist=!certslist!%%~ni
  84. )
  85. echo set certslist=!certslist! >> %NEWPKG_DIR%\AppInstall\AppxConfig.cmd
  86. for /f "useback delims=" %%i in ("%FILE_PATH%\appx_deplist.txt") do (
  87. set dependencylist=!dependencylist!%%~ni
  88. )
  89. echo set dependencylist=!dependencylist! >> %NEWPKG_DIR%\AppInstall\AppxConfig.cmd
  90. del "%FILE_PATH%\appx_cerlist.txt"
  91. del "%FILE_PATH%\appx_deplist.txt"
  92. )
  94. echo %NEWPKG_DIR% ready
  95. goto End
  97. :Error
  98. endlocal
  99. echo "newappxpkg%1%2" failed with error %ERRORLEVEL%
  100. exit /b 1
  102. :End
  103. endlocal
  104. exit /b 0

注意第87行：set certslist=!certslist!%%~ni，这行代码最后需要有一个空格！！这样生成的AppxConfig.cmd脚本就是这样的（每个依赖包后面有一个空格）：

 
  1. setAppxName=IoTCoreMediaPlayer_1.0.4.0_ARM
  2. setcertslist=IoTCoreMediaPlayer_1.0.4.0_ARM
  3. setdependencylist=Microsoft.NET.Native.Framework.1.3Microsoft.NET.Native.Runtime.1.3Microsoft.VCLibs.ARM.14.00

转载于:https://www.cnblogs.com/LeewayDev/p/5601849.html