本文旨在解决在使用 Android Management API 获取设备序列号时，部分设备无法提供序列号的问题。我们将探讨如何通过多种方式尝试获取序列号，并提供代码示例，帮助开发者在不同设备上更可靠地获取设备标识符，同时注意权限申请和兼容性处理。
设备序列号获取的常见问题
在使用 Android Management API 开发应用程序时，获取设备的序列号是一个常见的需求。然而，不同的 Android 设备在提供序列号方面存在差异。某些设备（如 Samsung A30, Samsung Active Tab 3）能够顺利提供序列号，而另一些设备（如 Redmi Pro 10, Samsung SM-G781B）则可能无法提供。这给开发者带来了一定的困扰。
解决方案：多渠道获取设备序列号
为了解决设备序列号获取不一致的问题，我们可以尝试通过多种渠道获取，并按优先级顺序进行尝试。以下是一种推荐的实现方式：
- 使用 SystemProperties 类： 这是获取序列号的常用方法，通过反射调用 android.os.SystemProperties 类的 get 方法，尝试从多个系统属性中获取序列号。
- 使用 Build.SERIAL： 在 API Level 26 之前，可以使用 Build.SERIAL 获取序列号。但是，需要注意，在 API Level 26 及更高版本中，需要 READ_PHONE_STATE 权限才能访问此字段。
- 使用 Build.getSerial()： 在 API Level 26 及更高版本中，可以使用 Build.getSerial() 获取序列号。同样，需要 READ_PHONE_STATE 权限。
- ADB Shell 获取： 可以通过执行 ADB shell 命令 getprop 并读取唯一的设备值来获取更多设备信息。
以下是代码示例：
import android.Manifest
import android.content.Context
import android.content.pm.PackageManager
import android.os.Build
import android.widget.Toast
import androidx.core.app.ActivityCompat
import androidx.core.content.ContextCompat
fun getDeviceSerial(applicationContext: Context): String {
var serialNumber: String = ""
try {
val c = Class.forName("android.os.SystemProperties")
val get = c.getMethod("get", String::class.java)
// 尝试从多个系统属性中获取序列号
serialNumber = get.invoke(c, "gsm.sn1") as String
if (serialNumber.isEmpty()) serialNumber = get.invoke(c, "ril.serialnumber") as String
if (serialNumber.isEmpty()) serialNumber = get.invoke(c, "ro.serialno") as String
if (serialNumber.isEmpty()) serialNumber = get.invoke(c, "sys.serialnumber") as String
if (serialNumber.isEmpty()) serialNumber = get.invoke(c, "ro.boot.serialno") as String
if (serialNumber.isEmpty()) serialNumber = get.invoke(c, "ro.ril.oem.sno") as String
if (serialNumber.isEmpty()) serialNumber = get.invoke(c, "ril.cdma.esn") as String
if (serialNumber.isEmpty()) serialNumber = get.invoke(c, "vendor.gsm.serial") as String
if (serialNumber.isEmpty()) serialNumber = get.invoke(c, "ro.boot.un") as String
if (serialNumber.isEmpty()) serialNumber = get.invoke(c, "ro.boot.uniqueno") as String
if (serialNumber.isEmpty()) serialNumber = get.invoke(c, "ro.ril.oem.wifimac") as String
if (serialNumber.isEmpty()) serialNumber = get.invoke(c, "ro.ril.oem.btmac") as String
// 兼容旧版本
@Suppress("DEPRECATION")
if (serialNumber.isEmpty()) serialNumber = Build.SERIAL
// 再次检查
if (serialNumber.isEmpty()) serialNumber = ""
} catch (e: Exception) {
e.printStackTrace()
Toast.makeText(applicationContext, e.message, Toast.LENGTH_LONG).show()
serialNumber = ""
}
if (serialNumber == "unknown") {
try {
val c = Class.forName("android.os.SystemProperties")
val get = c.getMethod(
"get",
String::class.java,
String::class.java
)
serialNumber = get.invoke(c, "ril.serialnumber", "unknown") as String
} catch (ignored: Exception) {
Toast.makeText(
applicationContext,
"ignored ${ignored.message}",
Toast.LENGTH_LONG
)
.show()
}
}
// Android 8.0 (API level 26) 及更高版本需要 READ_PHONE_STATE 权限
try {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O && serialNumber == "unknown") {
if (ActivityCompat.checkSelfPermission(
applicationContext,
Manifest.permission.READ_PHONE_STATE
) == PackageManager.PERMISSION_GRANTED
) {
serialNumber = Build.getSerial()
}
}
} catch (e: Exception) {
serialNumber = ""
}
return serialNumber
}
fun openTelePhony(context: Context?) {
context?.let {
var a = ""
try {
//check permission
if (ContextCompat.checkSelfPermission(
context,
Manifest.permission.CALL_PHONE
) == PackageManager.PERMISSION_GRANTED
) {
a = getDeviceSerial(context)
} else {
@Suppress("DEPRECATION")
a = Build.SERIAL
}
println(a)
} catch (e: Exception) {
println()
}
}
}权限申请
从 Android 6.0 (API level 23) 开始，需要在运行时请求 READ_PHONE_STATE 权限。请确保在 AndroidManifest.xml 文件中声明了该权限，并在代码中检查和请求权限。
在代码中检查权限：
if (ContextCompat.checkSelfPermission(context, Manifest.permission.READ_PHONE_STATE)
!= PackageManager.PERMISSION_GRANTED) {
// 权限未授予，请求权限
ActivityCompat.requestPermissions(activity, arrayOf(Manifest.permission.READ_PHONE_STATE), PERMISSION_REQUEST_CODE)
} else {
// 权限已授予，可以获取序列号
val serialNumber = getDeviceSerial(context)
}注意事项
- 设备兼容性： 不同的设备厂商和 Android 版本可能对序列号的获取方式有所不同。建议在多种设备上进行测试，以确保代码的兼容性。
- 权限管理： 务必正确处理权限申请，并在用户拒绝授权时提供合理的提示。
- 错误处理： 在获取序列号的过程中，可能会遇到各种异常情况。建议添加适当的错误处理机制，以避免程序崩溃。
- 唯一标识符： 序列号并非在所有情况下都是唯一的。在某些情况下，可能需要结合其他设备信息（如 IMEI、MAC 地址等）来生成唯一的设备标识符。但请注意，获取 IMEI 和 MAC 地址也需要相应的权限，并且受到 Android 版本的限制。
总结
通过尝试多种方法获取设备序列号，并正确处理权限申请和错误处理，可以提高设备序列号获取的成功率，并增强应用程序的兼容性和稳定性。请根据实际需求选择合适的方案，并在多种设备上进行测试，以确保代码的正确性和可靠性。
