在electron-builder中实现AppX包的自定义资源缩放配置

electron-builder作为一款强大的Electron应用打包工具，在v26版本中提供了对AppX包自定义清单文件的支持。这为开发者提供了更灵活的配置选项，特别是针对Windows应用商店打包时的资源缩放设置。

背景知识

在Windows应用打包(AppX)中，uap:Scale属性用于定义应用资源的不同缩放比例版本。这类似于Android中的drawable资源针对不同屏幕密度的适配。通过为不同缩放比例(如100%、200%等)提供专门的资源文件，可以确保应用在高DPI显示器上获得最佳的显示效果。

electron-builder的解决方案

electron-builder从v26版本开始，允许开发者通过customManifestPath选项指定自定义的AppX清单文件。这个清单文件支持模板宏，意味着开发者可以动态地插入变量和条件逻辑。

实现方法

要自定义资源缩放配置，开发者需要：

1. 创建一个自定义的AppX清单文件(通常命名为appxmanifest.xml)
2. 在该文件中添加类似如下的资源缩放配置：

<Resources>
  <Resource uap:Scale="100" />
  <Resource uap:Scale="200" />
  <Resource uap:Scale="400" />
</Resources>

3. 在electron-builder配置中指定这个自定义清单文件路径：

{
  "appx": {
    "customManifestPath": "./appxmanifest.xml"
  }
}

高级用法

对于更动态的配置，可以利用模板宏功能。例如，根据不同的构建环境或用户配置动态生成缩放比例：

<Resources>
  <% for (const scale of scales) { %>
    <Resource uap:Scale="<%= scale %>" />
  <% } %>
</Resources>

注意事项

1. 确保自定义清单文件包含了所有必需的基本元素
2. 缩放比例应该与实际的资源文件匹配
3. 测试不同缩放比例下的应用显示效果
4. 考虑资源文件大小和包体积的影响

通过这种自定义方式，开发者可以更精细地控制Windows应用商店包的资源适配策略，提升应用在各种显示设备上的用户体验。