Jetpack Compose多语言下AnnotatedString链接免索引计算实现方案

核心思路 #

放弃手动指定文本起止索引的实现方式，利用Android原生字符串资源的标记能力+Compose官方提供的注解字符串解析API，自动匹配不同语言下链接文本的位置，全程仅使用androidx、kotlin官方依赖，无需引入第三方库。

具体实现步骤 #

1. 配置多语言字符串资源 #

在对应语言的strings.xml文件中，使用原生<a>标签标记需要设置链接的文本片段，标签内href属性填写链接目标地址，无需关心标记片段在整段文本中的位置：

<!-- 英文资源 values/strings.xml -->
<string name="intro_text">My <a href="target_link_placeholder">website</a></string>

<!-- 德文资源 values-de/strings.xml -->
<string name="intro_text">Meine <a href="target_link_placeholder">Webseite</a></string>

如果需要动态传入链接地址，可以使用字符串占位符配置：

<string name="intro_text">My <a href="%1$s">website</a></string>

2. 自动生成带链接注解的AnnotatedString #

使用Compose官方提供的annotatedStringResource方法读取字符串资源，该方法会自动识别字符串中的<a>标签，生成匹配当前语言位置的链接注解，完全不需要手动计算索引：

import android.content.Intent
import androidx.compose.foundation.text.ClickableText
import androidx.compose.runtime.Composable
import androidx.compose.ui.platform.LocalContext
import androidx.compose.ui.res.annotatedStringResource
import androidx.compose.ui.text.SpanStyle
import androidx.compose.ui.text.style.TextDecoration
import androidx.core.net.toUri

@Composable
fun LinkTextDemo() {
    val context = LocalContext.current
    // 如果用了占位符，第二个参数传入实际链接地址即可
    val annotatedText = annotatedStringResource(id = R.string.intro_text)
        // 统一给链接添加下划线样式，无需指定局部索引
        .apply {
            addStyle(
                style = SpanStyle(textDecoration = TextDecoration.Underline),
                start = 0,
                end = length
            )
        }

3. 处理链接点击逻辑 #

在ClickableText的点击回调中，根据点击位置匹配对应位置的URL注解，触发跳转逻辑即可：

ClickableText(text = annotatedText) { clickOffset ->
        // 匹配点击位置是否落在链接范围内
        annotatedText.getStringAnnotations(
            tag = "URL",
            start = clickOffset,
            end = clickOffset
        ).firstOrNull()?.let { linkAnnotation ->
            // 执行链接跳转
            val intent = Intent(Intent.ACTION_VIEW, linkAnnotation.item.toUri())
            context.startActivity(intent)
        }
    }
}

方案优势 #

• 零第三方依赖：所有API均来自androidx官方库、Android原生SDK，符合依赖要求
• 无硬编码索引：链接位置随当前系统语言自动适配，新增语言版本时仅需翻译对应strings.xml内容、保留<a>标签标记即可，无需修改业务代码
• 扩展性强：单段文本支持添加多个链接，仅需在字符串资源中给对应片段加<a>标签即可自动识别，无需额外处理

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