APM Docs

Appearance

App 排障 ​

第一步：

bash
apm-cli app doctor

重点检查工具、依赖目录、assets/icons、icon 命名、PNG 尺寸、descriptor identity 与 project lock。

Icon 常见问题 ​

text
文件名不匹配
  -> 在 air-app.json 增加 iconFilenamePatterns

icon32x32.png 实际是 64x64
  -> 修正图片尺寸或文件名

同尺寸存在两个匹配文件
  -> 删除重复文件，避免映射歧义

资源在 Desktop Debug 中找不到 ​

确认资源位于 src/assets/，然后：

bash
apm-cli app sync
apm-cli app build desktop

最终冒烟 ​

bash
apm-cli app doctor
apm-cli app build desktop
apm-cli app package desktop