17370845950

在 android 2.1（api 7）中，`string.tobytearray(charset)` 不可用，会抛出 `nosuchmethoderror`；应改用 `string.getbytes(string charsetname)` 方法，并捕获 `unsupportedencodingexception`，确保向后兼容。

Android 2.1（即 API Level 7）是较早期的 Android 版本，其 java.lang.String 类尚未支持 Java N

IO 的 Charset 对象参数（该特性自 API 9 引入），更早在 API 8 才开始提供 getBytes(Charset) 重载方法。而 toByteArray(Charset) 是 Kotlin 标准库扩展函数，底层依赖 String.getBytes(Charset)，因此在 API 7 上直接调用会导致运行时崩溃。

✅ 正确且兼容 API 1+ 的写法如下（Java 风格，Kotlin 中同样适用）：

val string = "string"
val bytes: ByteArray
try {
    bytes = string.getBytes("UTF-8") // 使用字符串形式的字符集名
} catch (e: UnsupportedEncodingException) {
    // UTF-8 在所有 Android 版本中均受强制支持，此异常理论上不会发生，但编译器要求处理
    throw RuntimeException("UTF-8 not supported", e)
}

⚠️ 注意事项：

• "UTF-8" 字符串字面量是安全的——Android 自 API Level 1 起就强制要求支持 US-ASCII、ISO-8859-1、UTF-8、UTF-16BE 和 UTF-16LE，因此 getBytes("UTF-8") 在任意 Android 版本中均可稳定使用；
• 不要省略 try-catch：虽然 UTF-8 不会触发 UnsupportedEncodingException，但 Java/Kotlin 编译器仍要求显式处理该受检异常；
• 避免使用 getBytes() 无参版本（默认平台编码），因不同设备可能返回不同字节序列，破坏数据一致性；
• 若需频繁调用，可封装为工具函数提升可读性与复用性：

fun String.toUtf8Bytes(): ByteArray = try {
    getBytes("UTF-8")
} catch (e: UnsupportedEncodingException) {
    throw RuntimeException(e) // 安全兜底：UTF-8 不可能不支持
}

总结：面向低版本 Android（尤其是 API ≤ 7）开发时，应放弃 Charset 对象和 Kotlin 扩展函数的“现代语法”，回归 String.getBytes(String charsetName) 这一最广泛兼容的 API，兼顾健壮性与最小化兼容成本。