Skip to content

Atlas 图集工具

Atlas 工具按图片目录确定性生成 Unity SpriteAtlas v2 资产,并统一维护通用与多平台 Importer 设置。配置本身是唯一源数据;手动 Build 与 BuildCfg 的 SpriteAtlasSettingsStage 调用同一套 Validate / Generate 实现。

固定配置:

text
Assets/SuperCore/Editor/Cfg_Atlas.asset

在 SuperCoreKit 的 EditorConfig / Atlas 页面配置。打开页面、修改字段、域重载和资源导入都不会隐式生成图集。

子功能

设计思路

  • 图片目录是图集成员的单一来源,不逐张维护 Sprite 列表。
  • 配置保存期望状态,Generate 负责把实际资产收敛到该状态。
  • 手动 Build 和流水线 Stage 复用同一实现,避免预览与正式构建结果不一致。
  • 平台配置只维护一次,切换 Group/平台时不复制参数。
  • AtlasCfg 不承担 YooAsset Package 策略,保持工具职责单一。

注意事项

  • 移动图片目录后同步 AtlasCfg、AssetLabelCfg 和 YooAsset Collector。
  • Image Directory 末级名称决定 Atlas 文件名;改目录名会删除旧图集并创建新图集,引用依靠 .meta/GUID 是否能保留需人工确认。
  • Android ASTC 格式需要目标设备支持;兼容性要求较高时选择合适格式和 ETC2 Fallback。
  • 8192 图集可能增加加载峰值和低端设备风险,优先通过合理目录拆分控制尺寸。
  • Include in Build 关闭会影响 Unity/YooAsset 的依赖追踪,除非明确采用运行时动态图集方案,否则保持开启。

SuperCore 使用 MIT License 开源