| API 等級 | 獲取方式 | 權限需求 | 備註 |
|---|---|---|---|
| < 23 (6.0) | TelephonyManager.getDeviceId() (IMEI/MEID) | READ_PHONE_STATE (安裝時授予) | 直接可用 |
| 23 ~ 28 (6.0-9.0) | 同上 | READ_PHONE_STATE **動態申請** | 用戶可拒絕,回傳 null |
| 29 (10.0) | 受限:非系統/預載應用回傳 SecurityException 或 null | READ_PRIVILEGED_PHONE_STATE (僅系統簽名) | 普通應用**無法獲取 IMEI** |
| 30+ (11+) | 同上,進一步收緊 | 同上 | 建議改用可重置識別碼 |
fun getDeviceId(context: Context): String? {
val tm = context.getSystemService(Context.TELEPHONY_SERVICE) as TelephonyManager
return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
// Android 10+ 普通應用無法獲取 IMEI,拋 SecurityException
try {
// 僅有 READ_PRIVILEGED_PHONE_STATE 才能通過
tm.imei // API 26+ getImei() 需權限
} catch (e: SecurityException) {
Log.w("DeviceId", "無權限獲取 IMEI", e)
null
}
} else {
// API < 29
if (ContextCompat.checkSelfPermission(context, Manifest.permission.READ_PHONE_STATE)
== PackageManager.PERMISSION_GRANTED) {
tm.deviceId // getDeviceId() 已棄用
} else null
}
}
// IMSI (用戶識別碼,換 SIM 卡變化) - 同樣受限
fun getImsi(context: Context): String? {
val tm = context.getSystemService(Context.TELEPHONY_SERVICE) as TelephonyManager
return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
try { tm.subscriberId } catch (e: SecurityException) { null }
} else {
if (ContextCompat.checkSelfPermission(context, Manifest.permission.READ_PHONE_STATE)
== PackageManager.PERMISSION_GRANTED) tm.subscriberId else null
}
}
<!-- 基礎電話狀態權限 (API < 29 獲取 IMEI/IMSI 需要) -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!-- Android 10+ 獲取 IMEI/IMSI/ICCID 需特權 (普通應用不可申請) -->
<!-- -->
**禁止**為廣告/分析/追蹤目的獲取不可重置硬體識別碼 (IMEI、序列號、MAC)。違規將導致 App 下架。
FirebaseInstallations.getInstance().getId() (需添加 firebase-installations 依賴)。AdvertisingIdClient.getAdvertisingIdInfo(context).id (需 Play Services)。fun getOrCreateAppInstanceId(context: Context): String {
val prefs = context.getSharedPreferences("app_id", Context.MODE_PRIVATE)
return prefs.getString("instance_id", "").also { id ->
if (id.isNullOrEmpty()) {
val newId = UUID.randomUUID().toString()
prefs.edit().putString("instance_id", newId).apply()
return newId
}
}
}
SharedPreferences,清除資料/重裝即重置。Settings.Secure.getString(contentResolver, Settings.Secure.ANDROID_ID)。
需要持久設備身份 (如設備綁定授權)?
├─ 是 → 僅限系統/預載應用,申請 READ_PRIVILEGED_PHONE_STATE 獲取 IMEI
└─ 否 → 需要跨應用追蹤用戶 (廣告/分析)?
├─ 是 → 使用 Advertising ID (用戶可重置/退出)
└─ 否 → 僅需應用內區分安裝實例?
├─ 是 → 使用 Firebase Installation ID 或 自建 UUID (SharedPreferences)
└─ 否 → 臨時會話標識 → 使用 Session ID (內存中生成)
Android 10+ **徹底封殺**普通應用獲取 IMEI/IMSI。現代開發**必須遷移至可重置識別碼** (Firebase Installation ID、Advertising ID、自建 UUID)。舊代碼務必加入版本判斷與 try-catch SecurityException 防崩潰,並同步更新隱私政策說明收集數據用途。