Kotlin 实战:Android 设备语言与国家地区的 5 种获取方式

Kotlin 实现获取 Android 国家/地区和语言信息

在 Android 应用中获取用户的国家/地区和语言信息有多种方法,以下是几种常见的 Kotlin 实现方式:

1. 获取设备当前语言

kotlin 复制代码
// 获取当前系统语言代码 (例如 "en", "zh")
val languageCode = Locale.getDefault().language

// 获取完整语言标签 (例如 "en-US", "zh-CN")
val languageTag = Locale.getDefault().toLanguageTag()

// 获取显示名称 (例如 "English", "中文")
val displayName = Locale.getDefault().displayName

2. 获取设备国家/地区

kotlin 复制代码
// 方法1:通过Locale获取 (可能返回空字符串)
val countryCode = Locale.getDefault().country // 例如 "US", "CN"

// 方法2:通过TelephonyManager获取 (需要权限)
fun getCountryFromTelephony(context: Context): String? {
    return if (ContextCompat.checkSelfPermission(
            context,
            Manifest.permission.READ_PHONE_STATE
        ) == PackageManager.PERMISSION_GRANTED
    ) {
        val telephonyManager = context.getSystemService(Context.TELEPHONY_SERVICE) as TelephonyManager
        telephonyManager.simCountryIso ?: telephonyManager.networkCountryIso
    } else {
        null
    }
}

// 方法3:通过Network获取 (需要权限)
fun getCountryFromNetwork(context: Context): String? {
    val locale = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        context.resources.configuration.locales[0]
    } else {
        context.resources.configuration.locale
    }
    return locale.country
}

3. 获取用户首选语言列表

kotlin 复制代码
// 获取用户设置的所有语言偏好 (按优先级排序)
fun getPreferredLanguages(context: Context): List<Locale> {
    return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        context.resources.configuration.locales.toList()
    } else {
        listOf(context.resources.configuration.locale)
    }
}

4. 使用 AndroidX 的 LocaleManager (API 33+)

kotlin 复制代码
@RequiresApi(Build.VERSION_CODES.TIRAMISU)
fun getSystemLocales(context: Context): List<Locale> {
    val localeManager = context.getSystemService(Context.LOCALE_SERVICE) as LocaleManager
    return localeManager.systemLocales.toList()
}

5. 完整工具类示例

kotlin 复制代码
import android.content.Context
import android.Manifest
import android.content.pm.PackageManager
import android.os.Build
import android.telephony.TelephonyManager
import androidx.core.content.ContextCompat
import java.util.*

class LocaleHelper {

    companion object {
        
        // 获取当前语言代码
        fun getCurrentLanguage(): String {
            return Locale.getDefault().language
        }

        // 获取当前国家代码
        fun getCurrentCountry(): String {
            return Locale.getDefault().country
        }

        // 获取设备可能的国家代码 (尝试多种方法)
        fun getDeviceCountry(context: Context): String {
            return when {
                // 1. 首先尝试从SIM卡获取
                ContextCompat.checkSelfPermission(
                    context,
                    Manifest.permission.READ_PHONE_STATE
                ) == PackageManager.PERMISSION_GRANTED -> {
                    val tm = context.getSystemService(Context.TELEPHONY_SERVICE) as TelephonyManager
                    tm.simCountryIso?.takeIf { it.isNotBlank() }
                        ?: tm.networkCountryIso?.takeIf { it.isNotBlank() }
                        ?: getCurrentCountry()
                }
                
                // 2. 尝试从网络获取
                getCurrentCountry().isNotBlank() -> getCurrentCountry()
                
                // 3. 最后使用默认值
                else -> "US"
            }.uppercase(Locale.ROOT)
        }

        // 获取用户设置的所有语言偏好
        fun getUserPreferredLocales(context: Context): List<Locale> {
            return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
                context.resources.configuration.locales.toList()
            } else {
                listOf(context.resources.configuration.locale)
            }
        }

        // 检查是否使用特定语言 (如中文)
        fun isUsingChinese(): Boolean {
            return Locale.getDefault().language == "zh"
        }
    }
}

使用示例

kotlin 复制代码
// 获取当前语言和国家
val language = LocaleHelper.getCurrentLanguage() // "zh"
val country = LocaleHelper.getCurrentCountry()  // "CN"

// 获取设备国家 (更可靠的方式)
val deviceCountry = LocaleHelper.getDeviceCountry(context) // "CN"

// 检查是否使用中文
if (LocaleHelper.isUsingChinese()) {
    // 显示中文内容
}

注意事项

  1. 权限要求

    • 读取 SIM 卡信息需要 READ_PHONE_STATE 权限
    • 在 Android 10 及以上版本,可能无法获取完整的 SIM 卡信息
  2. 兼容性

    • 不同 Android 版本获取方式可能不同
    • 某些设备可能返回空值
  3. 用户偏好

    • 用户可能在系统设置中更改了语言偏好
    • 考虑提供应用内语言覆盖选项
  4. 格式化

    • 国家代码通常是大写的 ISO 3166-1 alpha-2 代码
    • 语言代码通常是小写的 ISO 639-1 代码
相关推荐
拓端研究室1 小时前
专题:2025医药生物行业趋势与投融资研究报告|附90+份报告PDF、原数据表汇总下载
android·开发语言·kotlin
小鱼人爱编程1 小时前
当上组长一年里,我保住了俩下属
android·前端·后端
2501_916013741 小时前
移动端 WebView 调试实战,多平台行为差异排查与统一调试流程
android·ios·小程序·https·uni-app·iphone·webview
liosen5 小时前
【安卓笔记】OOM与内存优化
android·oom·内存优化·内存分析命令·内存分析工具
猿小蔡-Cool10 小时前
Android ADB命令之内存统计与分析
android·adb
Monkey-旭10 小时前
Android Handler 完全指南
android·java·handler
從南走到北11 小时前
JAVA东郊到家按摩服务同款同城家政服务按摩私教茶艺师服务系统小程序+公众号+APP+H5
android·java·开发语言·微信小程序·小程序
alexhilton12 小时前
学会用最优雅的姿式在Compose中显示富文本
android·kotlin·android jetpack
阿华的代码王国14 小时前
【Android】卡片式布局 && 滚动容器ScrollView
android·xml·java·前端·后端·卡片布局·滚动容器
风起云涌~14 小时前
【Android】桌面小组件开发
android·gitee