本文旨在提供一个全面的指南，帮助开发者在使用 Android Management API 时可靠地获取 Android 设备的序列号。由于不同设备和 Android 版本在序列号的获取方式上存在差异，本文将介绍多种获取序列号的方法，并提供代码示例和注意事项，以确保在各种情况下都能成功获取设备序列号。
获取设备序列号的多种方法
在 Android 开发中，获取设备序列号并非总是直接明了。不同的设备制造商和 Android 版本可能会将序列号存储在不同的系统属性中。因此，需要尝试多种方法才能确保在各种设备上都能获取到序列号。以下是一些常用的方法：
-
使用 Build.SERIAL (API Level
在 Android 8.0 (API Level 26) 之前，可以使用 Build.SERIAL 直接获取设备序列号。但是，从 Android 8.0 开始，Build.SERIAL 已经被标记为 deprecated，并且需要 READ_PHONE_STATE 权限。如果权限未授予，它将返回 "UNKNOWN"。
@Suppress("DEPRECATION") val serialNumber = Build.SERIAL注意事项：
- 在 Android 8.0 及更高版本中，请确保已请求并获得 READ_PHONE_STATE 权限。
- Build.SERIAL 可能会返回 "UNKNOWN"，尤其是在模拟器或某些设备上。
-
使用 Build.getSerial() (API Level >= 26)
从 Android 8.0 (API Level 26) 开始，可以使用 Build.getSerial() 方法获取设备序列号。与 Build.SERIAL 类似，它也需要 READ_PHONE_STATE 权限。
import android.Manifest import android.content.pm.PackageManager import androidx.core.app.ActivityCompat import android.os.Build fun getSerialNumber(context: Context): String? { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { if (ActivityCompat.checkSelfPermission(context, Manifest.permission.READ_PHONE_STATE) == PackageManager.PERMISSION_GRANTED) { return Build.getSerial() } else { // 请求权限 ActivityCompat.requestPermissions(activity, arrayOf(Manifest.permission.READ_PHONE_STATE), REQUEST_CODE) return null // 或者返回一个默认值，例如 "UNKNOWN" } } else { @Suppress("DEPRECATION") return Build.SERIAL } }注意事项：
- 在使用 Build.getSerial() 之前，必须检查并请求 READ_PHONE_STATE 权限。
- 如果权限未授予，Build.getSerial() 将抛出一个 SecurityException。
-
通过反射访问系统属性
由于设备制造商可能会将序列号存储在不同的系统属性中，因此可以使用反射来尝试读取这些属性。以下是一个尝试读取多个常见属性的代码示例：
import android.content.Context import android.os.Build import android.widget.Toast 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 } 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() } } 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 }注意事项：
- 使用反射可能会导致一些问题，例如在不同的设备上可能无法正常工作。
- 请务必处理 ClassNotFoundException 和 NoSuchMethodException 等异常。
- 此方法也需要 READ_PHONE_STATE 权限才能保证在所有设备上都能工作。
权限处理
在尝试获取设备序列号之前，务必确保已请求并获得 READ_PHONE_STATE 权限。可以使用 ActivityCompat.requestPermissions() 方法来请求权限。
import android.Manifest
import android.content.pm.PackageManager
import androidx.core.app.ActivityCompat
import androidx.core.content.ContextCompat
import androidx.appcompat.app.AppCompatActivity
private const val REQUEST_CODE = 123 // 可以是任何唯一的整数
fun checkAndRequestPermission(activity: AppCompatActivity) {
if (ContextCompat.checkSelfPermission(activity, Manifest.permission.READ_PHONE_STATE) != PackageManager.PERMISSION_GRANTED) {
ActivityCompat.requestPermissions(activity, arrayOf(Manifest.permission.READ_PHONE_STATE), REQUEST_CODE)
}
}然后在 onRequestPermissionsResult() 方法中处理权限请求结果：
override fun onRequestPermissionsResult(requestCode: Int, permissions: Array, grantResults: IntArray) { super.onRequestPermissionsResult(requestCode, permissions, grantResults) when (requestCode) { REQUEST_CODE -> { if ((grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED)) { // 权限已授予，可以安全地获取序列号 } else { // 权限被拒绝，处理这种情况，例如显示一条消息 } } } }
总结
获取 Android 设备序列号可能是一个具有挑战性的任务，因为它取决于设备制造商和 Android 版本。通过尝试多种方法并正确处理权限，可以最大限度地提高成功获取序列号的可能性。请记住，在生产环境中，务必进行充分的测试，以确保代码在各种设备上都能正常工作。
此外，考虑到隐私问题，建议在获取设备序列号之前，向用户明确说明原因，并征得用户的同意。
最后，如果以上方法都无法获取设备序列号，可以考虑使用其他唯一标识符，例如 Android ID 或 IMEI（需要额外权限）。但是，请务必仔细评估这些标识符的适用性和隐私影响。
