资源目录编辑器
新建图片集、颜色集、符号集、App 图标；一张 1024 图生成全部尺寸；图片集的外观、设备、倍率属性；内置校验与编译检查。
打开
| 入口 | 操作 |
|---|---|
| KXBuild 视图 | 点击工程节点下的资源目录 |
| 资源管理器 | 右键 .xcassets 文件夹选择「KXBuild: 打开资源目录」，或双击任意 Contents.json |
| 命令面板 | 「KXBuild: 打开资源目录」，工作区中有多个时弹出列表 |
| 文本模式切回 | Contents.json 编辑器标题栏「KXBuild: 用资源目录编辑器打开」 |
外部工具修改了目录中的文件后，点标题栏「KXBuild: 重新加载资源目录」。
新建
在左侧树的空白处或文件夹上右键。
| 菜单 | 说明 |
|---|---|
| 新建 App 图标 | 选择 iOS、macOS 或 watchOS 模板。iOS 可选全部尺寸或单尺寸 1024 图标 |
| 新建图片集 | 带 1x、2x、3x 槽位的 .imageset |
| 新建颜色集 | .colorset，可按外观分别定义 |
| 新建数据集 | .dataset，任意文件加类型标识 |
| 新建符号图片集 | .symbolset，存放 SF Symbols 导出的 SVG |
| 新建文件夹 | 分组，勾选 Provides Namespace 后引用名带前缀 |
| 新建 App 图标（visionOS） | 分层的 visionOS 图标 |
| 新建 App 图标与顶架图（tvOS） | tvOS 的 .brandassets |
| 新建图片栈（tvOS） | 带 front / back 图层的 .imagestack |
条目上右键还可以重命名、删除、在资源管理器中显示。
App 图标
| 操作 | 说明 |
|---|---|
| 用一张 1024×1024 图生成全部尺寸… | 选一张不小于 1024 的正方形 PNG，所有槽位按尺寸缩放生成，Dark 和 Tinted 外观的槽位可以一起填 |
| 添加平台… | 给已有图标集添加 iPad、Mac、Watch、CarPlay 等平台的槽位 |
| 转换为单尺寸图标 | 把逐尺寸条目换成一张 1024 图，并提示有多少文件不再被引用 |
单个槽位可以直接拖入图片，或右键「替换图片…」「移除图片」。App Store 用的 1024 图不能带 alpha 通道，编辑器会标出。
图片集属性
| 属性 | 可选值 |
|---|---|
| Appearances | Any、Light、Dark、Tinted、High Contrast，勾选后增加对应槽位 |
| Devices | Universal、iPhone、iPad、Mac、Apple Watch、Apple TV、Apple Vision、CarPlay |
| Gamut | Any，或 sRGB 与 Display P3 分开 |
| Scales | Individual Scales（1x、2x、3x）或 Single Scale（一张矢量图） |
| Render As | Default、Original Image、Template Image |
| Preserve Vector Data | PDF、SVG 保留矢量数据，运行时按需缩放 |
| Compression | 编译时的压缩方式 |
颜色集可设置色彩空间、Hex、Opacity 或直接选系统颜色。数据集设置 Type Identifier 和文件。符号图片集只接受 SVG。
校验
编辑器打开时自动检查，结果显示在「问题」面板并在标题栏计数。检查项包括 Contents.json 解析失败、重复条目、槽位没有图片、引用的文件不存在、图片不是 PNG 或尺寸不符、App Store 图标带 alpha、缺少 1024 图标、未被引用的文件、颜色分量越界等。
平台相关的要求需要编译一次才能检查。点标题栏「KXBuild: 编译检查资源目录」并选择平台，警告和错误同样显示在「问题」面板。
未被引用的文件
替换图片、移除槽位、转换为单尺寸之后，原来的文件可能不再被引用，编辑器会询问是否删除。