用途:在 IntelliJ 社区版中管理 Java 资源根下的图标资源,覆盖新增、重命名、移动、删除和引用图标,并处理与生成图标类或 icon-robots.txt 相关的失败。
主要能力:资源根下的图标通常由生成的 *Icons.java 类表示。不要为应属于生成图标类的图标添加本地 IconLoader.getIcon(...) 包装,生产代码和测试应直接使用生成字段。若某图标应被有意排除在类生成之外,应在图标资源附近添加或更新 icon-robots.txt 规则,而不是创建临时加载器。生成类包含由规范化 SVG 内容派生的缓存键,不要猜测缓存键。
使用方式:优先运行 IDE 运行配置 Icons processing | Generate icon classes。若该配置不可用,运行图标类测试并应用其打印的精确生成差异: ./tests.cmd --module intellij.platform.images.build.tests --test org.jetbrains.intellij.build.images.CommunityIconClassesTest 应用生成输出后,重新运行同一测试以确认没有过期的生成图标类。若生产调用点有变更,还应运行受影响模块的测试或编译;图标类测试只验证生成文件,不一定编译每个图标使用方。
Bazel 状态:截至该指南,图标类生成未作为 Bazel 可运行目标暴露。包 @community//platform/build-scripts/icons 包含库和测试目标,但没有二进制目标: bazel query 'kind(".binary.", @community//platform/build-scripts/icons:all)' 使用由 Bazel 支持的 tests.cmd 进行验证。若以后添加了生成器二进制目标,应优先使用该文档化的 Bazel 目标而非 IDE 运行配置。
限制:资料未提供收费、价格、平台支持范围或效果保证等信息。