如何在Jetpack Compose设计系统中限制仅使用Fluent图标Drawable？

最优方案：编译期类型约束 #

直接通过自定义专属类型替代Drawable作为组件的图标参数，从根源上阻止非法输入，比注解处理或运行时校验更高效可靠。

1. 封装Fluent图标为密封类 #

创建密封类，仅允许内部定义的实例对应Fluent图标资源：

sealed class FluentIcon(val resId: Int) {
    // 逐一映射项目中用到的Fluent图标
    object Add : FluentIcon(R.drawable.ic_fluent_add_24_filled)
    object Delete : FluentIcon(R.drawable.ic_fluent_delete_24_filled)
    object Search : FluentIcon(R.drawable.ic_fluent_search_24_regular)
    // 其他图标...

    // 快速转为Compose Painter的扩展方法
    @Composable
    fun asPainter(): Painter = painterResource(resId)
}

密封类的特性确保外部无法创建新的实例，只能使用你预先定义好的Fluent图标。

2. 修改组件参数类型 #

将组件中接收图标的参数类型从Drawable/Int改为FluentIcon：

@Composable
fun ActionButton(
    onClick: () -> Unit,
    icon: FluentIcon,
    label: String
) {
    Button(onClick = onClick) {
        Icon(painter = icon.asPainter(), contentDescription = label)
        Spacer(Modifier.width(8.dp))
        Text(label)
    }
}

现在调用组件时，只能传入FluentIcon.Add这类合法实例，任何其他类型都会触发编译错误，彻底杜绝违规图标。

3. 批量生成图标实例（可选） #

如果项目中用到的Fluent图标数量多，手动编写密封类子类太麻烦，可以用Kotlin Symbol Processing (KSP) 自动生成：

• 给所有Fluent图标资源添加自定义注解，比如@FluentIconResource
• 编写KSP处理器，扫描所有带该注解的资源ID，自动生成FluentIcon的子类
• 新增图标时只需给资源加注解，无需手动修改密封类

其他方案的局限性 #

• 注解处理：需要额外编写处理器逻辑，且只能在编译时给出警告/错误，不如类型约束直接阻断非法输入
• 运行时校验：需要在组件中判断Drawable是否属于Fluent图标，会增加运行时开销，且错误只能在测试阶段发现
• 自定义Drawable子类：Fluent图标是系统提供的Drawable资源，无法让它们继承自定义类，此方案不可行

总结 #

优先采用密封类+类型约束的方案，实现简单、编译期保障合法性，开发体验最优。图标数量大时，用KSP批量生成实例减少重复工作。

内容的提问来源于stack exchange，提问作者Younes Charfaoui