如何通过Android Management API获取设备序列号并解决兼容性问题？

本文共计1358个文字，预计阅读时间需要6分钟。

原文已简化如下：

设备序列号获取的常见问题

在使用 Android Management API 开发应用程序时，获取设备的序列号是一个常见的需求。然而，不同的 Android 设备在提供序列号方面存在差异。某些设备（如 Samsung A30, Samsung Active Tab 3）能够顺利提供序列号，而另一些设备（如 Redmi Pro 10, Samsung SM-G781B）则可能无法提供。这给开发者带来了一定的困扰。

解决方案：多渠道获取设备序列号

为了解决设备序列号获取不一致的问题，我们可以尝试通过多种渠道获取，并按优先级顺序进行尝试。以下是一种推荐的实现方式：

1. 使用 SystemProperties 类： 这是获取序列号的常用方法，通过反射调用 android.os.SystemProperties 类的 get 方法，尝试从多个系统属性中获取序列号。
2. 使用 Build.SERIAL： 在 API Level 26 之前，可以使用 Build.SERIAL 获取序列号。但是，需要注意，在 API Level 26 及更高版本中，需要 READ_PHONE_STATE 权限才能访问此字段。
3. 使用 Build.getSerial()： 在 API Level 26 及更高版本中，可以使用 Build.getSerial() 获取序列号。同样，需要 READ_PHONE_STATE 权限。
4. 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 文件中声明了该权限，并在代码中检查和请求权限。

<uses-permission android:name="android.permission.READ_PHONE_STATE" /> <uses-permission android:name="android.permission.CALL_PHONE" />

在代码中检查权限：

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 版本的限制。

总结

通过尝试多种方法获取设备序列号，并正确处理权限申请和错误处理，可以提高设备序列号获取的成功率，并增强应用程序的兼容性和稳定性。请根据实际需求选择合适的方案，并在多种设备上进行测试，以确保代码的正确性和可靠性。