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 代码
相关推荐
花花鱼7 小时前
android studio 设置让开发更加的方便,比如可以查看变量的类型,参数的名称等等
android·ide·android studio
alexhilton9 小时前
为什么你的App总是忘记所有事情
android·kotlin·android jetpack
AirDroid_cn12 小时前
OPPO手机怎样被其他手机远程控制?两台OPPO手机如何相互远程控制?
android·windows·ios·智能手机·iphone·远程工作·远程控制
尊治12 小时前
手机电工仿真软件更新了
android
xiangzhihong815 小时前
使用Universal Links与Android App Links实现网页无缝跳转至应用
android·ios
车载应用猿15 小时前
基于Android14的CarService 启动流程分析
android
没有了遇见16 小时前
Android 渐变色实现总结
android
雨白19 小时前
Jetpack系列(四):精通WorkManager,让后台任务不再失控
android·android jetpack
mmoyula21 小时前
【RK3568 驱动开发:实现一个最基础的网络设备】
android·linux·驱动开发
sam.li21 小时前
WebView安全实现(一)
android·安全·webview