如何在Jetpack Compose中修改无多字重变体字体的字重

Jetpack Compose 完全支持为仅提供常规字重的字体实现加粗显示，不需要字体本身自带粗体变体，效果和CSS中对单字重字体设置加粗的逻辑一致。 #

基础实现（推荐） #

直接给文本组件指定FontWeight.Bold参数即可，Compose 会在当前字体没有匹配粗体字重时，自动渲染仿粗效果，代码示例：

// 首先初始化单字重的Secular One字体族
val secularOneFont = FontFamily(
    Font(R.font.secular_one_regular, FontWeight.Normal) // 加载本地存储的常规字重字体文件
)

// 在Text组件中使用
Text(
    text = "需要加粗显示的文本内容",
    fontFamily = secularOneFont,
    fontWeight = FontWeight.Bold, // 直接指定粗体字重即可触发自动仿粗
    fontSize = 18.sp
)

这种方案是官方默认实现，渲染性能最优，和系统全局的粗体显示风格保持一致，绝大多数场景下优先使用这个方案即可。 #

自定义加粗程度实现 #

如果默认的仿粗效果不符合你的视觉预期，可以通过手动给文字增加描边的方式自定义加粗强度，代码示例：

Text(
    text = "自定义粗细的文本内容",
    fontFamily = secularOneFont,
    fontSize = 18.sp,
    modifier = Modifier.drawWithContent {
        drawContent()
        // 调整strokeWidth的数值即可控制加粗程度，数值越大粗度越高
        drawIntoCanvas { canvas ->
            val textPaint = android.graphics.Paint().apply {
                isAntiAlias = true
                textSize = 18.sp.toPx()
                typeface = Typeface.createFromAsset(
                    context.assets,
                    "secular_one_regular.ttf"
                )
                style = android.graphics.Paint.Style.STROKE
                this.strokeWidth = 1.2f
            }
            canvas.nativeCanvas.drawText(
                "自定义粗细的文本内容",
                0f,
                18.sp.toPx(),
                textPaint
            )
        }
    }
)

注意事项 #

• 如果使用Compose的可下载字体能力加载字体，只要引入的是常规字重版本，指定FontWeight.Bold同样会触发仿粗逻辑，不需要额外引入粗体字重资源
• 自动仿粗的字形和字体官方推出的原生粗体字重会存在细微差异，如果对字体显示精度要求极高，建议优先使用官方发布的粗体字重文件
• 不要为了实现单字重字体加粗额外引入粗体字体资源，会无故增加安装包体积

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