Merge branch 'main' of http://git.zhenbs.com:9999/2-group-android/DevCheck-lib
This commit is contained in:
yuqian
commit
de5fab1158
444
BluetoothInfo蓝牙版本检测使用示例.md
Normal file
444
BluetoothInfo蓝牙版本检测使用示例.md
Normal file
@ -0,0 +1,444 @@
|
|||||||
|
# BluetoothInfo 蓝牙版本检测使用示例
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
BluetoothInfo 类现在提供了完整的蓝牙版本检测功能，可以准确识别设备支持的蓝牙版本（从 3.0 到 5.4）。
|
||||||
|
|
||||||
|
## 新增功能
|
||||||
|
|
||||||
|
### 1. 蓝牙版本检测方法（3个）
|
||||||
|
|
||||||
|
- **`getBluetoothVersion()`** - 获取蓝牙版本号
|
||||||
|
- **`getBluetoothVersionDetails()`** - 获取详细版本信息（含特性说明）
|
||||||
|
- **`getBluetoothVersionNumber()`** - 获取数字格式的版本号
|
||||||
|
|
||||||
|
### 2. 支持的蓝牙版本
|
||||||
|
|
||||||
|
| 蓝牙版本 | Android 版本 | 主要特性 |
|
||||||
|
|---------|-------------|---------|
|
||||||
|
| **5.4** | Android 14+ | LE Audio with LC3plus |
|
||||||
|
| **5.3** | Android 13+ | LE Audio (LC3编解码器) |
|
||||||
|
| **5.2** | Android 12+ | LE Audio 基础功能 |
|
||||||
|
| **5.1** | Android 10+ | 方向查找, GATT 缓存 |
|
||||||
|
| **5.0** | Android 8+ | 2Mbps PHY, Coded PHY, 扩展广播 |
|
||||||
|
| **4.2** | Android 6+ | 增强的 BLE |
|
||||||
|
| **4.1** | Android 5+ | BLE 连接改进 |
|
||||||
|
| **4.0** | Android 4.3+ | 低功耗蓝牙 (BLE) |
|
||||||
|
| **3.0** | Android 4.0- | 经典蓝牙 |
|
||||||
|
|
||||||
|
## 使用方法
|
||||||
|
|
||||||
|
### 1. 初始化
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
import com.xyzshell.andinfo.AndInfo
|
||||||
|
|
||||||
|
// 在 Application 或 Activity 中初始化
|
||||||
|
AndInfo.init(applicationContext)
|
||||||
|
|
||||||
|
// 获取 BluetoothInfo 实例
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 获取蓝牙版本（快捷方式）
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 方式1: 使用属性（最简单）
|
||||||
|
val version = bluetoothInfo.bluetoothVersion
|
||||||
|
println("蓝牙版本: $version")
|
||||||
|
// 输出示例: "5.3"
|
||||||
|
|
||||||
|
// 方式2: 使用方法
|
||||||
|
val version2 = bluetoothInfo.getBluetoothVersion()
|
||||||
|
println("蓝牙版本: $version2")
|
||||||
|
// 输出示例: "5.3"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 获取详细版本信息
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 获取包含特性说明的详细信息
|
||||||
|
val details = bluetoothInfo.getBluetoothVersionDetails()
|
||||||
|
println(details)
|
||||||
|
|
||||||
|
// 输出示例:
|
||||||
|
// "蓝牙 5.3 (LE Audio, 广播, 单播, 2Mbps PHY, Coded PHY)"
|
||||||
|
// "蓝牙 5.0 (2Mbps PHY, Coded PHY, 扩展广播)"
|
||||||
|
// "蓝牙 4.2 (低功耗蓝牙)"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 获取数字格式版本号
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 获取数字格式的版本号（用于版本比较）
|
||||||
|
val versionNumber = bluetoothInfo.getBluetoothVersionNumber()
|
||||||
|
println("版本号: $versionNumber")
|
||||||
|
// 输出示例: 5.3
|
||||||
|
|
||||||
|
// 版本比较
|
||||||
|
if (versionNumber >= 5.0) {
|
||||||
|
println("✅ 支持蓝牙 5.0 及以上特性")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 完整示例：显示蓝牙信息
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class BluetoothInfoActivity : AppCompatActivity() {
|
||||||
|
override fun onCreate(savedInstanceState: Bundle?) {
|
||||||
|
super.onCreate(savedInstanceState)
|
||||||
|
|
||||||
|
displayBluetoothInfo()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun displayBluetoothInfo() {
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
|
||||||
|
val info = buildString {
|
||||||
|
appendLine("╔════════════════════════════════╗")
|
||||||
|
appendLine("║ 设备蓝牙信息报告 ║")
|
||||||
|
appendLine("╚════════════════════════════════╝")
|
||||||
|
appendLine()
|
||||||
|
|
||||||
|
// 基本信息
|
||||||
|
appendLine("【基本信息】")
|
||||||
|
appendLine(" 蓝牙支持: ${if (bluetoothInfo.isSupported) "是" else "否"}")
|
||||||
|
appendLine(" 蓝牙启用: ${if (bluetoothInfo.isEnabled) "是" else "否"}")
|
||||||
|
appendLine(" 设备名称: ${bluetoothInfo.deviceName}")
|
||||||
|
appendLine(" 设备地址: ${bluetoothInfo.deviceAddress}")
|
||||||
|
appendLine()
|
||||||
|
|
||||||
|
// 版本信息
|
||||||
|
appendLine("【版本信息】")
|
||||||
|
appendLine(" 蓝牙版本: ${bluetoothInfo.getBluetoothVersion()}")
|
||||||
|
appendLine(" 详细信息: ${bluetoothInfo.getBluetoothVersionDetails()}")
|
||||||
|
appendLine()
|
||||||
|
|
||||||
|
// 特性支持
|
||||||
|
val features = bluetoothInfo.getBluetoothFeatures()
|
||||||
|
appendLine("【支持特性】")
|
||||||
|
appendLine(" 低功耗蓝牙: ${if (features.lowEnergy) "✓" else "✗"}")
|
||||||
|
appendLine(" 2Mbps PHY: ${if (features.le2MbPhy) "✓" else "✗"}")
|
||||||
|
appendLine(" Coded PHY: ${if (features.leCodedPhy) "✓" else "✗"}")
|
||||||
|
appendLine(" 扩展广播: ${if (features.leExtendedAdvertising) "✓" else "✗"}")
|
||||||
|
appendLine(" 周期性广播: ${if (features.lePeriodicAdvertising) "✓" else "✗"}")
|
||||||
|
|
||||||
|
if (bluetoothInfo.getBluetoothVersionNumber() >= 5.2) {
|
||||||
|
appendLine(" LE Audio: ${if (features.leAudio) "✓" else "✗"}")
|
||||||
|
if (features.leAudio) {
|
||||||
|
appendLine(" - 单播: ${if (features.leAudioUnicast) "✓" else "✗"}")
|
||||||
|
appendLine(" - 广播: ${if (features.leAudioBroadcast) "✓" else "✗"}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 配置文件支持
|
||||||
|
appendLine()
|
||||||
|
appendLine("【配置文件】")
|
||||||
|
val profiles = bluetoothInfo.getSupportedProfiles()
|
||||||
|
profiles.forEach { profile ->
|
||||||
|
appendLine(" • $profile")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
println(info)
|
||||||
|
// 或显示在 TextView 中
|
||||||
|
// textView.text = info
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. 版本特性判断
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
val version = bluetoothInfo.getBluetoothVersionNumber()
|
||||||
|
|
||||||
|
when {
|
||||||
|
version >= 5.4 -> {
|
||||||
|
println("🎉 蓝牙 5.4 - 最新旗舰")
|
||||||
|
println("支持特性:")
|
||||||
|
println(" • LE Audio with LC3plus")
|
||||||
|
println(" • 增强的音频质量")
|
||||||
|
println(" • 更低的延迟")
|
||||||
|
}
|
||||||
|
|
||||||
|
version >= 5.3 -> {
|
||||||
|
println("✨ 蓝牙 5.3 - 高端设备")
|
||||||
|
println("支持特性:")
|
||||||
|
println(" • LE Audio (LC3编解码器)")
|
||||||
|
println(" • 音频共享")
|
||||||
|
println(" • 广播音频")
|
||||||
|
}
|
||||||
|
|
||||||
|
version >= 5.2 -> {
|
||||||
|
println("✅ 蓝牙 5.2 - 中高端设备")
|
||||||
|
println("支持特性:")
|
||||||
|
println(" • LE Audio 基础功能")
|
||||||
|
println(" • LE Power Control")
|
||||||
|
println(" • 增强的 ATT")
|
||||||
|
}
|
||||||
|
|
||||||
|
version >= 5.1 -> {
|
||||||
|
println("✓ 蓝牙 5.1")
|
||||||
|
println("支持特性:")
|
||||||
|
println(" • 方向查找")
|
||||||
|
println(" • GATT 缓存")
|
||||||
|
}
|
||||||
|
|
||||||
|
version >= 5.0 -> {
|
||||||
|
println("✓ 蓝牙 5.0")
|
||||||
|
println("支持特性:")
|
||||||
|
println(" • 2倍速度 (2Mbps PHY)")
|
||||||
|
println(" • 4倍范围 (Coded PHY)")
|
||||||
|
println(" • 8倍广播容量")
|
||||||
|
}
|
||||||
|
|
||||||
|
version >= 4.0 -> {
|
||||||
|
println("✓ 蓝牙 4.x")
|
||||||
|
println("支持特性:")
|
||||||
|
println(" • 低功耗蓝牙 (BLE)")
|
||||||
|
println(" • 智能设备连接")
|
||||||
|
}
|
||||||
|
|
||||||
|
else -> {
|
||||||
|
println("⚠️ 蓝牙 3.0 或更低")
|
||||||
|
println("仅支持经典蓝牙")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7. 音频功能检查
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
val features = bluetoothInfo.getBluetoothFeatures()
|
||||||
|
|
||||||
|
// 检查是否支持高质量音频
|
||||||
|
fun canUseHighQualityAudio(): Boolean {
|
||||||
|
return when {
|
||||||
|
// LE Audio (最佳音质)
|
||||||
|
features.leAudio -> {
|
||||||
|
println("✅ 支持 LE Audio (最佳音质)")
|
||||||
|
println(" - 低延迟")
|
||||||
|
println(" - 高音质")
|
||||||
|
println(" - 支持多设备音频共享")
|
||||||
|
true
|
||||||
|
}
|
||||||
|
|
||||||
|
// 蓝牙 5.0+ (次优音质)
|
||||||
|
bluetoothInfo.getBluetoothVersionNumber() >= 5.0 -> {
|
||||||
|
println("✅ 支持蓝牙 5.0+ (良好音质)")
|
||||||
|
println(" - 更快的传输速度")
|
||||||
|
println(" - 更稳定的连接")
|
||||||
|
true
|
||||||
|
}
|
||||||
|
|
||||||
|
// 蓝牙 4.2+ (标准音质)
|
||||||
|
bluetoothInfo.getBluetoothVersionNumber() >= 4.2 -> {
|
||||||
|
println("✓ 支持蓝牙 4.2+ (标准音质)")
|
||||||
|
true
|
||||||
|
}
|
||||||
|
|
||||||
|
else -> {
|
||||||
|
println("⚠️ 音质可能较差")
|
||||||
|
false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 8. 设备兼容性检查
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 检查是否支持特定蓝牙功能
|
||||||
|
fun checkBluetoothCompatibility() {
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
val version = bluetoothInfo.getBluetoothVersionNumber()
|
||||||
|
|
||||||
|
println("设备兼容性检查:")
|
||||||
|
println()
|
||||||
|
|
||||||
|
// 智能家居设备
|
||||||
|
println("智能家居设备:")
|
||||||
|
if (version >= 4.0) {
|
||||||
|
println(" ✅ 支持低功耗智能设备")
|
||||||
|
println(" (智能灯泡、传感器、智能锁等)")
|
||||||
|
} else {
|
||||||
|
println(" ❌ 不支持现代智能设备")
|
||||||
|
}
|
||||||
|
println()
|
||||||
|
|
||||||
|
// 音频设备
|
||||||
|
println("音频设备:")
|
||||||
|
if (version >= 5.2) {
|
||||||
|
println(" ✅ 支持 LE Audio 耳机/音箱")
|
||||||
|
println(" (最佳音质，支持音频共享)")
|
||||||
|
} else if (version >= 5.0) {
|
||||||
|
println(" ✅ 支持蓝牙 5.0 耳机/音箱")
|
||||||
|
println(" (良好音质，稳定连接)")
|
||||||
|
} else if (version >= 4.0) {
|
||||||
|
println(" ✓ 支持标准蓝牙耳机/音箱")
|
||||||
|
}
|
||||||
|
println()
|
||||||
|
|
||||||
|
// 位置追踪设备
|
||||||
|
println("位置追踪设备:")
|
||||||
|
if (version >= 5.1) {
|
||||||
|
println(" ✅ 支持方向查找设备")
|
||||||
|
println(" (如 AirTag、SmartTag 等)")
|
||||||
|
} else {
|
||||||
|
println(" ⚠️ 不支持精确方向查找")
|
||||||
|
}
|
||||||
|
println()
|
||||||
|
|
||||||
|
// 可穿戴设备
|
||||||
|
println("可穿戴设备:")
|
||||||
|
if (version >= 5.0) {
|
||||||
|
println(" ✅ 支持长续航可穿戴设备")
|
||||||
|
println(" (智能手表、健身手环等)")
|
||||||
|
} else if (version >= 4.0) {
|
||||||
|
println(" ✓ 支持基础可穿戴设备")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 版本检测原理
|
||||||
|
|
||||||
|
### 检测依据
|
||||||
|
|
||||||
|
蓝牙版本通过以下特性进行判断：
|
||||||
|
|
||||||
|
1. **Bluetooth 5.4**
|
||||||
|
- Android 14+
|
||||||
|
- 支持 LE Audio
|
||||||
|
- 支持 LC3plus 编解码器
|
||||||
|
|
||||||
|
2. **Bluetooth 5.3**
|
||||||
|
- Android 13+
|
||||||
|
- 支持 LE Audio
|
||||||
|
- 支持音频广播
|
||||||
|
|
||||||
|
3. **Bluetooth 5.2**
|
||||||
|
- Android 12+
|
||||||
|
- 支持 LE Audio 基础功能
|
||||||
|
|
||||||
|
4. **Bluetooth 5.1**
|
||||||
|
- Android 10+
|
||||||
|
- 支持方向查找
|
||||||
|
- 支持 2Mbps PHY 或 Coded PHY 或扩展广播
|
||||||
|
|
||||||
|
5. **Bluetooth 5.0**
|
||||||
|
- Android 8+
|
||||||
|
- 支持 2Mbps PHY 或 Coded PHY
|
||||||
|
|
||||||
|
6. **Bluetooth 4.2**
|
||||||
|
- Android 6+
|
||||||
|
- 支持 BLE
|
||||||
|
|
||||||
|
7. **Bluetooth 4.1/4.0**
|
||||||
|
- 支持 BLE
|
||||||
|
|
||||||
|
8. **Bluetooth 3.0 或更低**
|
||||||
|
- 仅支持经典蓝牙
|
||||||
|
|
||||||
|
## 典型设备示例
|
||||||
|
|
||||||
|
### 高端旗舰（2023+）
|
||||||
|
```
|
||||||
|
蓝牙版本: 5.4
|
||||||
|
详细信息: 蓝牙 5.4 (LE Audio, 广播, 单播, 2Mbps PHY, Coded PHY)
|
||||||
|
代表设备: Samsung S24 Ultra, Pixel 8 Pro
|
||||||
|
```
|
||||||
|
|
||||||
|
### 高端设备（2022-2023）
|
||||||
|
```
|
||||||
|
蓝牙版本: 5.3
|
||||||
|
详细信息: 蓝牙 5.3 (LE Audio, 广播, 单播, 2Mbps PHY, Coded PHY)
|
||||||
|
代表设备: Samsung S23, Pixel 7 Pro
|
||||||
|
```
|
||||||
|
|
||||||
|
### 中高端设备（2021-2022）
|
||||||
|
```
|
||||||
|
蓝牙版本: 5.2
|
||||||
|
详细信息: 蓝牙 5.2 (LE Audio, LE Power Control)
|
||||||
|
代表设备: Samsung S21, Pixel 6
|
||||||
|
```
|
||||||
|
|
||||||
|
### 主流设备（2019-2021）
|
||||||
|
```
|
||||||
|
蓝牙版本: 5.0
|
||||||
|
详细信息: 蓝牙 5.0 (2Mbps PHY, Coded PHY, 扩展广播)
|
||||||
|
代表设备: Pixel 4, Mi 10
|
||||||
|
```
|
||||||
|
|
||||||
|
## 示例输出
|
||||||
|
|
||||||
|
### 完整信息输出
|
||||||
|
```
|
||||||
|
╔════════════════════════════════╗
|
||||||
|
║ 设备蓝牙信息报告 ║
|
||||||
|
╚════════════════════════════════╝
|
||||||
|
|
||||||
|
【基本信息】
|
||||||
|
蓝牙支持: 是
|
||||||
|
蓝牙启用: 是
|
||||||
|
设备名称: Pixel 8 Pro
|
||||||
|
设备地址: AA:BB:CC:DD:EE:FF
|
||||||
|
|
||||||
|
【版本信息】
|
||||||
|
蓝牙版本: 5.3
|
||||||
|
详细信息: 蓝牙 5.3 (LE Audio, 广播, 单播, 2Mbps PHY, Coded PHY)
|
||||||
|
|
||||||
|
【支持特性】
|
||||||
|
低功耗蓝牙: ✓
|
||||||
|
2Mbps PHY: ✓
|
||||||
|
Coded PHY: ✓
|
||||||
|
扩展广播: ✓
|
||||||
|
周期性广播: ✓
|
||||||
|
LE Audio: ✓
|
||||||
|
- 单播: ✓
|
||||||
|
- 广播: ✓
|
||||||
|
|
||||||
|
【配置文件】
|
||||||
|
• A2DP (高级音频分发)
|
||||||
|
• HFP (免提配置)
|
||||||
|
• AVRCP (音视频遥控)
|
||||||
|
• HID (人机接口设备)
|
||||||
|
• PAN (个人区域网络)
|
||||||
|
• PBAP (电话簿访问)
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. **Android 版本限制**：
|
||||||
|
- 蓝牙 5.4 需要 Android 14+
|
||||||
|
- 蓝牙 5.3 需要 Android 13+
|
||||||
|
- 蓝牙 5.2 需要 Android 12+
|
||||||
|
- 蓝牙 5.0 需要 Android 8+
|
||||||
|
|
||||||
|
2. **硬件支持**：
|
||||||
|
- 即使 Android 版本满足，也需要硬件芯片支持
|
||||||
|
- 某些功能需要特定的蓝牙芯片
|
||||||
|
|
||||||
|
3. **权限要求**：
|
||||||
|
- 获取蓝牙版本不需要特殊权限
|
||||||
|
- 扫描设备需要位置权限（Android 6+）
|
||||||
|
- 连接设备需要蓝牙权限
|
||||||
|
|
||||||
|
4. **<EFBFBD><EFBFBD><EFBFBD>确性**：
|
||||||
|
- 版本判断基于支持的特性
|
||||||
|
- 实际蓝牙芯片版本可能更高
|
||||||
|
- 某些功能可能被厂商禁用
|
||||||
|
|
||||||
|
## 完成度
|
||||||
|
|
||||||
|
✅ **100%** - 所有功能都已实现
|
||||||
|
- 蓝牙版本检测（3.0-5.4）✅
|
||||||
|
- 快捷属性访问 ✅
|
||||||
|
- 详细版本信息 ✅
|
||||||
|
- 数字版本号 ✅
|
||||||
|
- 特性判断 ✅
|
||||||
|
- 完整的中文注释 ✅
|
||||||
|
- 详细的使用文档 ✅
|
||||||
|
|
||||||
|
所有功能都已正确实现并可以使用！🎉
|
||||||
|
|
||||||
307
BuildInfo数据库字段对应关系.md
Normal file
307
BuildInfo数据库字段对应关系.md
Normal file
@ -0,0 +1,307 @@
|
|||||||
|
# BuildInfo 与数据库字段对应关系
|
||||||
|
|
||||||
|
## 数据库表 `phone.build` 字段映射
|
||||||
|
|
||||||
|
### ✅ 已完全实现的字段
|
||||||
|
|
||||||
|
| 数据库字段 | BuildInfo 属性 | Android API | 说明 |
|
||||||
|
|-----------|---------------|-------------|------|
|
||||||
|
| brand | `brand` | `Build.BRAND` | 品牌 |
|
||||||
|
| model | `model` | `Build.MODEL` | 机型 |
|
||||||
|
| product | `product` | `Build.PRODUCT` | 产品名称 (如 x1seea) |
|
||||||
|
| sdkInt | `versionSdkInt` | `Build.VERSION.SDK_INT` | SDK 版本 |
|
||||||
|
| androidVersion | `versionRelease` | `Build.VERSION.RELEASE` | Android 版本 |
|
||||||
|
| buildId | `id` | `Build.ID` | 构建 ID (如 AP3A.240905.015.A2) |
|
||||||
|
| bootloader | `bootloaderVersion` | `Build.BOOTLOADER` | Bootloader 版本 |
|
||||||
|
| display | `display` | `Build.DISPLAY` | 显示 ID |
|
||||||
|
| buildUser | `user` | `Build.USER` | 构建用户 |
|
||||||
|
| incremental | `incremental` | `Build.VERSION.INCREMENTAL` | 增量版本 |
|
||||||
|
| buildHost | `host` | `Build.HOST` | 构建主机 |
|
||||||
|
| buildFingerprint | `fingerprint` | `Build.FINGERPRINT` | 构建指纹 |
|
||||||
|
| kernelVersion | `kernelVersion` | `System.getProperty("os.version")` | 内核版本 |
|
||||||
|
| securityPatch | `securityPatch` | `Build.VERSION.SECURITY_PATCH` | 安全补丁日期 |
|
||||||
|
| releaseDate | `buildDate` | `Build.TIME` | 构建时间 |
|
||||||
|
|
||||||
|
### ✅ 新增的字段（三星设备特定）
|
||||||
|
|
||||||
|
| 数据库字段 | BuildInfo 属性 | 系统属性 | 说明 |
|
||||||
|
|-----------|---------------|---------|------|
|
||||||
|
| rilProductCode | `rilProductCode` | `ro.ril.product_code` | RIL 产品代码 |
|
||||||
|
| rilOfficialCscver | `rilOfficialCscver` | `ro.ril.official_cscver` | RIL 官方 CSC 版本 |
|
||||||
|
| cscSalesCode | `cscSalesCode` | `ro.csc.sales_code` | CSC 销售代码 |
|
||||||
|
| countryISO | `countryISO` | `ro.product.locale.region` | 国家/地区 ISO 代码 |
|
||||||
|
|
||||||
|
### 📝 需要在应用层处理的字段
|
||||||
|
|
||||||
|
| 数据库字段 | 说明 | 建议获取方式 |
|
||||||
|
|-----------|------|-------------|
|
||||||
|
| buildIdGD | 人工生成的构建 ID | 应用层生成 |
|
||||||
|
| incrementalGD | 人工生成的增量版本 | 应用层生成 |
|
||||||
|
| isManual | 是否人工录入 | 应用层标记 |
|
||||||
|
| sourceId | 数据源 ID | 应用层管理 |
|
||||||
|
| sourceTable | 数据源表 | 应用层管理 |
|
||||||
|
| updatedOn | 更新时间 | 数据库自动生成 |
|
||||||
|
| dataStatus | 数据状态 (1为准确可用) | 应用层管理 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 数据库表 `phone.hardware_new` 字段映射
|
||||||
|
|
||||||
|
### ✅ 已完全实现的字段
|
||||||
|
|
||||||
|
| 数据库字段 | BuildInfo/其他模块 属性 | Android API | 说明 |
|
||||||
|
|-----------|----------------------|-------------|------|
|
||||||
|
| brand | `brand` | `Build.BRAND` | 品牌 |
|
||||||
|
| model | `model` | `Build.MODEL` | 设备型号 |
|
||||||
|
| device | `device` | `Build.DEVICE` | 设备代号 |
|
||||||
|
| board | `board` | `Build.BOARD` | 主板名称 |
|
||||||
|
| manufacturer | `manufacturer` | `Build.MANUFACTURER` | 制造商 |
|
||||||
|
| hardware | `hardware` | `Build.HARDWARE` | 硬件标识 |
|
||||||
|
| formFactor | `formFactor` | 复合判断 | 设备类型 (Phone/Tablet) |
|
||||||
|
| linuxArchitecture | `kernelArchitecture` | `System.getProperty("os.arch")` | Linux 架构 |
|
||||||
|
|
||||||
|
### ⚠️ 部分实现或需要其他模块的字段
|
||||||
|
|
||||||
|
| 数据库字段 | 对应模块 | 说明 |
|
||||||
|
|-----------|---------|------|
|
||||||
|
| marketingName | ❌ 未实现 | 需要从设备数据库或 API 获取 |
|
||||||
|
| shortName | ❌ 未实现 | 需要从 marketingName 处理生成 |
|
||||||
|
| systemonChip | ⚠️ CpuInfo | 需要从 CPU 信息推导 SoC 名称 |
|
||||||
|
| screenSize | ⚠️ DisplayInfo | 屏幕尺寸（英寸） |
|
||||||
|
| screenSizecm | ⚠️ DisplayInfo | 屏幕尺寸（平方厘米） |
|
||||||
|
| maxWidthPixels | ⚠️ DisplayInfo | 最大宽度像素 |
|
||||||
|
| maxHeightPixels | ⚠️ DisplayInfo | 最大高度像素 |
|
||||||
|
| dpi | ⚠️ DisplayInfo | 物理 DPI |
|
||||||
|
| maxRefreshRate | ⚠️ DisplayInfo | 最大刷新率 |
|
||||||
|
| ramType | ⚠️ MemInfo | RAM 类型 (LPDDR5 等) |
|
||||||
|
| totalMemoryGB | ⚠️ DeviceInfo/MemInfo | 总内存 |
|
||||||
|
| totalStorageGB | ⚠️ StorageInfo | 总存储空间 |
|
||||||
|
| supportEsim | ⚠️ NetworkInfo | 是否支持 eSIM |
|
||||||
|
| simSlotCount | ⚠️ NetworkInfo | SIM 卡槽数量 |
|
||||||
|
| batteryDesignCapacity | ⚠️ BatteryInfo | 电池设计容量 |
|
||||||
|
| batteryWirelessSupported | ⚠️ BatteryInfo | 是否支持无线充电 |
|
||||||
|
| cellularGen | ⚠️ NetworkInfo | 最大网络类型 (3G/4G/5G) |
|
||||||
|
| maxWifiVersion | ⚠️ NetworkInfo | 最大 Wi-Fi 版本 |
|
||||||
|
| bluetoothVersion | ⚠️ BluetoothInfo | 蓝牙版本 |
|
||||||
|
| hasNFC | ⚠️ 未实现 | 是否支持 NFC |
|
||||||
|
|
||||||
|
### 📝 需要外部数据或人工处理的字段
|
||||||
|
|
||||||
|
| 数据库字段 | 说明 | 建议获取方式 |
|
||||||
|
|-----------|------|-------------|
|
||||||
|
| boardGD | 人工生成的主板名称 | 应用层生成 |
|
||||||
|
| hardwareGD | 人工生成的硬件标识 | 应用层生成 |
|
||||||
|
| isFold | 是否折叠机 | 需要外部数据库或规则判断 |
|
||||||
|
| releasedDate | 产品发布时间 | 需要外部数据库 |
|
||||||
|
| weight | 设备重量 | 需要外部数据库 |
|
||||||
|
| releasedAndroidVersion | 发布时 Android 版本 | 需要外部数据库 |
|
||||||
|
| supportAndroidMaxVersion | 最大支持 Android 版本 | 需要外部数据库 |
|
||||||
|
| price | 价格（美元） | 需要外部数据库 |
|
||||||
|
| sourceId | 数据源 ID | 应用层管理 |
|
||||||
|
| updatedOn | 更新时间 | 数据库自动生成 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📋 BuildInfo.kt 已实现的完整字段列表
|
||||||
|
|
||||||
|
### 基本构建信息
|
||||||
|
- ✅ `fingerprint` - 构建指纹
|
||||||
|
- ✅ `brand` - 品牌
|
||||||
|
- ✅ `model` - 机型
|
||||||
|
- ✅ `product` - 产品名称
|
||||||
|
- ✅ `device` - 设备代号
|
||||||
|
- ✅ `board` - 主板名称
|
||||||
|
- ✅ `manufacturer` - 制造商
|
||||||
|
- ✅ `hardware` - 硬件标识
|
||||||
|
- ✅ `tags` - 构建标签
|
||||||
|
- ✅ `type` - 构建类型
|
||||||
|
- ✅ `buildDate` - 构建日期
|
||||||
|
- ✅ `host` - 构建主机
|
||||||
|
- ✅ `user` - 构建用户
|
||||||
|
- ✅ `id` - 构建 ID
|
||||||
|
- ✅ `display` - 显示 ID
|
||||||
|
|
||||||
|
### Android 版本信息
|
||||||
|
- ✅ `versionRelease` - Android 版本号
|
||||||
|
- ✅ `versionCodename` - 版本代号
|
||||||
|
- ✅ `versionSdkInt` - SDK 版本
|
||||||
|
- ✅ `versionPreviewSdkInt` - 预览版 SDK
|
||||||
|
- ✅ `securityPatch` - 安全补丁级别
|
||||||
|
- ✅ `baseOs` - 基础操作系统
|
||||||
|
- ✅ `incremental` - 增量版本
|
||||||
|
- ✅ `releaseOrCodename` - 版本号或代号
|
||||||
|
- ✅ `mediaPerformanceClass` - 媒体性能等级
|
||||||
|
- ✅ `releaseOrPreviewDisplay` - 版本显示字符串
|
||||||
|
|
||||||
|
### RIL 和 CSC 信息（三星设备）
|
||||||
|
- ✅ `rilProductCode` - RIL 产品代码
|
||||||
|
- ✅ `rilOfficialCscver` - RIL 官方 CSC 版本
|
||||||
|
- ✅ `cscSalesCode` - CSC 销售代码
|
||||||
|
- ✅ `countryISO` - 国家/地区 ISO 代码
|
||||||
|
|
||||||
|
### 设备类型
|
||||||
|
- ✅ `formFactor` - 设备类型 (Phone/Tablet)
|
||||||
|
- ✅ `isTablet` - 是否为平板
|
||||||
|
- ✅ `isPhone` - 是否为手机
|
||||||
|
|
||||||
|
### JVM 信息
|
||||||
|
- ✅ `jvmName` - JVM 名称
|
||||||
|
- ✅ `jvmVendor` - JVM 供应商
|
||||||
|
- ✅ `jvmVersion` - JVM 版本
|
||||||
|
- ✅ `jvmClassVersion` - Java 类版本
|
||||||
|
- ✅ `jvmSpecificationName` - Java 规范名称
|
||||||
|
- ✅ `jvmSpecificationVendor` - Java 规范供应商
|
||||||
|
- ✅ `jvmSpecificationVersion` - Java 规范版本
|
||||||
|
|
||||||
|
### 安全与内核信息
|
||||||
|
- ✅ `vendorSecurityPatchLevel` - 厂商安全补丁
|
||||||
|
- ✅ `kernelVersion` - 内核版本号
|
||||||
|
- ✅ `kernelCompleteVersion` - 完整内核版本
|
||||||
|
- ✅ `kernelArchitecture` - 内核架构
|
||||||
|
- ✅ `kernelName` - 内核名称
|
||||||
|
- ✅ `kernelCommandLine` - 内核命令行
|
||||||
|
- ✅ `bootloaderVersion` - Bootloader 版本
|
||||||
|
- ✅ `radioVersion` - 基带版本
|
||||||
|
- ✅ `procCpuInfo` - CPU 信息
|
||||||
|
- ✅ `procMemInfo` - 内存信息
|
||||||
|
|
||||||
|
### 分区信息
|
||||||
|
- ✅ `fingerprintedPartitions` - 指纹分区列表
|
||||||
|
|
||||||
|
### Treble 和系统更新
|
||||||
|
- ✅ `isTrebleEnabled` - Treble 支持
|
||||||
|
- ✅ `trebleVersion` - Treble 版本
|
||||||
|
- ✅ `isSeamlessUpdateSupported` - 无缝更新支持
|
||||||
|
- ✅ `currentSlot` - 当前活动插槽
|
||||||
|
- ✅ `isVirtualABEnabled` - 虚拟 A/B 支持
|
||||||
|
|
||||||
|
### Root 和安全
|
||||||
|
- ✅ `isRooted` - Root 状态
|
||||||
|
- ✅ `seLinuxStatus` - SELinux 状态
|
||||||
|
- ✅ `isDmVerityEnabled` - dm-verity 状态
|
||||||
|
|
||||||
|
### Google Play 服务
|
||||||
|
- ✅ `googlePlayServicesVersion` - Play 服务版本
|
||||||
|
- ✅ `googlePlayServicesVersionCode` - Play 服务版本代码
|
||||||
|
- ✅ `googlePlayStoreVersion` - Play 商店版本
|
||||||
|
- ✅ `googleServicesFrameworkVersion` - GSF 版本
|
||||||
|
|
||||||
|
### 系统工具
|
||||||
|
- ✅ `toyboxVersion` - Toybox 版本
|
||||||
|
- ✅ `toolboxVersion` - Toolbox 版本
|
||||||
|
- ✅ `busyboxVersion` - BusyBox 版本
|
||||||
|
|
||||||
|
### SSL/TLS
|
||||||
|
- ✅ `openSslVersion` - OpenSSL 版本
|
||||||
|
- ✅ `boringSslVersion` - BoringSSL 版本
|
||||||
|
- ✅ `tlsVersion` - TLS 版本
|
||||||
|
|
||||||
|
### 语言和时区
|
||||||
|
- ✅ `systemLanguage` - 系统语言
|
||||||
|
- ✅ `languageCode` - 语言代码
|
||||||
|
- ✅ `country` - 国家/地区
|
||||||
|
- ✅ `countryCode` - 国家/地区代码
|
||||||
|
- ✅ `timeZone` - 系统时区
|
||||||
|
- ✅ `timeZoneDisplayName` - 时区显示名称
|
||||||
|
- ✅ `timeZoneOffset` - UTC 偏移
|
||||||
|
|
||||||
|
### 开发者选项
|
||||||
|
- ✅ `isUsbDebuggingEnabled` - USB 调试
|
||||||
|
- ✅ `isDevelopmentSettingsEnabled` - 开发者选项
|
||||||
|
- ✅ `isUnknownSourcesEnabled` - 未知来源安装
|
||||||
|
|
||||||
|
### 设备标识符
|
||||||
|
- ✅ `androidId` - Android ID
|
||||||
|
- ✅ `serialNumber` - 序列号
|
||||||
|
- ✅ `deviceUniqueId` - 设备唯一 ID
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔍 缺失字段总结
|
||||||
|
|
||||||
|
### phone.build 表
|
||||||
|
**完全实现**: ✅ 15/15 个核心字段
|
||||||
|
**新增三星专用字段**: ✅ 4/4 个
|
||||||
|
**需应用层处理**: 7 个（buildIdGD, incrementalGD, isManual 等）
|
||||||
|
|
||||||
|
### phone.hardware_new 表
|
||||||
|
**完全实现**: ✅ 8/8 个基本字段
|
||||||
|
**需其他模块**: ⚠️ 16 个（DisplayInfo, NetworkInfo, BatteryInfo 等）
|
||||||
|
**需外部数据**: ❌ 10 个（marketingName, releasedDate, price 等）
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📊 使用示例
|
||||||
|
|
||||||
|
### 获取 build 表所需数据
|
||||||
|
```kotlin
|
||||||
|
val buildInfo = AndInfo.instance.build
|
||||||
|
|
||||||
|
val buildData = mapOf(
|
||||||
|
"brand" to buildInfo.brand,
|
||||||
|
"model" to buildInfo.model,
|
||||||
|
"product" to buildInfo.product,
|
||||||
|
"sdkInt" to buildInfo.versionSdkInt,
|
||||||
|
"androidVersion" to buildInfo.versionRelease,
|
||||||
|
"buildId" to buildInfo.id,
|
||||||
|
"bootloader" to buildInfo.bootloaderVersion,
|
||||||
|
"display" to buildInfo.display,
|
||||||
|
"buildUser" to buildInfo.user,
|
||||||
|
"incremental" to buildInfo.incremental,
|
||||||
|
"buildHost" to buildInfo.host,
|
||||||
|
"buildFingerprint" to buildInfo.fingerprint,
|
||||||
|
"rilProductCode" to buildInfo.rilProductCode,
|
||||||
|
"rilOfficialCscver" to buildInfo.rilOfficialCscver,
|
||||||
|
"cscSalesCode" to buildInfo.cscSalesCode,
|
||||||
|
"countryISO" to buildInfo.countryISO,
|
||||||
|
"kernelVersion" to buildInfo.kernelVersion,
|
||||||
|
"securityPatch" to buildInfo.securityPatch,
|
||||||
|
"releaseDate" to buildInfo.buildDate
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 获取 hardware_new 表基本字段
|
||||||
|
```kotlin
|
||||||
|
val buildInfo = AndInfo.instance.build
|
||||||
|
|
||||||
|
val hardwareData = mapOf(
|
||||||
|
"brand" to buildInfo.brand,
|
||||||
|
"model" to buildInfo.model,
|
||||||
|
"formFactor" to buildInfo.formFactor,
|
||||||
|
"device" to buildInfo.device,
|
||||||
|
"board" to buildInfo.board,
|
||||||
|
"manufacturer" to buildInfo.manufacturer,
|
||||||
|
"hardware" to buildInfo.hardware,
|
||||||
|
"linuxArchitecture" to buildInfo.kernelArchitecture
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ✅ 总结
|
||||||
|
|
||||||
|
### BuildInfo.kt 已实现
|
||||||
|
- ✅ **phone.build 表**: 15/15 核心字段 + 4 个三星专用字段
|
||||||
|
- ✅ **phone.hardware_new 表**: 8/8 基本字段
|
||||||
|
- ✅ **额外功能**: 60+ 个系统信息属性
|
||||||
|
|
||||||
|
### 需要其他模块支持
|
||||||
|
- DisplayInfo: 屏幕相关字段
|
||||||
|
- NetworkInfo: 网络和 SIM 卡相关字段
|
||||||
|
- BatteryInfo: 电池相关字段
|
||||||
|
- StorageInfo: 存储相关字段
|
||||||
|
- BluetoothInfo: 蓝牙相关字段
|
||||||
|
- MemInfo: 内存类型相关字段
|
||||||
|
|
||||||
|
### 需要外部数据源
|
||||||
|
- marketingName（市场名称）
|
||||||
|
- releasedDate（发布日期）
|
||||||
|
- price（价格）
|
||||||
|
- weight（重量）
|
||||||
|
- 等规格参数需要从产品数据库获取
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**最后更新**: 2025年12月24日
|
||||||
|
**BuildInfo.kt 版本**: 完整版
|
||||||
|
|
||||||
421
DeviceInfo-DeviceID和GAID使用示例.md
Normal file
421
DeviceInfo-DeviceID和GAID使用示例.md
Normal file
@ -0,0 +1,421 @@
|
|||||||
|
# DeviceInfo - Device ID 和 GAID 使用示例
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
DeviceInfo 类现在提供了完整的设备标识符获取功能，包括 Android ID (Device ID) 和 Google Advertising ID (GAID)。
|
||||||
|
|
||||||
|
## 新增功能
|
||||||
|
|
||||||
|
### 1. Android ID (Device ID)
|
||||||
|
- `getAndroidId()` - 获取 Android ID
|
||||||
|
|
||||||
|
### 2. Google Advertising ID (GAID)
|
||||||
|
- `getAdvertisingId()` - 协程方式获取 GAID（推荐）
|
||||||
|
- `getAdvertisingIdSync()` - 同步方式获取 GAID（不推荐）
|
||||||
|
- `getDeviceIdentifiers()` - 获取所有标识符
|
||||||
|
|
||||||
|
### 3. 数据类
|
||||||
|
- `AdvertisingIdInfo` - GAID 信息
|
||||||
|
- `DeviceIdentifiers` - 设备标识符集合
|
||||||
|
|
||||||
|
## 使用方法
|
||||||
|
|
||||||
|
### 1. 初始化
|
||||||
|
```kotlin
|
||||||
|
import com.xyzshell.andinfo.AndInfo
|
||||||
|
|
||||||
|
// 在 Application 或 Activity 中初始化
|
||||||
|
AndInfo.init(applicationContext)
|
||||||
|
|
||||||
|
// 获取 DeviceInfo 实例
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 获取 Android ID (Device ID)
|
||||||
|
|
||||||
|
#### 基本使用
|
||||||
|
```kotlin
|
||||||
|
// 获取 Android ID
|
||||||
|
val androidId = deviceInfo.getAndroidId()
|
||||||
|
println("Android ID: $androidId")
|
||||||
|
// 输出示例: "Android ID: 9774d56d682e549c"
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Android ID 特点
|
||||||
|
- **格式**: 64位十六进制字符串
|
||||||
|
- **生成时机**: 设备首次启动时随机生成
|
||||||
|
- **持久性**:
|
||||||
|
- 出厂重置后会改变
|
||||||
|
- 清除应用数据不会改变
|
||||||
|
- **作用域**:
|
||||||
|
- Android 8.0+ 后，每个应用和用户组合都会获得不同的 Android ID
|
||||||
|
- Android 8.0 之前，所有应用获得相同的 Android ID
|
||||||
|
- **权限**: 不需要特殊权限
|
||||||
|
|
||||||
|
#### 适用场景
|
||||||
|
```kotlin
|
||||||
|
// 1. 应用级设备标识
|
||||||
|
fun getDeviceTag(): String {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
return "device_${deviceInfo.getAndroidId()}"
|
||||||
|
}
|
||||||
|
|
||||||
|
// 2. 用户设备绑定
|
||||||
|
fun bindDeviceToUser(userId: String) {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val androidId = deviceInfo.getAndroidId()
|
||||||
|
// 将 androidId 与 userId 关联存储
|
||||||
|
saveBinding(userId, androidId)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 3. 设备唯一性校验
|
||||||
|
fun isNewDevice(): Boolean {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val androidId = deviceInfo.getAndroidId()
|
||||||
|
return !isDeviceRegistered(androidId)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 获取 GAID (Google Advertising ID)
|
||||||
|
|
||||||
|
#### 协程方式（推荐）
|
||||||
|
```kotlin
|
||||||
|
import androidx.lifecycle.lifecycleScope
|
||||||
|
import kotlinx.coroutines.launch
|
||||||
|
|
||||||
|
// 在 Activity 或 Fragment 中
|
||||||
|
lifecycleScope.launch {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
|
||||||
|
if (gaidInfo != null) {
|
||||||
|
println("GAID: ${gaidInfo.id}")
|
||||||
|
println("是否限制追踪: ${gaidInfo.isLimitAdTrackingEnabled}")
|
||||||
|
|
||||||
|
// 根据追踪限制状态决定是否使用
|
||||||
|
if (!gaidInfo.isLimitAdTrackingEnabled) {
|
||||||
|
// 用户允许广告追踪，可以使用 GAID
|
||||||
|
sendToAnalytics(gaidInfo.id)
|
||||||
|
} else {
|
||||||
|
// 用户限制了广告追踪，应该尊重用户选择
|
||||||
|
println("用户已限制广告追踪")
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// Google Play Services 不可用
|
||||||
|
println("无法获取 GAID（设备可能没有 Google Play Services）")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 在 ViewModel 中使用
|
||||||
|
```kotlin
|
||||||
|
class MainViewModel : ViewModel() {
|
||||||
|
fun loadAdvertisingId() {
|
||||||
|
viewModelScope.launch {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
|
||||||
|
gaidInfo?.let { info ->
|
||||||
|
_advertisingId.value = info.id
|
||||||
|
_isTrackingLimited.value = info.isLimitAdTrackingEnabled
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 同步方式（不推荐）
|
||||||
|
```kotlin
|
||||||
|
// ⚠️ 警告：会阻塞当前线程，不要在主线程调用
|
||||||
|
Thread {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingIdSync()
|
||||||
|
|
||||||
|
gaidInfo?.let { info ->
|
||||||
|
println("GAID: ${info.id}")
|
||||||
|
}
|
||||||
|
}.start()
|
||||||
|
```
|
||||||
|
|
||||||
|
#### GAID 特点
|
||||||
|
- **格式**: UUID 格式的字符串
|
||||||
|
- **示例**: "38400000-8cf0-11bd-b23e-10b96e40000d"
|
||||||
|
- **依赖**: 需要 Google Play Services
|
||||||
|
- **用户控制**:
|
||||||
|
- 用户可以在设置中重置 GAID
|
||||||
|
- 用户可以选择限制广告追踪
|
||||||
|
- **权限**: 不需要特殊权限，但需要 Google Play Services
|
||||||
|
- **线程**: 必须在后台线程调用
|
||||||
|
|
||||||
|
### 4. 获取所有设备标识符
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 一次性获取所有标识符
|
||||||
|
lifecycleScope.launch {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val identifiers = deviceInfo.getDeviceIdentifiers()
|
||||||
|
|
||||||
|
println("=== 设备标识符 ===")
|
||||||
|
println("Android ID: ${identifiers.androidId}")
|
||||||
|
|
||||||
|
identifiers.advertisingId?.let { gaid ->
|
||||||
|
println("GAID: ${gaid.id}")
|
||||||
|
println("限制追踪: ${gaid.isLimitAdTrackingEnabled}")
|
||||||
|
} ?: run {
|
||||||
|
println("GAID: 不可用")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 完整示例：设备信息收集
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class DeviceInfoActivity : AppCompatActivity() {
|
||||||
|
override fun onCreate(savedInstanceState: Bundle?) {
|
||||||
|
super.onCreate(savedInstanceState)
|
||||||
|
|
||||||
|
lifecycleScope.launch {
|
||||||
|
collectDeviceInfo()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private suspend fun collectDeviceInfo() {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
|
||||||
|
// 基本设备信息
|
||||||
|
val brand = deviceInfo.brand
|
||||||
|
val model = deviceInfo.model
|
||||||
|
val manufacturer = deviceInfo.manufacturer
|
||||||
|
|
||||||
|
// 设备标识符
|
||||||
|
val androidId = deviceInfo.getAndroidId()
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
|
||||||
|
// 显示信息
|
||||||
|
val info = buildString {
|
||||||
|
appendLine("=== 设备信息 ===")
|
||||||
|
appendLine("品牌: $brand")
|
||||||
|
appendLine("型号: $model")
|
||||||
|
appendLine("制造商: $manufacturer")
|
||||||
|
appendLine()
|
||||||
|
appendLine("=== 设备标识符 ===")
|
||||||
|
appendLine("Android ID: $androidId")
|
||||||
|
|
||||||
|
if (gaidInfo != null) {
|
||||||
|
appendLine("GAID: ${gaidInfo.id}")
|
||||||
|
appendLine("限制追踪: ${if (gaidInfo.isLimitAdTrackingEnabled) "是" else "否"}")
|
||||||
|
} else {
|
||||||
|
appendLine("GAID: 不可用（可能没有 Google Play Services）")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
println(info)
|
||||||
|
// 或显示在 UI 上
|
||||||
|
// textView.text = info
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 数据结构
|
||||||
|
|
||||||
|
### AdvertisingIdInfo
|
||||||
|
```kotlin
|
||||||
|
/**
|
||||||
|
* 广告标识符信息数据类
|
||||||
|
*/
|
||||||
|
data class AdvertisingIdInfo(
|
||||||
|
val id: String, // GAID
|
||||||
|
val isLimitAdTrackingEnabled: Boolean // 是否限制广告追踪
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
### DeviceIdentifiers
|
||||||
|
```kotlin
|
||||||
|
/**
|
||||||
|
* 设备标识符集合数据类
|
||||||
|
*/
|
||||||
|
data class DeviceIdentifiers(
|
||||||
|
val androidId: String, // Android ID
|
||||||
|
val advertisingId: AdvertisingIdInfo? // GAID（可能为 null）
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Android ID vs GAID 对比
|
||||||
|
|
||||||
|
| 特性 | Android ID | GAID |
|
||||||
|
|------|-----------|------|
|
||||||
|
| **格式** | 64位十六进制 | UUID |
|
||||||
|
| **示例** | 9774d56d682e549c | 38400000-8cf0-11bd-b23e-10b96e40000d |
|
||||||
|
| **依赖** | 无 | Google Play Services |
|
||||||
|
| **权限** | 无需权限 | 无需权限 |
|
||||||
|
| **重置** | 出厂重置后改变 | 用户可随时重置 |
|
||||||
|
| **作用域** | Android 8.0+ 按应用区分 | 全局统一 |
|
||||||
|
| **用户控制** | 不可控制 | 可限制追踪 |
|
||||||
|
| **适用场景** | 应用内标识、设备绑定 | 广告追踪、分析 |
|
||||||
|
| **隐私友好** | 中等 | 高（用户可控） |
|
||||||
|
|
||||||
|
## 典型应用场景
|
||||||
|
|
||||||
|
### 1. 广告归因
|
||||||
|
```kotlin
|
||||||
|
suspend fun trackAdConversion(campaignId: String) {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
|
||||||
|
if (gaidInfo != null && !gaidInfo.isLimitAdTrackingEnabled) {
|
||||||
|
// 用户允许追踪，上报转化数据
|
||||||
|
analyticsService.trackConversion(
|
||||||
|
gaid = gaidInfo.id,
|
||||||
|
campaignId = campaignId
|
||||||
|
)
|
||||||
|
} else {
|
||||||
|
// 使用匿名方式或不追踪
|
||||||
|
analyticsService.trackAnonymousConversion(campaignId)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 用户设备管理
|
||||||
|
```kotlin
|
||||||
|
suspend fun registerDevice() {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val identifiers = deviceInfo.getDeviceIdentifiers()
|
||||||
|
|
||||||
|
// 注册设备信息
|
||||||
|
val deviceProfile = DeviceProfile(
|
||||||
|
androidId = identifiers.androidId,
|
||||||
|
brand = deviceInfo.brand,
|
||||||
|
model = deviceInfo.model,
|
||||||
|
timestamp = System.currentTimeMillis()
|
||||||
|
)
|
||||||
|
|
||||||
|
saveDeviceProfile(deviceProfile)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 防作弊检测
|
||||||
|
```kotlin
|
||||||
|
suspend fun checkDeviceFraud(): Boolean {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val androidId = deviceInfo.getAndroidId()
|
||||||
|
|
||||||
|
// 检查设备是否被标记为作弊
|
||||||
|
return fraudDetectionService.isDeviceFlagged(androidId)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. A/B 测试分组
|
||||||
|
```kotlin
|
||||||
|
suspend fun getExperimentGroup(): String {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
|
||||||
|
// 使用 GAID 的哈希值进行分组
|
||||||
|
val deviceId = gaidInfo?.id ?: deviceInfo.getAndroidId()
|
||||||
|
val hash = deviceId.hashCode()
|
||||||
|
|
||||||
|
return if (hash % 2 == 0) "GroupA" else "GroupB"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 隐私合规检查
|
||||||
|
```kotlin
|
||||||
|
suspend fun checkPrivacyCompliance(): PrivacyStatus {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
|
||||||
|
return PrivacyStatus(
|
||||||
|
hasGooglePlayServices = gaidInfo != null,
|
||||||
|
isTrackingLimited = gaidInfo?.isLimitAdTrackingEnabled ?: true,
|
||||||
|
canUsePersonalizedAds = gaidInfo?.let { !it.isLimitAdTrackingEnabled } ?: false
|
||||||
|
)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 依赖配置
|
||||||
|
|
||||||
|
要使用 GAID 功能，需要在 `build.gradle` 中添加依赖：
|
||||||
|
|
||||||
|
```gradle
|
||||||
|
dependencies {
|
||||||
|
// Google Play Services - Advertising ID
|
||||||
|
implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
|
||||||
|
|
||||||
|
// Kotlin Coroutines（如果项目中还没有）
|
||||||
|
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3'
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
### 1. Android ID
|
||||||
|
- ⚠️ Android 8.0+ 后，每个应用获得的 Android ID 不同
|
||||||
|
- ⚠️ 出厂重置后会改变
|
||||||
|
- ⚠️ 不应用于跨应用追踪
|
||||||
|
- ✅ 适合应用内设备标识
|
||||||
|
|
||||||
|
### 2. GAID
|
||||||
|
- ⚠️ 需要 Google Play Services（国内设备可能不可用）
|
||||||
|
- ⚠️ 必须尊重用户的"限制广告追踪"设置
|
||||||
|
- ⚠️ 必须在后台线程调用
|
||||||
|
- ⚠️ 用户可以随时重置
|
||||||
|
- ✅ 适合广告归因和分析
|
||||||
|
- ✅ 符合 Google Play 政策
|
||||||
|
|
||||||
|
### 3. 隐私合规
|
||||||
|
- 📋 遵守 GDPR、CCPA 等隐私法规
|
||||||
|
- 📋 在隐私政策中说明标识符用途
|
||||||
|
- 📋 尊重用户的追踪限制选择
|
||||||
|
- 📋 提供用户删除数据的选项
|
||||||
|
|
||||||
|
### 4. 最佳实践
|
||||||
|
```kotlin
|
||||||
|
suspend fun getDeviceIdentifierForAnalytics(): String? {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
|
||||||
|
// 1. 优先使用 GAID（如果可用且用户允许）
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
if (gaidInfo != null && !gaidInfo.isLimitAdTrackingEnabled) {
|
||||||
|
return gaidInfo.id
|
||||||
|
}
|
||||||
|
|
||||||
|
// 2. 用户限制了追踪，不应该使用任何标识符
|
||||||
|
if (gaidInfo?.isLimitAdTrackingEnabled == true) {
|
||||||
|
return null // 返回 null 表示不追踪
|
||||||
|
}
|
||||||
|
|
||||||
|
// 3. GAID 不可用（可能是国内设备），使用 Android ID
|
||||||
|
// 注意：这种情况下应该获得用户明确同意
|
||||||
|
return if (hasUserConsent()) {
|
||||||
|
deviceInfo.getAndroidId()
|
||||||
|
} else {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 示例输出
|
||||||
|
|
||||||
|
```
|
||||||
|
=== 设备信息 ===
|
||||||
|
品牌: Samsung
|
||||||
|
型号: SM-G998B
|
||||||
|
制造商: samsung
|
||||||
|
|
||||||
|
=== 设备标识符 ===
|
||||||
|
Android ID: 9774d56d682e549c
|
||||||
|
GAID: 38400000-8cf0-11bd-b23e-10b96e40000d
|
||||||
|
限制追踪: 否
|
||||||
|
```
|
||||||
|
|
||||||
|
## 完成度
|
||||||
|
|
||||||
|
✅ **100%** - 所有功能都已实现
|
||||||
|
- Android ID (Device ID) 获取 ✅
|
||||||
|
- GAID 获取（协程方式）✅
|
||||||
|
- GAID 获取（同步方式）✅
|
||||||
|
- 追踪限制状态检测 ✅
|
||||||
|
- 综合标识符获取 ✅
|
||||||
|
- 完整的中文注释 ✅
|
||||||
|
- 详细的使用文档 ✅
|
||||||
|
- 隐私合规建议 ✅
|
||||||
|
|
||||||
464
InputInfo硬件特性检测使用示例.md
Normal file
464
InputInfo硬件特性检测使用示例.md
Normal file
@ -0,0 +1,464 @@
|
|||||||
|
# InputInfo 硬件特性检测使用示例
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
InputInfo 类现在提供了完整的硬件特性检测功能，包括输入设备信息和各种硬件特性支持（USB、指纹、NFC、GPS等）。
|
||||||
|
|
||||||
|
## 新增功能
|
||||||
|
|
||||||
|
### 硬件特性检测方法（12个）
|
||||||
|
|
||||||
|
1. **USB 相关**
|
||||||
|
- `hasUsbHostSupport()` - USB Host 模式支持
|
||||||
|
- `hasUsbAccessorySupport()` - USB 配件模式支持
|
||||||
|
|
||||||
|
2. **生物识别**
|
||||||
|
- `hasFingerprintSensor()` - 指纹识别器
|
||||||
|
|
||||||
|
3. **传感器**
|
||||||
|
- `hasInfraredSensor()` - 红外线传感器（遥控器功能）
|
||||||
|
- `hasUwbSupport()` - UWB 超宽带支持
|
||||||
|
|
||||||
|
4. **NFC 相关**
|
||||||
|
- `hasNfcSupport()` - NFC 近场通信支持
|
||||||
|
- `hasNfcHostCardEmulation()` - NFC 主机卡模拟
|
||||||
|
- `hasNfcHostCardEmulationOffHost()` - NFC 离线主机卡模拟
|
||||||
|
- `hasSecureNfcSupport()` - 安全 NFC 支持
|
||||||
|
|
||||||
|
5. **定位相关**
|
||||||
|
- `hasGpsSupport()` - GPS 定位支持
|
||||||
|
- `hasNetworkLocationSupport()` - 网络定位支持
|
||||||
|
- `hasLocationSupport()` - 任何定位服务支持
|
||||||
|
|
||||||
|
6. **综合方法**
|
||||||
|
- `getHardwareFeatures()` - 获取所有硬件特性支持信息
|
||||||
|
|
||||||
|
## 使用方法
|
||||||
|
|
||||||
|
### 1. 初始化
|
||||||
|
```kotlin
|
||||||
|
import com.xyzshell.andinfo.AndInfo
|
||||||
|
|
||||||
|
// 在 Application 或 Activity 中初始化
|
||||||
|
AndInfo.init(applicationContext)
|
||||||
|
|
||||||
|
// 获取 InputInfo 实例
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. USB 功能检测
|
||||||
|
|
||||||
|
#### USB Host 支持
|
||||||
|
```kotlin
|
||||||
|
// 检查是否支持 USB Host 模式
|
||||||
|
val hasUsbHost = inputInfo.hasUsbHostSupport()
|
||||||
|
println("USB Host 支持: ${if (hasUsbHost) "是" else "否"}")
|
||||||
|
|
||||||
|
// USB Host 允许 Android 设备连接：
|
||||||
|
// - USB 键盘
|
||||||
|
// - USB 鼠标
|
||||||
|
// - USB 存储设备
|
||||||
|
// - USB 游戏手柄
|
||||||
|
// - USB 打印机等
|
||||||
|
```
|
||||||
|
|
||||||
|
#### USB 配件模式
|
||||||
|
```kotlin
|
||||||
|
// 检查是否支持 USB 配件模式
|
||||||
|
val hasUsbAccessory = inputInfo.hasUsbAccessorySupport()
|
||||||
|
println("USB 配件模式: ${if (hasUsbAccessory) "是" else "否"}")
|
||||||
|
|
||||||
|
// USB 配件模式允许 Android 设备作为配件连接到：
|
||||||
|
// - 汽车娱乐系统
|
||||||
|
// - 音频设备
|
||||||
|
// - 医疗设备等
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 指纹识别检测
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 检查是否有指纹识别器
|
||||||
|
val hasFingerprint = inputInfo.hasFingerprintSensor()
|
||||||
|
println("指纹识别器: ${if (hasFingerprint) "有" else "无"}")
|
||||||
|
|
||||||
|
// 用于判断设备是否支持指纹解锁、指纹支付等功能
|
||||||
|
if (hasFingerprint) {
|
||||||
|
// 可以使用 BiometricPrompt API 进行指纹认证
|
||||||
|
println("设备支持指纹认证功能")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 红外线传感器检测
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 检查是否有红外线传感器（IR Blaster）
|
||||||
|
val hasInfrared = inputInfo.hasInfraredSensor()
|
||||||
|
println("红外线传感器: ${if (hasInfrared) "有" else "无"}")
|
||||||
|
|
||||||
|
// 红外线传感器可用于：
|
||||||
|
// - 遥控电视
|
||||||
|
// - 遥控空调
|
||||||
|
// - 遥控机顶盒等
|
||||||
|
if (hasInfrared) {
|
||||||
|
println("设备可以作为万能遥控器使用")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. UWB 超宽带支持检测
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 检查是否支持 UWB（Ultra-Wideband）
|
||||||
|
val hasUwb = inputInfo.hasUwbSupport()
|
||||||
|
println("UWB 支持: ${if (hasUwb) "是" else "否"}")
|
||||||
|
|
||||||
|
// UWB 技术用于：
|
||||||
|
// - 精确室内定位（厘米级）
|
||||||
|
// - 数字车钥匙
|
||||||
|
// - 查找设备（类似 AirTag）
|
||||||
|
// - 设备间高速数据传输
|
||||||
|
if (hasUwb) {
|
||||||
|
println("设备支持精确定位和数字车钥匙功能")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. NFC 功能检测
|
||||||
|
|
||||||
|
#### 基本 NFC 支持
|
||||||
|
```kotlin
|
||||||
|
// 检查是否支持 NFC
|
||||||
|
val hasNfc = inputInfo.hasNfcSupport()
|
||||||
|
println("NFC 支持: ${if (hasNfc) "是" else "否"}")
|
||||||
|
|
||||||
|
// NFC 用于：
|
||||||
|
// - 移动支付（Apple Pay、Google Pay等）
|
||||||
|
// - 读取 NFC 标签
|
||||||
|
// - 点对点数据传输
|
||||||
|
// - 公交卡模拟
|
||||||
|
```
|
||||||
|
|
||||||
|
#### NFC 主机卡模拟（HCE）
|
||||||
|
```kotlin
|
||||||
|
// 检查是否支持 NFC HCE
|
||||||
|
val hasNfcHce = inputInfo.hasNfcHostCardEmulation()
|
||||||
|
println("NFC HCE 支持: ${if (hasNfcHce) "是" else "否"}")
|
||||||
|
|
||||||
|
// HCE 允许应用模拟 NFC 卡片，无需物理安全元素
|
||||||
|
// 用于：
|
||||||
|
// - 虚拟公交卡
|
||||||
|
// - 虚拟门禁卡
|
||||||
|
// - 虚拟会员卡
|
||||||
|
```
|
||||||
|
|
||||||
|
#### NFC 离线主机卡模拟
|
||||||
|
```kotlin
|
||||||
|
// 检查是否支持离线 HCE
|
||||||
|
val hasNfcOffHost = inputInfo.hasNfcHostCardEmulationOffHost()
|
||||||
|
println("NFC 离线 HCE: ${if (hasNfcOffHost) "是" else "否"}")
|
||||||
|
|
||||||
|
// 允许在设备离线时进行 NFC 交易
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 安全 NFC
|
||||||
|
```kotlin
|
||||||
|
// 检查是否支持安全 NFC
|
||||||
|
val hasSecureNfc = inputInfo.hasSecureNfcSupport()
|
||||||
|
println("安全 NFC: ${if (hasSecureNfc) "是" else "否"}")
|
||||||
|
|
||||||
|
// 安全 NFC 使用安全元素（Secure Element）
|
||||||
|
// 提供更高的安全性，用于：
|
||||||
|
// - 金融级支付
|
||||||
|
// - 敏感数据交换
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7. GPS 定位检测
|
||||||
|
|
||||||
|
#### GPS 支持
|
||||||
|
```kotlin
|
||||||
|
// 检查是否支持 GPS
|
||||||
|
val hasGps = inputInfo.hasGpsSupport()
|
||||||
|
println("GPS 支持: ${if (hasGps) "是" else "否"}")
|
||||||
|
|
||||||
|
// GPS 提供卫星定位功能
|
||||||
|
// 用于：
|
||||||
|
// - 导航
|
||||||
|
// - 位置追踪
|
||||||
|
// - 地理标记
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 网络定位
|
||||||
|
```kotlin
|
||||||
|
// 检查是否支持网络定位
|
||||||
|
val hasNetworkLocation = inputInfo.hasNetworkLocationSupport()
|
||||||
|
println("网络定位: ${if (hasNetworkLocation) "是" else "否"}")
|
||||||
|
|
||||||
|
// 网络定位使用：
|
||||||
|
// - Wi-Fi 定位
|
||||||
|
// - 基站定位
|
||||||
|
// 比 GPS 更省电但精度较低
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 任何定位服务
|
||||||
|
```kotlin
|
||||||
|
// 检查是否支持任何定位服务
|
||||||
|
val hasLocation = inputInfo.hasLocationSupport()
|
||||||
|
println("定位服务: ${if (hasLocation) "是" else "否"}")
|
||||||
|
|
||||||
|
// 综合检测设备是否有定位能力
|
||||||
|
```
|
||||||
|
|
||||||
|
### 8. 获取所有硬件特性
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 一次性获取所有硬件特性支持信息
|
||||||
|
val features = inputInfo.getHardwareFeatures()
|
||||||
|
|
||||||
|
println("=== 硬件特性汇总 ===")
|
||||||
|
println("USB Host: ${if (features.usbHost) "✓" else "✗"}")
|
||||||
|
println("USB 配件: ${if (features.usbAccessory) "✓" else "✗"}")
|
||||||
|
println("指纹识别: ${if (features.fingerprint) "✓" else "✗"}")
|
||||||
|
println("红外线: ${if (features.infrared) "✓" else "✗"}")
|
||||||
|
println("UWB: ${if (features.uwb) "✓" else "✗"}")
|
||||||
|
println("NFC: ${if (features.nfc) "✓" else "✗"}")
|
||||||
|
println("NFC HCE: ${if (features.nfcHce) "✓" else "✗"}")
|
||||||
|
println("NFC 离线: ${if (features.nfcHceOffHost) "✓" else "✗"}")
|
||||||
|
println("安全 NFC: ${if (features.secureNfc) "✓" else "✗"}")
|
||||||
|
println("GPS: ${if (features.gps) "✓" else "✗"}")
|
||||||
|
println("网络定位: ${if (features.networkLocation) "✓" else "✗"}")
|
||||||
|
println("定位服务: ${if (features.location) "✓" else "✗"}")
|
||||||
|
```
|
||||||
|
|
||||||
|
### 9. 输入设备信息（原有功能）
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
// 获取所有输入设备
|
||||||
|
val devices = inputInfo.getInputDevices()
|
||||||
|
println("输入设备数量: ${devices.size}")
|
||||||
|
|
||||||
|
devices.forEach { device ->
|
||||||
|
println("--- ${device.name} ---")
|
||||||
|
println("ID: ${device.id}")
|
||||||
|
println("类型: ${when {
|
||||||
|
device.sources and InputDevice.SOURCE_KEYBOARD != 0 -> "键盘"
|
||||||
|
device.sources and InputDevice.SOURCE_MOUSE != 0 -> "鼠标"
|
||||||
|
device.sources and InputDevice.SOURCE_TOUCHSCREEN != 0 -> "触摸屏"
|
||||||
|
device.sources and InputDevice.SOURCE_GAMEPAD != 0 -> "游戏手柄"
|
||||||
|
else -> "其他"
|
||||||
|
}}")
|
||||||
|
println("虚拟设备: ${device.isVirtual}")
|
||||||
|
println("外部设备: ${device.isExternal}")
|
||||||
|
println("有震动: ${device.hasVibrator}")
|
||||||
|
println("有麦克风: ${device.hasMicrophone}")
|
||||||
|
println()
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## HardwareFeatures 数据类
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
data class HardwareFeatures(
|
||||||
|
val usbHost: Boolean, // USB Host 支持
|
||||||
|
val usbAccessory: Boolean, // USB 配件支持
|
||||||
|
val fingerprint: Boolean, // 指纹识别器
|
||||||
|
val infrared: Boolean, // 红外线传感器
|
||||||
|
val uwb: Boolean, // UWB 支持
|
||||||
|
val nfc: Boolean, // NFC 支持
|
||||||
|
val nfcHce: Boolean, // NFC 主机卡模拟
|
||||||
|
val nfcHceOffHost: Boolean, // NFC 离线主机卡模拟
|
||||||
|
val secureNfc: Boolean, // 安全 NFC
|
||||||
|
val gps: Boolean, // GPS 支持
|
||||||
|
val networkLocation: Boolean, // 网络定位支持
|
||||||
|
val location: Boolean // 任何定位支持
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
## 典型应用场景
|
||||||
|
|
||||||
|
### 1. 功能适配检查
|
||||||
|
```kotlin
|
||||||
|
fun checkDeviceCapabilities(): DeviceCapabilities {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
|
||||||
|
return DeviceCapabilities(
|
||||||
|
canUseUsbAccessories = inputInfo.hasUsbHostSupport(),
|
||||||
|
canUseFingerprint = inputInfo.hasFingerprintSensor(),
|
||||||
|
canControlTv = inputInfo.hasInfraredSensor(),
|
||||||
|
canUseNfcPayment = inputInfo.hasNfcSupport(),
|
||||||
|
canUseDigitalKey = inputInfo.hasUwbSupport(),
|
||||||
|
canUseGps = inputInfo.hasGpsSupport()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 功能引导
|
||||||
|
```kotlin
|
||||||
|
fun showFeatureTips() {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
|
||||||
|
if (inputInfo.hasInfraredSensor()) {
|
||||||
|
showTip("您的设备支持红外遥控功能，可以控制电视、空调等设备")
|
||||||
|
}
|
||||||
|
|
||||||
|
if (inputInfo.hasUwbSupport()) {
|
||||||
|
showTip("您的设备支持 UWB，可以使用数字车钥匙功能")
|
||||||
|
}
|
||||||
|
|
||||||
|
if (inputInfo.hasNfcSupport()) {
|
||||||
|
showTip("您的设备支持 NFC，可以使用移动支付和刷卡功能")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 支付功能检查
|
||||||
|
```kotlin
|
||||||
|
fun canUseNfcPayment(): Boolean {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
|
||||||
|
// 检查基本 NFC 支持
|
||||||
|
if (!inputInfo.hasNfcSupport()) {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
// 检查 HCE 支持（用于虚拟卡片）
|
||||||
|
val hasHce = inputInfo.hasNfcHostCardEmulation()
|
||||||
|
|
||||||
|
// 检查安全 NFC（用于金融级支付）
|
||||||
|
val hasSecureNfc = inputInfo.hasSecureNfcSupport()
|
||||||
|
|
||||||
|
return hasHce || hasSecureNfc
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 定位功能检查
|
||||||
|
```kotlin
|
||||||
|
fun getBestLocationMethod(): String {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
|
||||||
|
return when {
|
||||||
|
inputInfo.hasGpsSupport() -> "GPS（高精度）"
|
||||||
|
inputInfo.hasNetworkLocationSupport() -> "网络定位（省电）"
|
||||||
|
inputInfo.hasLocationSupport() -> "基础定位"
|
||||||
|
else -> "不支持定位"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 设备档案生成
|
||||||
|
```kotlin
|
||||||
|
fun generateDeviceProfile(): String {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
val features = inputInfo.getHardwareFeatures()
|
||||||
|
|
||||||
|
return buildString {
|
||||||
|
appendLine("=== 设备功能档案 ===")
|
||||||
|
appendLine()
|
||||||
|
appendLine("📱 连接性")
|
||||||
|
appendLine("USB Host: ${if (features.usbHost) "✓" else "✗"}")
|
||||||
|
appendLine("USB 配件: ${if (features.usbAccessory) "✓" else "✗"}")
|
||||||
|
appendLine("NFC: ${if (features.nfc) "✓" else "✗"}")
|
||||||
|
appendLine("UWB: ${if (features.uwb) "✓" else "✗"}")
|
||||||
|
appendLine()
|
||||||
|
appendLine("🔐 安全性")
|
||||||
|
appendLine("指纹: ${if (features.fingerprint) "✓" else "✗"}")
|
||||||
|
appendLine("安全 NFC: ${if (features.secureNfc) "✓" else "✗"}")
|
||||||
|
appendLine()
|
||||||
|
appendLine("📍 定位")
|
||||||
|
appendLine("GPS: ${if (features.gps) "✓" else "✗"}")
|
||||||
|
appendLine("网络定位: ${if (features.networkLocation) "✓" else "✗"}")
|
||||||
|
appendLine()
|
||||||
|
appendLine("🔌 特殊功能")
|
||||||
|
appendLine("红外遥控: ${if (features.infrared) "✓" else "✗"}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 示例输出
|
||||||
|
|
||||||
|
### 完整硬件特性检测结果
|
||||||
|
```
|
||||||
|
=== 硬件特性汇总 ===
|
||||||
|
USB Host: ✓
|
||||||
|
USB 配件: ✓
|
||||||
|
指纹识别: ✓
|
||||||
|
红外线: ✗
|
||||||
|
UWB: ✓
|
||||||
|
NFC: ✓
|
||||||
|
NFC HCE: ✓
|
||||||
|
NFC 离线: ✗
|
||||||
|
安全 NFC: ✓
|
||||||
|
GPS: ✓
|
||||||
|
网络定位: ✓
|
||||||
|
定位服务: ✓
|
||||||
|
```
|
||||||
|
|
||||||
|
### 高端设备示例（如 Samsung Galaxy S24 Ultra）
|
||||||
|
```
|
||||||
|
USB Host: ✓
|
||||||
|
USB 配件: ✓
|
||||||
|
指纹识别: ✓（屏下指纹）
|
||||||
|
红外线: ✗
|
||||||
|
UWB: ✓（数字车钥匙、SmartTag+ 支持）
|
||||||
|
NFC: ✓
|
||||||
|
NFC HCE: ✓
|
||||||
|
安全 NFC: ✓（Samsung Pay）
|
||||||
|
GPS: ✓
|
||||||
|
```
|
||||||
|
|
||||||
|
### 中端设备示例（如 Google Pixel 7a）
|
||||||
|
```
|
||||||
|
USB Host: ✓
|
||||||
|
USB 配件: ✓
|
||||||
|
指纹识别: ✓（屏下指纹）
|
||||||
|
红外线: ✗
|
||||||
|
UWB: ✗
|
||||||
|
NFC: ✓
|
||||||
|
NFC HCE: ✓
|
||||||
|
安全 NFC: ✗
|
||||||
|
GPS: ✓
|
||||||
|
```
|
||||||
|
|
||||||
|
### 预算设备示例
|
||||||
|
```
|
||||||
|
USB Host: ✓
|
||||||
|
USB 配件: ✓
|
||||||
|
指纹识别: ✓（侧面指纹）
|
||||||
|
红外线: ✗
|
||||||
|
UWB: ✗
|
||||||
|
NFC: ✗
|
||||||
|
NFC HCE: ✗
|
||||||
|
安全 NFC: ✗
|
||||||
|
GPS: ✓
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. **权限要求**：
|
||||||
|
- USB 功能不需要特殊权限
|
||||||
|
- 指纹使用需要 `USE_BIOMETRIC` 权限
|
||||||
|
- NFC 使用需要 `NFC` 权限
|
||||||
|
- 定位使用需要 `ACCESS_FINE_LOCATION` 或 `ACCESS_COARSE_LOCATION` 权限
|
||||||
|
|
||||||
|
2. **版本兼容性**：
|
||||||
|
- UWB 支持需要 Android 12+
|
||||||
|
- 某些 NFC 功能需要 Android 4.4+
|
||||||
|
|
||||||
|
3. **设备差异**：
|
||||||
|
- 不同品牌和型号的设备支持的功能不同
|
||||||
|
- 某些功能可能被厂商禁用
|
||||||
|
|
||||||
|
4. **用户设置**：
|
||||||
|
- 即使硬件支持，用户也可能在设置中禁用某些功能
|
||||||
|
- 建议在使用前检查功能是否已启用
|
||||||
|
|
||||||
|
## 完成度
|
||||||
|
|
||||||
|
✅ **100%** - 所有请求的功能都已实现
|
||||||
|
- USB Host 支持检测 ✅
|
||||||
|
- USB 配件支持检测 ✅
|
||||||
|
- 指纹识别器检测 ✅
|
||||||
|
- 红外线传感器检测 ✅
|
||||||
|
- UWB 支持检测 ✅
|
||||||
|
- NFC 支持检测 ✅
|
||||||
|
- 安全 NFC 支持检测 ✅
|
||||||
|
- GPS 支持检测 ✅
|
||||||
|
- 完整的中文注释 ✅
|
||||||
|
- 综合查询方法 ✅
|
||||||
|
|
||||||
343
MemInfo内存类型检测使用示例.md
Normal file
343
MemInfo内存类型检测使用示例.md
Normal file
@ -0,0 +1,343 @@
|
|||||||
|
# MemInfo 内存类型检测使用示例
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
MemInfo 类提供了完整的内存信息检测功能，特别是增强了内存类型（LPDDR5、LPDDR4X等）的检测能力。
|
||||||
|
|
||||||
|
## 增强的功能
|
||||||
|
|
||||||
|
### 内存类型检测方法（5种）
|
||||||
|
|
||||||
|
1. **系统属性检测** - 从 Android 系统属性获取
|
||||||
|
- `ro.boot.ddr_type`
|
||||||
|
- `ro.boot.ddrtype`
|
||||||
|
- `ro.vendor.boot.ddr_type`
|
||||||
|
- `persist.vendor.ddr.type`
|
||||||
|
- 等多个属性路径
|
||||||
|
|
||||||
|
2. **Sysfs 文件系统检测** - 从设备文件系统读取
|
||||||
|
- Qualcomm 设备路径
|
||||||
|
- MediaTek 设备路径
|
||||||
|
- Samsung Exynos 设备路径
|
||||||
|
- 通用路径
|
||||||
|
|
||||||
|
3. **设备树检测** - 从设备树 (Device Tree) 获取
|
||||||
|
- `/proc/device-tree/memory/ddr-type`
|
||||||
|
- `/sys/firmware/devicetree/base/memory/ddr-type`
|
||||||
|
|
||||||
|
4. **内核日志检测** - 从 dmesg 日志分析
|
||||||
|
- 搜索 DDR、LPDDR、memory type 关键词
|
||||||
|
|
||||||
|
5. **智能推测** - 根据 Android 版本和发布年份估算
|
||||||
|
- Android 14+ (2023+) → LPDDR5X
|
||||||
|
- Android 13 (2022+) → LPDDR5
|
||||||
|
- Android 12 (2021+) → LPDDR5
|
||||||
|
- Android 11 (2020+) → LPDDR4X
|
||||||
|
- Android 10 (2019+) → LPDDR4X
|
||||||
|
|
||||||
|
### 支持的内存类型
|
||||||
|
|
||||||
|
- **LPDDR5X** - 最新旗舰设备（2023+）
|
||||||
|
- **LPDDR5** - 高端设备（2021-2023）
|
||||||
|
- **LPDDR4X** - 中高端设备（2019-2021）
|
||||||
|
- **LPDDR4** - 主流设备（2017-2019）
|
||||||
|
- **LPDDR3** - 老旧设备（2015-2017）
|
||||||
|
- **LPDDR2** - 更老设备（2013-2015）
|
||||||
|
- **DDR5/DDR4/DDR3** - 非移动设备
|
||||||
|
|
||||||
|
## 使用方法
|
||||||
|
|
||||||
|
### 1. 初始化
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
import com.xyzshell.andinfo.AndInfo
|
||||||
|
|
||||||
|
// 在 Application 或 Activity 中初始化
|
||||||
|
AndInfo.init(applicationContext)
|
||||||
|
|
||||||
|
// 获取 MemInfo 实例
|
||||||
|
val memInfo = AndInfo.instance.mem
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 获取完整内存信息
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
val memoryInfo = memInfo.getMemoryInfo()
|
||||||
|
|
||||||
|
println("=== 内存信息 ===")
|
||||||
|
println("总内存: ${memInfo.formatBytes(memoryInfo.totalRam)}")
|
||||||
|
println("可用内存: ${memInfo.formatBytes(memoryInfo.availableRam)}")
|
||||||
|
println("已使用: ${memInfo.formatBytes(memoryInfo.usedRam)}")
|
||||||
|
println("内存类型: ${memoryInfo.memType}")
|
||||||
|
println("内存通道: ${memoryInfo.channels} 通道")
|
||||||
|
println("ZRAM 总大小: ${memInfo.formatBytes(memoryInfo.zramTotal)}")
|
||||||
|
println("ZRAM 已使用: ${memInfo.formatBytes(memoryInfo.zramUsed)}")
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 仅获取内存类型
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
val memoryInfo = memInfo.getMemoryInfo()
|
||||||
|
val memType = memoryInfo.memType
|
||||||
|
|
||||||
|
when {
|
||||||
|
memType.contains("LPDDR5X") -> {
|
||||||
|
println("✅ 最新旗舰内存：LPDDR5X")
|
||||||
|
println("特点：最高性能，最低功耗，用于2023年后的旗舰设备")
|
||||||
|
}
|
||||||
|
memType.contains("LPDDR5") -> {
|
||||||
|
println("✅ 高端内存：LPDDR5")
|
||||||
|
println("特点：高性能，低功耗，用于2021-2023年的高端设备")
|
||||||
|
}
|
||||||
|
memType.contains("LPDDR4X") -> {
|
||||||
|
println("✅ 主流内存：LPDDR4X")
|
||||||
|
println("特点：均衡性能与功耗，用于大多数中高端设备")
|
||||||
|
}
|
||||||
|
memType.contains("LPDDR4") -> {
|
||||||
|
println("✅ 标准内存：LPDDR4")
|
||||||
|
println("特点：标准性能，用于主流设备")
|
||||||
|
}
|
||||||
|
memType.contains("estimated") -> {
|
||||||
|
println("ℹ️ 估算的内存类型：$memType")
|
||||||
|
println("提示：系统无法直接读取内存类型，基于设备信息估算")
|
||||||
|
}
|
||||||
|
else -> {
|
||||||
|
println("❓ 未知内存类型")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 内存性能评估
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
val memoryInfo = memInfo.getMemoryInfo()
|
||||||
|
|
||||||
|
// 评估内存性能等级
|
||||||
|
val performanceLevel = when {
|
||||||
|
memoryInfo.memType.contains("LPDDR5X") -> "旗舰级"
|
||||||
|
memoryInfo.memType.contains("LPDDR5") -> "高端"
|
||||||
|
memoryInfo.memType.contains("LPDDR4X") -> "中高端"
|
||||||
|
memoryInfo.memType.contains("LPDDR4") -> "中端"
|
||||||
|
else -> "入门"
|
||||||
|
}
|
||||||
|
|
||||||
|
println("内存性能等级: $performanceLevel")
|
||||||
|
println("理论带宽估算:")
|
||||||
|
|
||||||
|
when {
|
||||||
|
memoryInfo.memType.contains("LPDDR5X") -> {
|
||||||
|
val bandwidth = 8533 * memoryInfo.channels // LPDDR5X-8533
|
||||||
|
println(" 约 ${bandwidth} MB/s (${memoryInfo.channels}通道)")
|
||||||
|
}
|
||||||
|
memoryInfo.memType.contains("LPDDR5") -> {
|
||||||
|
val bandwidth = 6400 * memoryInfo.channels // LPDDR5-6400
|
||||||
|
println(" 约 ${bandwidth} MB/s (${memoryInfo.channels}通道)")
|
||||||
|
}
|
||||||
|
memoryInfo.memType.contains("LPDDR4X") -> {
|
||||||
|
val bandwidth = 4266 * memoryInfo.channels // LPDDR4X-4266
|
||||||
|
println(" 约 ${bandwidth} MB/s (${memoryInfo.channels}通道)")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 内存使用情况分析
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
val memoryInfo = memInfo.getMemoryInfo()
|
||||||
|
|
||||||
|
// 计算使用率
|
||||||
|
val usagePercentage = (memoryInfo.usedRam.toDouble() / memoryInfo.totalRam * 100).toInt()
|
||||||
|
|
||||||
|
println("=== 内存使用情况 ===")
|
||||||
|
println("总内存: ${memInfo.formatBytes(memoryInfo.totalRam)}")
|
||||||
|
println("已使用: ${memInfo.formatBytes(memoryInfo.usedRam)} (${usagePercentage}%)")
|
||||||
|
println("可用: ${memInfo.formatBytes(memoryInfo.availableRam)}")
|
||||||
|
|
||||||
|
// 使用状态
|
||||||
|
when {
|
||||||
|
usagePercentage >= 90 -> println("⚠️ 内存严重不足")
|
||||||
|
usagePercentage >= 75 -> println("⚠️ 内存偏紧")
|
||||||
|
usagePercentage >= 50 -> println("✓ 内存使用正常")
|
||||||
|
else -> println("✓ 内存充裕")
|
||||||
|
}
|
||||||
|
|
||||||
|
// ZRAM 情况
|
||||||
|
if (memoryInfo.zramTotal > 0) {
|
||||||
|
val zramUsagePercent = (memoryInfo.zramUsed.toDouble() / memoryInfo.zramTotal * 100).toInt()
|
||||||
|
println("\n=== ZRAM (压缩内存) ===")
|
||||||
|
println("ZRAM 大小: ${memInfo.formatBytes(memoryInfo.zramTotal)}")
|
||||||
|
println("ZRAM 已使用: ${memInfo.formatBytes(memoryInfo.zramUsed)} (${zramUsagePercent}%)")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. 完整示例
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class MemoryInfoActivity : AppCompatActivity() {
|
||||||
|
override fun onCreate(savedInstanceState: Bundle?) {
|
||||||
|
super.onCreate(savedInstanceState)
|
||||||
|
|
||||||
|
displayMemoryInfo()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun displayMemoryInfo() {
|
||||||
|
val memInfo = AndInfo.instance.mem
|
||||||
|
val memoryInfo = memInfo.getMemoryInfo()
|
||||||
|
|
||||||
|
val info = buildString {
|
||||||
|
appendLine("╔════════════════════════════════╗")
|
||||||
|
appendLine("║ 设备内存信息报告 ║")
|
||||||
|
appendLine("╚════════════════════════════════╝")
|
||||||
|
appendLine()
|
||||||
|
|
||||||
|
// 内存容量
|
||||||
|
appendLine("【内存容量】")
|
||||||
|
appendLine(" 总内存：${memInfo.formatBytes(memoryInfo.totalRam)}")
|
||||||
|
appendLine(" 可用：${memInfo.formatBytes(memoryInfo.availableRam)}")
|
||||||
|
appendLine(" 已使用：${memInfo.formatBytes(memoryInfo.usedRam)}")
|
||||||
|
|
||||||
|
val usagePercent = (memoryInfo.usedRam.toDouble() / memoryInfo.totalRam * 100).toInt()
|
||||||
|
appendLine(" 使用率：${usagePercent}%")
|
||||||
|
appendLine()
|
||||||
|
|
||||||
|
// 内存类型
|
||||||
|
appendLine("【内存规格】")
|
||||||
|
appendLine(" 类型：${memoryInfo.memType}")
|
||||||
|
appendLine(" 通道：${memoryInfo.channels} 通道")
|
||||||
|
|
||||||
|
// 性能评级
|
||||||
|
val perfLevel = when {
|
||||||
|
memoryInfo.memType.contains("LPDDR5X") -> "⭐⭐⭐⭐⭐ 旗舰级"
|
||||||
|
memoryInfo.memType.contains("LPDDR5") -> "⭐⭐⭐⭐ 高端"
|
||||||
|
memoryInfo.memType.contains("LPDDR4X") -> "⭐⭐⭐ 中高端"
|
||||||
|
memoryInfo.memType.contains("LPDDR4") -> "⭐⭐ 中端"
|
||||||
|
else -> "⭐ 入门"
|
||||||
|
}
|
||||||
|
appendLine(" 性能等级：$perfLevel")
|
||||||
|
appendLine()
|
||||||
|
|
||||||
|
// ZRAM 信息
|
||||||
|
if (memoryInfo.zramTotal > 0) {
|
||||||
|
appendLine("【ZRAM 压缩内存】")
|
||||||
|
appendLine(" 总大小：${memInfo.formatBytes(memoryInfo.zramTotal)}")
|
||||||
|
appendLine(" 已使用：${memInfo.formatBytes(memoryInfo.zramUsed)}")
|
||||||
|
val zramPercent = (memoryInfo.zramUsed.toDouble() / memoryInfo.zramTotal * 100).toInt()
|
||||||
|
appendLine(" 使用率：${zramPercent}%")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
println(info)
|
||||||
|
// 或者显示在 TextView 中
|
||||||
|
// textView.text = info
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 检测原理说明
|
||||||
|
|
||||||
|
### 1. 系统属性检测
|
||||||
|
```kotlin
|
||||||
|
// 尝试读取系统属性
|
||||||
|
getprop ro.boot.ddr_type
|
||||||
|
// 可能返回: "LPDDR5", "4", "5" 等
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Sysfs 文件检测
|
||||||
|
```kotlin
|
||||||
|
// Qualcomm 设备
|
||||||
|
/sys/class/devfreq/soc:qcom,cpu-cpu-llcc-bw/device/type
|
||||||
|
|
||||||
|
// MediaTek 设备
|
||||||
|
/sys/kernel/debug/emi_mbw/dram_type
|
||||||
|
|
||||||
|
// Samsung Exynos 设备
|
||||||
|
/sys/class/devfreq/17000010.devfreq_mif/device/type
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 设备树检测
|
||||||
|
```kotlin
|
||||||
|
// 设备树路径
|
||||||
|
/proc/device-tree/memory/ddr-type
|
||||||
|
/sys/firmware/devicetree/base/memory/ddr-type
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 内核日志检测
|
||||||
|
```bash
|
||||||
|
# 搜索内核日志
|
||||||
|
dmesg | grep -iE 'ddr|lpddr|memory.*type'
|
||||||
|
# 可能输出: "LPDDR5 detected", "DDR Type: 5" 等
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 智能推测规则
|
||||||
|
|
||||||
|
| Android 版本 | 发布年份 | 估算类型 |
|
||||||
|
|-------------|---------|---------|
|
||||||
|
| 14+ | 2023+ | LPDDR5X |
|
||||||
|
| 13 | 2022-2023 | LPDDR5 |
|
||||||
|
| 12 | 2021-2022 | LPDDR5 |
|
||||||
|
| 11 | 2020-2021 | LPDDR4X |
|
||||||
|
| 10 | 2019-2020 | LPDDR4X |
|
||||||
|
| 9 | 2018-2019 | LPDDR4 |
|
||||||
|
| ≤8 | ≤2017 | LPDDR3 |
|
||||||
|
|
||||||
|
## 典型设备示例
|
||||||
|
|
||||||
|
### 高端旗舰（2023+）
|
||||||
|
```
|
||||||
|
内存类型: LPDDR5X
|
||||||
|
通道: 4 通道
|
||||||
|
理论带宽: 约 34,132 MB/s
|
||||||
|
性能等级: ⭐⭐⭐⭐⭐ 旗舰级
|
||||||
|
代表设备: Samsung S24 Ultra, Xiaomi 14 Pro
|
||||||
|
```
|
||||||
|
|
||||||
|
### 高端设备（2021-2023）
|
||||||
|
```
|
||||||
|
内存类型: LPDDR5
|
||||||
|
通道: 4 通道
|
||||||
|
理论带宽: 约 25,600 MB/s
|
||||||
|
性能等级: ⭐⭐⭐⭐ 高端
|
||||||
|
代表设备: Pixel 7 Pro, OnePlus 11
|
||||||
|
```
|
||||||
|
|
||||||
|
### 中高端设备（2019-2021）
|
||||||
|
```
|
||||||
|
内存类型: LPDDR4X
|
||||||
|
通道: 2 通道
|
||||||
|
理论带宽: 约 8,532 MB/s
|
||||||
|
性能等级: ⭐⭐⭐ 中高端
|
||||||
|
代表设备: Pixel 5, Mi 10T
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. **权限要求**：
|
||||||
|
- 无需特殊权限
|
||||||
|
- 某些检测路径可能需要 root 权限才能访问
|
||||||
|
|
||||||
|
2. **检测准确性**：
|
||||||
|
- 优先级：系统属性 > Sysfs > 设备树 > 内核日志 > 估算
|
||||||
|
- 带 "(estimated)" 标记表示是推测值
|
||||||
|
|
||||||
|
3. **设备差异**：
|
||||||
|
- 不同厂商的设备，内存信息存储位置可能不同
|
||||||
|
- 某些定制 ROM 可能修改了相关路径
|
||||||
|
|
||||||
|
4. **性能差异**：
|
||||||
|
- 相同类型的内存，不同频率性能也不同
|
||||||
|
- 通道数会显著影响实际带宽
|
||||||
|
|
||||||
|
## 完成度
|
||||||
|
|
||||||
|
✅ **100%** - 所有功能都已实现
|
||||||
|
- 系统属性检测 ✅
|
||||||
|
- Sysfs 文件系统检测 ✅
|
||||||
|
- 设备树检测 ✅
|
||||||
|
- 内核日志检测 ✅
|
||||||
|
- 智能推测 ✅
|
||||||
|
- 内存类型解析 ✅
|
||||||
|
- 支持所有主流内存类型 ✅
|
||||||
|
- 完整的中文注释 ✅
|
||||||
|
- 详细的使用文档 ✅
|
||||||
|
|
||||||
|
所有功能都已正确实现并可以使用！🎉
|
||||||
|
|
||||||
@ -2,6 +2,7 @@ package com.xyzshell.andinfo
|
|||||||
|
|
||||||
import android.content.Context
|
import android.content.Context
|
||||||
import com.xyzshell.andinfo.libs.AppInfo
|
import com.xyzshell.andinfo.libs.AppInfo
|
||||||
|
import com.xyzshell.andinfo.libs.BatteryInfo
|
||||||
import com.xyzshell.andinfo.libs.CpuInfo
|
import com.xyzshell.andinfo.libs.CpuInfo
|
||||||
import com.xyzshell.andinfo.libs.DeviceInfo
|
import com.xyzshell.andinfo.libs.DeviceInfo
|
||||||
import com.xyzshell.andinfo.libs.DisplayInfo
|
import com.xyzshell.andinfo.libs.DisplayInfo
|
||||||
@ -13,6 +14,8 @@ import com.xyzshell.andinfo.libs.CameraInfo
|
|||||||
import com.xyzshell.andinfo.libs.BluetoothInfo
|
import com.xyzshell.andinfo.libs.BluetoothInfo
|
||||||
import com.xyzshell.andinfo.libs.StorageInfo
|
import com.xyzshell.andinfo.libs.StorageInfo
|
||||||
import com.xyzshell.andinfo.libs.DRMInfo
|
import com.xyzshell.andinfo.libs.DRMInfo
|
||||||
|
import com.xyzshell.andinfo.libs.MemInfo
|
||||||
|
import com.xyzshell.andinfo.libs.NetworkInfo
|
||||||
|
|
||||||
class AndInfo private constructor(private val applicationContext: Context) {
|
class AndInfo private constructor(private val applicationContext: Context) {
|
||||||
|
|
||||||
@ -44,6 +47,9 @@ class AndInfo private constructor(private val applicationContext: Context) {
|
|||||||
private val _storage: StorageInfo
|
private val _storage: StorageInfo
|
||||||
private val _app: AppInfo
|
private val _app: AppInfo
|
||||||
private val _drm: DRMInfo
|
private val _drm: DRMInfo
|
||||||
|
private val _batter: BatteryInfo
|
||||||
|
private val _memory: MemInfo
|
||||||
|
private val _network: NetworkInfo
|
||||||
|
|
||||||
init {
|
init {
|
||||||
_cpu = CpuInfo()
|
_cpu = CpuInfo()
|
||||||
@ -58,6 +64,9 @@ class AndInfo private constructor(private val applicationContext: Context) {
|
|||||||
_storage = StorageInfo(applicationContext)
|
_storage = StorageInfo(applicationContext)
|
||||||
_app = AppInfo(applicationContext)
|
_app = AppInfo(applicationContext)
|
||||||
_drm = DRMInfo(applicationContext)
|
_drm = DRMInfo(applicationContext)
|
||||||
|
_batter = BatteryInfo(applicationContext)
|
||||||
|
_memory = MemInfo(applicationContext)
|
||||||
|
_network = NetworkInfo(applicationContext)
|
||||||
}
|
}
|
||||||
|
|
||||||
val cpu get() = _cpu
|
val cpu get() = _cpu
|
||||||
@ -73,5 +82,7 @@ class AndInfo private constructor(private val applicationContext: Context) {
|
|||||||
val context get() = applicationContext
|
val context get() = applicationContext
|
||||||
val app get() = _app
|
val app get() = _app
|
||||||
val drm get() = _drm
|
val drm get() = _drm
|
||||||
|
val battery get() = _batter
|
||||||
|
val memory get() = _memory
|
||||||
|
val network get() = _network
|
||||||
}
|
}
|
||||||
|
|||||||
@ -0,0 +1,710 @@
|
|||||||
|
package com.xyzshell.andinfo.collector
|
||||||
|
|
||||||
|
import android.content.Context
|
||||||
|
import android.os.Build
|
||||||
|
import com.google.gson.Gson
|
||||||
|
import com.xyzshell.andinfo.AndInfo
|
||||||
|
import com.xyzshell.andinfo.models.ApiResponse
|
||||||
|
import com.xyzshell.andinfo.models.DeviceInfoRequest
|
||||||
|
import com.xyzshell.andinfo.models.EncryptedRequest
|
||||||
|
import com.xyzshell.andinfo.utils.WebService
|
||||||
|
import com.xyzshell.andinfo.utils.upload_info_api
|
||||||
|
import kotlinx.coroutines.Dispatchers
|
||||||
|
import kotlinx.coroutines.async
|
||||||
|
import kotlinx.coroutines.withContext
|
||||||
|
import kotlinx.coroutines.coroutineScope
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备信息收集器
|
||||||
|
* 负责异步收集所有设备信息并上传到服务器
|
||||||
|
*/
|
||||||
|
class DeviceInfoCollector(private val context: Context) {
|
||||||
|
|
||||||
|
private val webService = WebService()
|
||||||
|
private val gson = Gson()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集所有设备信息
|
||||||
|
* 异步并发收集各类信息以提高性能
|
||||||
|
*
|
||||||
|
* @return DeviceInfoRequest 包含所有设备信息的数据对象
|
||||||
|
*/
|
||||||
|
suspend fun collectAllInfo(): DeviceInfoRequest = coroutineScope {
|
||||||
|
// 并发收集所有信息以提高性能
|
||||||
|
val cpuInfoDeferred = async { collectCpuInfo() }
|
||||||
|
val gpuInfoDeferred = async { collectGpuInfo() }
|
||||||
|
val screenInfoDeferred = async { collectScreenInfo() }
|
||||||
|
val memoryInfoDeferred = async { collectMemoryInfo() }
|
||||||
|
val diskInfoDeferred = async { collectDiskInfo() }
|
||||||
|
val networkInfoDeferred = async { collectNetworkInfo() }
|
||||||
|
val batteryInfoDeferred = async { collectBatteryInfo() }
|
||||||
|
val deviceInfoDeferred = async { collectDeviceInfo() }
|
||||||
|
val appInfoDeferred = async { collectAppInfo() }
|
||||||
|
val systemInfoDeferred = async { collectSystemInfo() }
|
||||||
|
val locationInfoDeferred = async { collectLocationInfo() }
|
||||||
|
val cameraInfoDeferred = async { collectCameraInfo() }
|
||||||
|
val sensorInfoDeferred = async { collectSensorInfo() }
|
||||||
|
val propsInfoDeferred = async { collectPropsInfo() }
|
||||||
|
val bluetoothInfoDeferred = async { collectBluetoothInfo() }
|
||||||
|
val wifiInfoDeferred = async { collectWifiInfo() }
|
||||||
|
val nfcInfoDeferred = async { collectNfcInfo() }
|
||||||
|
val usbInfoDeferred = async { collectUsbInfo() }
|
||||||
|
val buildInfoDeferred = async { collectBuildInfo() }
|
||||||
|
val drmInfoDeferred = async { collectDrmInfo() }
|
||||||
|
val inputInfoDeferred = async { collectInputInfo() }
|
||||||
|
val identifiersDeferred = async { collectIdentifiers() }
|
||||||
|
|
||||||
|
// 等待所有信息收集完成
|
||||||
|
val identifiers = identifiersDeferred.await()
|
||||||
|
|
||||||
|
DeviceInfoRequest(
|
||||||
|
cpuInfo = cpuInfoDeferred.await(),
|
||||||
|
gpuInfo = gpuInfoDeferred.await(),
|
||||||
|
screenInfo = screenInfoDeferred.await(),
|
||||||
|
memoryInfo = memoryInfoDeferred.await(),
|
||||||
|
diskInfo = diskInfoDeferred.await(),
|
||||||
|
networkInfo = networkInfoDeferred.await(),
|
||||||
|
batteryInfo = batteryInfoDeferred.await(),
|
||||||
|
deviceInfo = deviceInfoDeferred.await(),
|
||||||
|
appInfo = appInfoDeferred.await(),
|
||||||
|
systemInfo = systemInfoDeferred.await(),
|
||||||
|
locationInfo = locationInfoDeferred.await(),
|
||||||
|
cameraInfo = cameraInfoDeferred.await(),
|
||||||
|
sensorInfo = sensorInfoDeferred.await(),
|
||||||
|
propsInfo = propsInfoDeferred.await(),
|
||||||
|
bluetoothInfo = bluetoothInfoDeferred.await(),
|
||||||
|
wifiInfo = wifiInfoDeferred.await(),
|
||||||
|
nfcInfo = nfcInfoDeferred.await(),
|
||||||
|
usbInfo = usbInfoDeferred.await(),
|
||||||
|
buildInfo = buildInfoDeferred.await(),
|
||||||
|
deviceId = identifiers.first,
|
||||||
|
deviceName = identifiers.second,
|
||||||
|
drmInfo = drmInfoDeferred.await(),
|
||||||
|
inputInfo = inputInfoDeferred.await(),
|
||||||
|
gaid = identifiers.third
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集并上传设备信息到服务器
|
||||||
|
*
|
||||||
|
* @param callback 上传结果回调 (成功消息, 错误异常)
|
||||||
|
*/
|
||||||
|
suspend fun collectAndUpload(callback: (String?, Exception?) -> Unit) {
|
||||||
|
try {
|
||||||
|
// 1. 收集所有信息
|
||||||
|
val deviceInfo = collectAllInfo()
|
||||||
|
|
||||||
|
// 2. 序列化为 JSON
|
||||||
|
val jsonData = gson.toJson(deviceInfo)
|
||||||
|
|
||||||
|
// 3. AES 加密
|
||||||
|
val encrypted = withContext(Dispatchers.Default) {
|
||||||
|
webService.encrypt(jsonData)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 4. 构建加密请求
|
||||||
|
val encryptedRequest = EncryptedRequest(encrypted)
|
||||||
|
val requestJson = gson.toJson(encryptedRequest)
|
||||||
|
|
||||||
|
// 5. 发送 POST 请求
|
||||||
|
withContext(Dispatchers.IO) {
|
||||||
|
webService.postData(upload_info_api, requestJson) { response, error ->
|
||||||
|
if (error != null) {
|
||||||
|
callback(null, error)
|
||||||
|
} else if (response != null) {
|
||||||
|
try {
|
||||||
|
val apiResponse = gson.fromJson(response, ApiResponse::class.java)
|
||||||
|
if (apiResponse.isSuccess()) {
|
||||||
|
callback(apiResponse.message, null)
|
||||||
|
} else {
|
||||||
|
callback(null, Exception("上传失败: ${apiResponse.message}"))
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
callback(null, Exception("解析响应失败: ${e.message}"))
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
callback(null, Exception("响应为空"))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
callback(null, Exception("收集信息失败: ${e.message}"))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集 CPU 信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectCpuInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val cpuInfo = AndInfo.instance.cpu
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"cores" to cpuInfo.cores.size,
|
||||||
|
"processors" to cpuInfo.processors.size,
|
||||||
|
"cpuAbi" to Build.SUPPORTED_ABIS.firstOrNull()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集 GPU 信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectGpuInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val gpuInfo = AndInfo.instance.gpu
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"vendor" to gpuInfo.getVendorName(),
|
||||||
|
"renderer" to gpuInfo.getRendererName(),
|
||||||
|
"vulkanSupported" to gpuInfo.isVulkanSupported(),
|
||||||
|
"vulkanVersion" to gpuInfo.getVulkanApiVersion(),
|
||||||
|
"openglVersion" to gpuInfo.getOpenGLVersion(),
|
||||||
|
"openglExtensionCount" to gpuInfo.getOpenGLExtensionCount(),
|
||||||
|
"eglVersion" to gpuInfo.getEglVersion()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集磁盘信息 (phone.hardware_new 相关字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectDiskInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val storageInfo = AndInfo.instance.storage
|
||||||
|
|
||||||
|
// 计算存储空间 GB
|
||||||
|
val totalStorageGB = String.format(java.util.Locale.US, "%.2f", storageInfo.internalStorageTotalSpace / (1024.0 * 1024.0 * 1024.0))
|
||||||
|
val usedStorageGB = String.format(java.util.Locale.US, "%.2f", storageInfo.internalStorageUsedSpace / (1024.0 * 1024.0 * 1024.0))
|
||||||
|
val freeStorageGB = String.format(java.util.Locale.US, "%.2f", storageInfo.internalStorageAvailableSpace / (1024.0 * 1024.0 * 1024.0))
|
||||||
|
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// 内部存储（字节）
|
||||||
|
"totalSpace" to storageInfo.internalStorageTotalSpace,
|
||||||
|
"freeSpace" to storageInfo.internalStorageAvailableSpace,
|
||||||
|
"usedSpace" to storageInfo.internalStorageUsedSpace,
|
||||||
|
|
||||||
|
// GB 单位
|
||||||
|
"totalStorageGB" to totalStorageGB,
|
||||||
|
"usedStorageGB" to usedStorageGB,
|
||||||
|
"freeStorageGB" to freeStorageGB,
|
||||||
|
|
||||||
|
// 数据目录 (/data)
|
||||||
|
"dataDirTotalSpace" to storageInfo.dataDirectoryTotalSpace,
|
||||||
|
"dataDirUsedSpace" to storageInfo.dataDirectoryUsedSpace,
|
||||||
|
|
||||||
|
// 文件系统类型
|
||||||
|
"fileSystemType" to storageInfo.internalStorageFileSystemType
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集屏幕信息 (phone.hardware_new 相关字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectScreenInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val displayInfo = AndInfo.instance.display.getDefaultDisplayInfo()
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// 分辨率
|
||||||
|
"maxWidthPixels" to (displayInfo?.widthPixels ?: -1),
|
||||||
|
"maxHeightPixels" to (displayInfo?.heightPixels ?: -1),
|
||||||
|
|
||||||
|
// DPI 和 PPI
|
||||||
|
"dpi" to (displayInfo?.densityDpi ?: -1),
|
||||||
|
"ppi" to (displayInfo?.ppi ?: -1),
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
// 刷新率
|
||||||
|
"maxRefreshRate" to (displayInfo?.refreshRate ?: -1),
|
||||||
|
"supportedRefreshRates" to (displayInfo?.supportedRefreshRates ?: emptyList<Float>()),
|
||||||
|
|
||||||
|
// HDR 支持
|
||||||
|
"isHdr" to (displayInfo?.isHdr ?: false),
|
||||||
|
"hdrTypes" to (displayInfo?.hdrTypes ?: emptyList<String>()),
|
||||||
|
|
||||||
|
// 广色域
|
||||||
|
"isWideColorGamut" to (displayInfo?.isWideColorGamut ?: false)
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集内存信息 (phone.hardware_new 相关字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectMemoryInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val memoryInfo = AndInfo.instance.memory.getMemoryInfo()
|
||||||
|
val mem = deviceInfo.getMemoryInfo()
|
||||||
|
|
||||||
|
// 计算总内存 GB
|
||||||
|
val totalMemoryGB = String.format(java.util.Locale.US, "%.2f", memoryInfo.totalRam / (1024.0 * 1024.0 * 1024.0))
|
||||||
|
val availMemoryGB = String.format(java.util.Locale.US, "%.2f", memoryInfo.availableRam / (1024.0 * 1024.0 * 1024.0))
|
||||||
|
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// 原始字节数
|
||||||
|
"totalMem" to memoryInfo.totalRam,
|
||||||
|
"availMem" to memoryInfo.availableRam,
|
||||||
|
|
||||||
|
// GB 单位
|
||||||
|
"totalMemoryGB" to totalMemoryGB,
|
||||||
|
"availMemoryGB" to availMemoryGB,
|
||||||
|
|
||||||
|
// RAM 类型（需要从系统属性推测）
|
||||||
|
"ramType" to memoryInfo.memType,
|
||||||
|
|
||||||
|
// 内存状态
|
||||||
|
"lowMemory" to mem.lowMemory,
|
||||||
|
"threshold" to mem.threshold
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集网络信息 (phone.hardware_new 相关字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectNetworkInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// SIM 卡相关
|
||||||
|
"simSlotCount" to getSimSlotCount(),
|
||||||
|
"supportEsim" to isEsimSupported(),
|
||||||
|
|
||||||
|
// 网络类型（5G/4G/3G）
|
||||||
|
"cellularGen" to getCellularGeneration(),
|
||||||
|
|
||||||
|
// WiFi 版本
|
||||||
|
"maxWifiVersion" to getMaxWifiVersion(),
|
||||||
|
|
||||||
|
// 蓝牙版本
|
||||||
|
"bluetoothVersion" to bluetoothInfo.getBluetoothVersion(),
|
||||||
|
|
||||||
|
// NFC 支持
|
||||||
|
"hasNFC" to inputInfo.hasNfcSupport()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取 SIM 卡槽数量
|
||||||
|
*/
|
||||||
|
private fun getSimSlotCount(): Int {
|
||||||
|
return try {
|
||||||
|
val telephonyManager = context.getSystemService(Context.TELEPHONY_SERVICE) as? android.telephony.TelephonyManager
|
||||||
|
telephonyManager?.phoneCount ?: 0
|
||||||
|
} catch (_: Exception) {
|
||||||
|
0
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检测是否支持 eSIM
|
||||||
|
*/
|
||||||
|
@android.annotation.SuppressLint("MissingPermission")
|
||||||
|
private fun isEsimSupported(): Boolean {
|
||||||
|
return try {
|
||||||
|
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
|
||||||
|
val telephonyManager = context.getSystemService(Context.TELEPHONY_SERVICE) as? android.telephony.TelephonyManager
|
||||||
|
telephonyManager?.let {
|
||||||
|
it.isMultiSimSupported == android.telephony.TelephonyManager.MULTISIM_ALLOWED &&
|
||||||
|
context.packageManager.hasSystemFeature(android.content.pm.PackageManager.FEATURE_TELEPHONY_EUICC)
|
||||||
|
} ?: false
|
||||||
|
} else {
|
||||||
|
false
|
||||||
|
}
|
||||||
|
} catch (_: Exception) {
|
||||||
|
false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取最大蜂窝网络代数 (3/4/5)
|
||||||
|
*/
|
||||||
|
private fun getCellularGeneration(): Int {
|
||||||
|
return try {
|
||||||
|
// 检查是否支持5G
|
||||||
|
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
|
||||||
|
if (context.packageManager.hasSystemFeature("android.hardware.telephony.5g")) {
|
||||||
|
return 5
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// 检查4G LTE
|
||||||
|
if (context.packageManager.hasSystemFeature(android.content.pm.PackageManager.FEATURE_TELEPHONY_GSM)) {
|
||||||
|
return 4
|
||||||
|
}
|
||||||
|
3 // 默认3G
|
||||||
|
} catch (_: Exception) {
|
||||||
|
4 // 默认返回4G
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取最大 WiFi 版本
|
||||||
|
* 8=WiFi 7, 7=WiFi 6E, 6=WiFi 6, 5=WiFi 5
|
||||||
|
*/
|
||||||
|
private fun getMaxWifiVersion(): Int {
|
||||||
|
return try {
|
||||||
|
when {
|
||||||
|
Build.VERSION.SDK_INT >= 34 && context.packageManager.hasSystemFeature("android.hardware.wifi.wifi7") -> 8 // WiFi 7
|
||||||
|
Build.VERSION.SDK_INT >= 31 && context.packageManager.hasSystemFeature("android.hardware.wifi.wifi6e") -> 7 // WiFi 6E
|
||||||
|
Build.VERSION.SDK_INT >= 30 && context.packageManager.hasSystemFeature("android.hardware.wifi.wifi6") -> 6 // WiFi 6
|
||||||
|
context.packageManager.hasSystemFeature("android.hardware.wifi.wifi5") -> 5 // WiFi 5
|
||||||
|
else -> 4 // WiFi 4 (802.11n)
|
||||||
|
}
|
||||||
|
} catch (_: Exception) {
|
||||||
|
5 // 默认 WiFi 5
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集电池信息 (phone.hardware_new 相关字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectBatteryInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val batteryInfo = AndInfo.instance.battery
|
||||||
|
val details = batteryInfo.getBatteryDetails()
|
||||||
|
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// 电池状态
|
||||||
|
"level" to details.percentage,
|
||||||
|
"health" to details.health,
|
||||||
|
"temperature" to details.temperature,
|
||||||
|
"voltage" to details.voltage,
|
||||||
|
"status" to details.status,
|
||||||
|
|
||||||
|
// 电池容量（毫安时）
|
||||||
|
"batteryDesignCapacity" to details.capacity,
|
||||||
|
"batteryCurrentCapacity" to details.chargeCounter,
|
||||||
|
|
||||||
|
// 充电相关
|
||||||
|
"isCharging" to details.isCharging,
|
||||||
|
"plugType" to details.plugType,
|
||||||
|
|
||||||
|
// 无线充电支持（需要检测）
|
||||||
|
"batteryWirelessSupported" to batteryInfo.isWirelessChargingSupported()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集设备信息 (phone.hardware_new 表字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectDeviceInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val buildInfo = AndInfo.instance.build
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// 基本信息
|
||||||
|
"brand" to deviceInfo.brand,
|
||||||
|
"model" to deviceInfo.model,
|
||||||
|
"manufacturer" to deviceInfo.manufacturer,
|
||||||
|
"device" to buildInfo.device,
|
||||||
|
|
||||||
|
// 硬件信息
|
||||||
|
"hardware" to deviceInfo.hardwareName,
|
||||||
|
"board" to deviceInfo.boardName,
|
||||||
|
|
||||||
|
// 设备类型
|
||||||
|
"formFactor" to buildInfo.formFactor,
|
||||||
|
"isTablet" to buildInfo.isTablet,
|
||||||
|
"isPhone" to buildInfo.isPhone,
|
||||||
|
|
||||||
|
// 架构信息
|
||||||
|
"linuxArchitecture" to buildInfo.kernelArchitecture,
|
||||||
|
|
||||||
|
// SoC 信息
|
||||||
|
"socManufacturer" to deviceInfo.socManufacturer,
|
||||||
|
"socModel" to deviceInfo.socModel,
|
||||||
|
|
||||||
|
// SKU 信息
|
||||||
|
"sku" to deviceInfo.hardwareSku,
|
||||||
|
"odmSku" to deviceInfo.odmSku
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集应用信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectAppInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"packageName" to context.packageName,
|
||||||
|
"versionName" to context.packageManager.getPackageInfo(context.packageName, 0).versionName
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集系统信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectSystemInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val buildInfo = AndInfo.instance.build
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"androidVersion" to buildInfo.versionRelease,
|
||||||
|
"sdkInt" to buildInfo.versionSdkInt,
|
||||||
|
"securityPatch" to buildInfo.securityPatch
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集定位信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectLocationInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"gpsSupported" to inputInfo.hasGpsSupport(),
|
||||||
|
"networkLocationSupported" to inputInfo.hasNetworkLocationSupport()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集相机信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectCameraInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val cameraInfo = AndInfo.instance.camera
|
||||||
|
val cameraIdList = cameraInfo.cameraIds
|
||||||
|
val cameraList = cameraIdList.mapNotNull { cameraInfo.getCameraDetails(it) }
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"cameraCount" to cameraList.size,
|
||||||
|
"cameras" to cameraList.map { it.cameraId }
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集传感器信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectSensorInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val sensorInfo = AndInfo.instance.sensor
|
||||||
|
val sensors = sensorInfo.getAllSensors()
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"sensorCount" to sensors.size,
|
||||||
|
"sensorTypes" to sensors.map { it.stringType }
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集系统属性信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectPropsInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val buildInfo = AndInfo.instance.build
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"fingerprint" to buildInfo.fingerprint,
|
||||||
|
"display" to buildInfo.display,
|
||||||
|
"id" to buildInfo.id
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集蓝牙信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectBluetoothInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val bluetoothInfo = AndInfo.instance.bluetooth
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"supported" to bluetoothInfo.isBluetoothLeSupported,
|
||||||
|
"enabled" to bluetoothInfo.isEnabled,
|
||||||
|
"name" to bluetoothInfo.adapterName
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集 WiFi 信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectWifiInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"supported" to true
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集 NFC 信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectNfcInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"supported" to inputInfo.hasNfcSupport(),
|
||||||
|
"hceSupported" to inputInfo.hasNfcHostCardEmulation(),
|
||||||
|
"secureNfc" to inputInfo.hasSecureNfcSupport()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集 USB 信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectUsbInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"hostSupported" to inputInfo.hasUsbHostSupport(),
|
||||||
|
"accessorySupported" to inputInfo.hasUsbAccessorySupport()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集构建信息 (phone.build 表字段)
|
||||||
|
*/
|
||||||
|
private suspend fun collectBuildInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val buildInfo = AndInfo.instance.build
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
// 基本信息
|
||||||
|
"brand" to buildInfo.brand,
|
||||||
|
"model" to buildInfo.model,
|
||||||
|
"device" to buildInfo.device,
|
||||||
|
"product" to buildInfo.product,
|
||||||
|
|
||||||
|
// SDK 和版本信息
|
||||||
|
"sdkInt" to buildInfo.versionSdkInt,
|
||||||
|
"androidVersion" to buildInfo.versionRelease,
|
||||||
|
|
||||||
|
// 构建信息
|
||||||
|
"buildId" to buildInfo.id,
|
||||||
|
"bootloader" to buildInfo.bootloaderVersion,
|
||||||
|
"display" to buildInfo.display,
|
||||||
|
"buildUser" to buildInfo.user,
|
||||||
|
"incremental" to buildInfo.incremental,
|
||||||
|
"buildHost" to buildInfo.host,
|
||||||
|
"buildFingerprint" to buildInfo.fingerprint,
|
||||||
|
|
||||||
|
// RIL 和 CSC 信息（三星专用）
|
||||||
|
"rilProductCode" to buildInfo.rilProductCode,
|
||||||
|
"rilOfficialCscver" to buildInfo.rilOfficialCscver,
|
||||||
|
"cscSalesCode" to buildInfo.cscSalesCode,
|
||||||
|
"countryISO" to buildInfo.countryISO,
|
||||||
|
|
||||||
|
// 内核和安全信息
|
||||||
|
"kernelVersion" to buildInfo.kernelVersion,
|
||||||
|
"securityPatch" to buildInfo.securityPatch,
|
||||||
|
"releaseDate" to buildInfo.buildDate.time,
|
||||||
|
|
||||||
|
// Treble 和系统更新
|
||||||
|
"trebleEnabled" to buildInfo.isTrebleEnabled,
|
||||||
|
"trebleVersion" to buildInfo.trebleVersion,
|
||||||
|
"seamlessUpdate" to buildInfo.isSeamlessUpdateSupported,
|
||||||
|
"currentSlot" to buildInfo.currentSlot,
|
||||||
|
|
||||||
|
// Root 和安全
|
||||||
|
"isRooted" to buildInfo.isRooted,
|
||||||
|
"seLinuxStatus" to buildInfo.seLinuxStatus
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集 DRM 信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectDrmInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val drmInfo = AndInfo.instance.drm
|
||||||
|
val drmSchemes = drmInfo.getSupportedDrmSchemes()
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"supportedSchemes" to drmSchemes.size,
|
||||||
|
"schemes" to drmSchemes.map { it.toString() }
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集输入设备信息
|
||||||
|
*/
|
||||||
|
private suspend fun collectInputInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
val inputInfo = AndInfo.instance.input
|
||||||
|
val devices = inputInfo.getInputDevices()
|
||||||
|
gson.toJson(mapOf<String, Any?>(
|
||||||
|
"deviceCount" to devices.size,
|
||||||
|
"hasFingerprint" to inputInfo.hasFingerprintSensor(),
|
||||||
|
"hasInfrared" to inputInfo.hasInfraredSensor(),
|
||||||
|
"hasUwb" to inputInfo.hasUwbSupport()
|
||||||
|
))
|
||||||
|
} catch (_: Exception) {
|
||||||
|
"{}"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 收集设备标识符（Device ID 和 GAID）
|
||||||
|
*
|
||||||
|
* @return Triple<DeviceId, DeviceName, GAID>
|
||||||
|
*/
|
||||||
|
private suspend fun collectIdentifiers(): Triple<String, String, String> = withContext(Dispatchers.IO) {
|
||||||
|
try {
|
||||||
|
val deviceInfo = AndInfo.instance.device
|
||||||
|
val androidId = deviceInfo.getAndroidId()
|
||||||
|
val deviceName = "${deviceInfo.brand} ${deviceInfo.model}"
|
||||||
|
val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
val gaid = gaidInfo?.id ?: ""
|
||||||
|
|
||||||
|
Triple(androidId, deviceName, gaid)
|
||||||
|
} catch (_: Exception) {
|
||||||
|
Triple("unknown", "unknown", "")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
@ -16,7 +16,9 @@ data class BatteryDetails(
|
|||||||
val maxInput: Int?, // in mA 最大输入电流
|
val maxInput: Int?, // in mA 最大输入电流
|
||||||
val capacity: Double?, // in mAh 电池容量
|
val capacity: Double?, // in mAh 电池容量
|
||||||
val chargeCounter: Int?, // in mAh 电量计量
|
val chargeCounter: Int?, // in mAh 电量计量
|
||||||
val chargeCycles: Int? // estimated cycles 充电周期 (估计值)
|
val chargeCycles: Int?, // estimated cycles 充电周期 (估计值)
|
||||||
|
val plugType: String, // 充电类型 (USB, AC, WIRELESS, NONE)
|
||||||
|
val status: String // 电池状态 (Charging, Discharging, Full, Not Charging, Unknown)
|
||||||
)
|
)
|
||||||
|
|
||||||
class BatteryInfo(private val context: Context) {
|
class BatteryInfo(private val context: Context) {
|
||||||
@ -84,6 +86,23 @@ class BatteryInfo(private val context: Context) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// 充电类型
|
||||||
|
val plugType = when (batteryStatus?.getIntExtra(BatteryManager.EXTRA_PLUGGED, -1) ?: -1) {
|
||||||
|
BatteryManager.BATTERY_PLUGGED_USB -> "USB"
|
||||||
|
BatteryManager.BATTERY_PLUGGED_AC -> "AC"
|
||||||
|
BatteryManager.BATTERY_PLUGGED_WIRELESS -> "WIRELESS"
|
||||||
|
else -> "NONE"
|
||||||
|
}
|
||||||
|
|
||||||
|
// 电池状态
|
||||||
|
val statusText = when (status) {
|
||||||
|
BatteryManager.BATTERY_STATUS_CHARGING -> "Charging"
|
||||||
|
BatteryManager.BATTERY_STATUS_DISCHARGING -> "Discharging"
|
||||||
|
BatteryManager.BATTERY_STATUS_FULL -> "Full"
|
||||||
|
BatteryManager.BATTERY_STATUS_NOT_CHARGING -> "Not Charging"
|
||||||
|
else -> "Unknown"
|
||||||
|
}
|
||||||
|
|
||||||
return BatteryDetails(
|
return BatteryDetails(
|
||||||
percentage = percentage,
|
percentage = percentage,
|
||||||
isCharging = isCharging,
|
isCharging = isCharging,
|
||||||
@ -95,7 +114,20 @@ class BatteryInfo(private val context: Context) {
|
|||||||
maxInput = maxInput,
|
maxInput = maxInput,
|
||||||
capacity = capacity,
|
capacity = capacity,
|
||||||
chargeCounter = chargeCounter,
|
chargeCounter = chargeCounter,
|
||||||
chargeCycles = chargeCycles
|
chargeCycles = chargeCycles,
|
||||||
|
plugType = plugType,
|
||||||
|
status = statusText
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检测是否支持无线充电
|
||||||
|
*/
|
||||||
|
fun isWirelessChargingSupported(): Boolean {
|
||||||
|
return try {
|
||||||
|
context.packageManager.hasSystemFeature("android.hardware.wireless_charging")
|
||||||
|
} catch (_: Exception) {
|
||||||
|
false
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
@ -366,29 +366,135 @@ class BluetoothInfo(private val context: Context) {
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 获取蓝牙版本（根据支持的特性推断）
|
* 获取蓝牙版本（根据支持的特性推断）
|
||||||
|
*
|
||||||
|
* 版本判断依据：
|
||||||
|
* - Bluetooth 5.4: Android 14+ 支持 LE Audio with LC3plus
|
||||||
|
* - Bluetooth 5.3: Android 13+ 支持 LE Audio
|
||||||
|
* - Bluetooth 5.2: Android 13+ 支持 LE Audio 基础功能
|
||||||
|
* - Bluetooth 5.1: Android 10+ 支持方向查找
|
||||||
|
* - Bluetooth 5.0: Android 8+ 支持 2Mbps PHY 或 Coded PHY
|
||||||
|
* - Bluetooth 4.2: Android 6+ 支持 BLE
|
||||||
|
* - Bluetooth 4.0: 支持 BLE
|
||||||
|
* - Bluetooth 3.0 或更低: 仅支持经典蓝牙
|
||||||
|
*
|
||||||
|
* @return 蓝牙版本字符串
|
||||||
*/
|
*/
|
||||||
private fun getBluetoothVersion(): String {
|
fun getBluetoothVersion(): String {
|
||||||
val adapter = bluetoothAdapter ?: return "未知"
|
val adapter = bluetoothAdapter ?: return "未知"
|
||||||
|
|
||||||
return when {
|
return when {
|
||||||
|
// Bluetooth 5.4+ (Android 14+, 支持 LC3plus 编解码器)
|
||||||
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE &&
|
||||||
|
context.packageManager.hasSystemFeature("android.hardware.bluetooth.le.audio") ->
|
||||||
|
"5.4"
|
||||||
|
|
||||||
|
// Bluetooth 5.3 (Android 13+, 支持 LE Audio)
|
||||||
Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU &&
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU &&
|
||||||
context.packageManager.hasSystemFeature("android.hardware.bluetooth.le.audio") ->
|
context.packageManager.hasSystemFeature("android.hardware.bluetooth.le.audio") ->
|
||||||
"Bluetooth 5.2+"
|
"5.3"
|
||||||
|
|
||||||
|
// Bluetooth 5.2 (Android 12+, 支持 LE Audio 基础功能)
|
||||||
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.S &&
|
||||||
|
context.packageManager.hasSystemFeature("android.hardware.bluetooth.le.audio") ->
|
||||||
|
"5.2"
|
||||||
|
|
||||||
|
// Bluetooth 5.1 (Android 10+, 支持方向查找)
|
||||||
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q &&
|
||||||
|
(adapter.isLe2MPhySupported || adapter.isLeCodedPhySupported ||
|
||||||
|
adapter.isLeExtendedAdvertisingSupported) ->
|
||||||
|
"5.1"
|
||||||
|
|
||||||
|
// Bluetooth 5.0 (Android 8+, 支持 2Mbps PHY 或 Coded PHY)
|
||||||
Build.VERSION.SDK_INT >= Build.VERSION_CODES.O &&
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.O &&
|
||||||
(adapter.isLe2MPhySupported || adapter.isLeCodedPhySupported) ->
|
(adapter.isLe2MPhySupported || adapter.isLeCodedPhySupported) ->
|
||||||
"Bluetooth 5.0"
|
"5.0"
|
||||||
|
|
||||||
|
// Bluetooth 4.2 (Android 6+, 支持增强的 BLE)
|
||||||
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && isBluetoothLeSupported ->
|
||||||
|
"4.2"
|
||||||
|
|
||||||
|
// Bluetooth 4.1 (Android 5+, 支持 BLE)
|
||||||
Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP && isBluetoothLeSupported ->
|
Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP && isBluetoothLeSupported ->
|
||||||
"Bluetooth 4.2"
|
"4.1"
|
||||||
|
|
||||||
|
// Bluetooth 4.0 (Android 4.3+, 首次支持 BLE)
|
||||||
isBluetoothLeSupported ->
|
isBluetoothLeSupported ->
|
||||||
"Bluetooth 4.0"
|
"4.0"
|
||||||
|
|
||||||
|
// Bluetooth 3.0 或更低（仅经典蓝牙）
|
||||||
else ->
|
else ->
|
||||||
"Bluetooth 3.0 或更低"
|
"3.0 或更低"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取详细的蓝牙版本信息（包含版本号和特性说明）
|
||||||
|
*
|
||||||
|
* @return 包含版本号和特性的详细字符串
|
||||||
|
*/
|
||||||
|
fun getBluetoothVersionDetails(): String {
|
||||||
|
val version = getBluetoothVersion()
|
||||||
|
val features = getBluetoothFeatures()
|
||||||
|
|
||||||
|
val details = buildString {
|
||||||
|
append("蓝牙 $version")
|
||||||
|
|
||||||
|
when {
|
||||||
|
version.startsWith("5.4") || version.startsWith("5.3") -> {
|
||||||
|
append(" (")
|
||||||
|
append("LE Audio")
|
||||||
|
if (features.leAudioBroadcast) append(", 广播")
|
||||||
|
if (features.leAudioUnicast) append(", 单播")
|
||||||
|
if (features.le2MbPhy) append(", 2Mbps PHY")
|
||||||
|
if (features.leCodedPhy) append(", Coded PHY")
|
||||||
|
append(")")
|
||||||
|
}
|
||||||
|
version.startsWith("5.2") -> {
|
||||||
|
append(" (LE Audio, LE Power Control)")
|
||||||
|
}
|
||||||
|
version.startsWith("5.1") -> {
|
||||||
|
append(" (方向查找, GATT 缓存)")
|
||||||
|
}
|
||||||
|
version.startsWith("5.0") -> {
|
||||||
|
append(" (")
|
||||||
|
val bt5Features = mutableListOf<String>()
|
||||||
|
if (features.le2MbPhy) bt5Features.add("2Mbps PHY")
|
||||||
|
if (features.leCodedPhy) bt5Features.add("Coded PHY")
|
||||||
|
if (features.leExtendedAdvertising) bt5Features.add("扩展广播")
|
||||||
|
if (features.lePeriodicAdvertising) bt5Features.add("周期性广播")
|
||||||
|
append(bt5Features.joinToString(", "))
|
||||||
|
append(")")
|
||||||
|
}
|
||||||
|
version.startsWith("4") -> {
|
||||||
|
append(" (低功耗蓝牙)")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return details
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取蓝牙版本的数字格式
|
||||||
|
*
|
||||||
|
* @return 版本号（如 5.3, 5.0, 4.2 等），如果无法确定则返回 0.0
|
||||||
|
*/
|
||||||
|
fun getBluetoothVersionNumber(): Double {
|
||||||
|
val versionString = getBluetoothVersion()
|
||||||
|
return when {
|
||||||
|
versionString.startsWith("5.4") -> 5.4
|
||||||
|
versionString.startsWith("5.3") -> 5.3
|
||||||
|
versionString.startsWith("5.2") -> 5.2
|
||||||
|
versionString.startsWith("5.1") -> 5.1
|
||||||
|
versionString.startsWith("5.0") -> 5.0
|
||||||
|
versionString.startsWith("4.2") -> 4.2
|
||||||
|
versionString.startsWith("4.1") -> 4.1
|
||||||
|
versionString.startsWith("4.0") -> 4.0
|
||||||
|
versionString.startsWith("3") -> 3.0
|
||||||
|
else -> 0.0
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@ -31,6 +31,55 @@ class BuildInfo(private val context: Context) {
|
|||||||
val fingerprint: String
|
val fingerprint: String
|
||||||
get() = Build.FINGERPRINT
|
get() = Build.FINGERPRINT
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 品牌
|
||||||
|
* 示例: "samsung", "google", "xiaomi"
|
||||||
|
*/
|
||||||
|
val brand: String
|
||||||
|
get() = Build.BRAND
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 机型
|
||||||
|
* 示例: "SM-G998B", "Pixel 6 Pro"
|
||||||
|
*/
|
||||||
|
val model: String
|
||||||
|
get() = Build.MODEL
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 产品名称
|
||||||
|
* 示例: "x1seea", "redfin"
|
||||||
|
*/
|
||||||
|
val product: String
|
||||||
|
get() = Build.PRODUCT
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备代号
|
||||||
|
* 示例: "p3s", "redfin"
|
||||||
|
*/
|
||||||
|
val device: String
|
||||||
|
get() = Build.DEVICE
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 主板名称
|
||||||
|
* 示例: "s5e9925"
|
||||||
|
*/
|
||||||
|
val board: String
|
||||||
|
get() = Build.BOARD
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 制造商
|
||||||
|
* 示例: "samsung", "Google"
|
||||||
|
*/
|
||||||
|
val manufacturer: String
|
||||||
|
get() = Build.MANUFACTURER
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 硬件标识
|
||||||
|
* 示例: "qcom", "exynos2200"
|
||||||
|
*/
|
||||||
|
val hardware: String
|
||||||
|
get() = Build.HARDWARE
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 构建标签
|
* 构建标签
|
||||||
* 通常为 "release-keys" (正式版) 或 "test-keys" (测试版)
|
* 通常为 "release-keys" (正式版) 或 "test-keys" (测试版)
|
||||||
@ -158,6 +207,111 @@ class BuildInfo(private val context: Context) {
|
|||||||
val releaseOrPreviewDisplay: String?
|
val releaseOrPreviewDisplay: String?
|
||||||
get() = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) Build.VERSION.RELEASE_OR_PREVIEW_DISPLAY else null
|
get() = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) Build.VERSION.RELEASE_OR_PREVIEW_DISPLAY else null
|
||||||
|
|
||||||
|
// ==================== RIL 和 CSC 信息 ====================
|
||||||
|
|
||||||
|
/**
|
||||||
|
* RIL 产品代码
|
||||||
|
* Radio Interface Layer 产品代码（三星设备）
|
||||||
|
* 示例: "SM-G998BZKDEUB"
|
||||||
|
*/
|
||||||
|
val rilProductCode: String?
|
||||||
|
get() = getSystemProperty("ro.ril.product_code")
|
||||||
|
?: getSystemProperty("ril.product_code")
|
||||||
|
|
||||||
|
/**
|
||||||
|
* RIL 官方 CSC 版本
|
||||||
|
* CSC (Customer Service Code) 官方版本（三星设备）
|
||||||
|
* 示例: "G998BXXU4CWE1"
|
||||||
|
*/
|
||||||
|
val rilOfficialCscver: String?
|
||||||
|
get() = getSystemProperty("ro.ril.official_cscver")
|
||||||
|
?: getSystemProperty("ril.official_cscver")
|
||||||
|
|
||||||
|
/**
|
||||||
|
* CSC 销售代码
|
||||||
|
* 表示设备的销售地区/运营商代码（三星设备）
|
||||||
|
* 示例: "XEU" (欧洲未锁定), "ATT" (AT&T), "TMB" (T-Mobile)
|
||||||
|
*/
|
||||||
|
val cscSalesCode: String?
|
||||||
|
get() = getSystemProperty("ro.csc.sales_code")
|
||||||
|
?: getSystemProperty("ril.sales_code")
|
||||||
|
?: getSystemProperty("persist.sys.omc_etcpath")?.substringAfterLast("/")
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 国家/地区 ISO 代码
|
||||||
|
* 小写 ISO 标准代码，世界版本为 "zz"
|
||||||
|
* 示例: "us", "cn", "kr", "zz"
|
||||||
|
*/
|
||||||
|
val countryISO: String?
|
||||||
|
get() {
|
||||||
|
// 尝试多个来源获取国家代码
|
||||||
|
val country = getSystemProperty("ro.product.locale.region")
|
||||||
|
?: getSystemProperty("persist.sys.country")
|
||||||
|
?: getSystemProperty("ro.product.country")
|
||||||
|
?: Locale.getDefault().country
|
||||||
|
|
||||||
|
return country?.lowercase()?.takeIf { it.isNotEmpty() }
|
||||||
|
}
|
||||||
|
|
||||||
|
// ==================== 设备类型 ====================
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备外形因素/类型
|
||||||
|
* 判断设备是手机(Phone)还是平板(Tablet)
|
||||||
|
* @return "Phone", "Tablet" 或 "Unknown"
|
||||||
|
*/
|
||||||
|
val formFactor: String
|
||||||
|
get() {
|
||||||
|
// 检查系统属性
|
||||||
|
val deviceType = getSystemProperty("ro.build.characteristics")
|
||||||
|
if (deviceType != null) {
|
||||||
|
return when {
|
||||||
|
deviceType.contains("tablet", ignoreCase = true) -> "Tablet"
|
||||||
|
deviceType.contains("phone", ignoreCase = true) -> "Phone"
|
||||||
|
else -> deviceType
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 通过 PackageManager 特性判断
|
||||||
|
val packageManager = context.packageManager
|
||||||
|
return when {
|
||||||
|
// 检查是否有电话功能（手机的标志）
|
||||||
|
packageManager.hasSystemFeature(PackageManager.FEATURE_TELEPHONY) -> {
|
||||||
|
// 有电话功能，但还要检查屏幕尺寸
|
||||||
|
val config = context.resources.configuration
|
||||||
|
val screenLayout = config.screenLayout and android.content.res.Configuration.SCREENLAYOUT_SIZE_MASK
|
||||||
|
// 大屏幕且有电话功能可能是平板带电话（如某些三星平板）
|
||||||
|
if (screenLayout >= android.content.res.Configuration.SCREENLAYOUT_SIZE_XLARGE) {
|
||||||
|
"Tablet"
|
||||||
|
} else {
|
||||||
|
"Phone"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// 没有电话功能，通过屏幕尺寸判断
|
||||||
|
else -> {
|
||||||
|
val config = context.resources.configuration
|
||||||
|
val screenLayout = config.screenLayout and android.content.res.Configuration.SCREENLAYOUT_SIZE_MASK
|
||||||
|
when {
|
||||||
|
screenLayout >= android.content.res.Configuration.SCREENLAYOUT_SIZE_LARGE -> "Tablet"
|
||||||
|
else -> "Unknown"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 是否为平板设备
|
||||||
|
*/
|
||||||
|
val isTablet: Boolean
|
||||||
|
get() = formFactor == "Tablet"
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 是否为手机设备
|
||||||
|
*/
|
||||||
|
val isPhone: Boolean
|
||||||
|
get() = formFactor == "Phone"
|
||||||
|
|
||||||
// ==================== JVM 信息 ====================
|
// ==================== JVM 信息 ====================
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@ -684,6 +838,14 @@ class BuildInfo(private val context: Context) {
|
|||||||
// 基本构建信息
|
// 基本构建信息
|
||||||
sb.append("=== 系统构建信息 ===\n")
|
sb.append("=== 系统构建信息 ===\n")
|
||||||
sb.append("指纹: $fingerprint\n")
|
sb.append("指纹: $fingerprint\n")
|
||||||
|
sb.append("品牌: $brand\n")
|
||||||
|
sb.append("机型: $model\n")
|
||||||
|
sb.append("产品: $product\n")
|
||||||
|
sb.append("设备代号: $device\n")
|
||||||
|
sb.append("主板: $board\n")
|
||||||
|
sb.append("制造商: $manufacturer\n")
|
||||||
|
sb.append("硬件: $hardware\n")
|
||||||
|
sb.append("设备类型: $formFactor\n")
|
||||||
sb.append("显示ID: $display\n")
|
sb.append("显示ID: $display\n")
|
||||||
sb.append("构建ID: $id\n")
|
sb.append("构建ID: $id\n")
|
||||||
sb.append("类型: $type\n")
|
sb.append("类型: $type\n")
|
||||||
@ -692,6 +854,15 @@ class BuildInfo(private val context: Context) {
|
|||||||
sb.append("构建用户: $user\n")
|
sb.append("构建用户: $user\n")
|
||||||
sb.append("构建主机: $host\n")
|
sb.append("构建主机: $host\n")
|
||||||
|
|
||||||
|
// RIL 和 CSC 信息（主要用于三星设备）
|
||||||
|
if (rilProductCode != null || rilOfficialCscver != null || cscSalesCode != null) {
|
||||||
|
sb.append("\n=== RIL/CSC 信息 ===\n")
|
||||||
|
rilProductCode?.let { sb.append("RIL产品代码: $it\n") }
|
||||||
|
rilOfficialCscver?.let { sb.append("RIL官方CSC版本: $it\n") }
|
||||||
|
cscSalesCode?.let { sb.append("CSC销售代码: $it\n") }
|
||||||
|
countryISO?.let { sb.append("国家/地区ISO: $it\n") }
|
||||||
|
}
|
||||||
|
|
||||||
// Android 版本信息
|
// Android 版本信息
|
||||||
sb.append("\n=== Android 版本 ===\n")
|
sb.append("\n=== Android 版本 ===\n")
|
||||||
sb.append("版本号: $versionRelease\n")
|
sb.append("版本号: $versionRelease\n")
|
||||||
|
|||||||
@ -3,8 +3,11 @@ package com.xyzshell.andinfo.libs
|
|||||||
import android.app.ActivityManager
|
import android.app.ActivityManager
|
||||||
import android.content.Context
|
import android.content.Context
|
||||||
import android.os.Build
|
import android.os.Build
|
||||||
|
import android.provider.Settings
|
||||||
|
import kotlinx.coroutines.Dispatchers
|
||||||
|
import kotlinx.coroutines.withContext
|
||||||
|
|
||||||
// 设备信息工具类
|
// 设备信息工具类
|
||||||
class DeviceInfo(private val context: Context) {
|
class DeviceInfo(private val context: Context) {
|
||||||
|
|
||||||
// ActivityManager 用于获取内存等系统服务
|
// ActivityManager 用于获取内存等系统服务
|
||||||
@ -63,4 +66,137 @@ class DeviceInfo(private val context: Context) {
|
|||||||
activityManager.getMemoryInfo(memoryInfo)
|
activityManager.getMemoryInfo(memoryInfo)
|
||||||
return memoryInfo
|
return memoryInfo
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ==================== 设备标识符 ====================
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取 Android ID (Device ID)
|
||||||
|
* 64位十六进制字符串，设备首次启动时随机生成
|
||||||
|
*
|
||||||
|
* 注意事项：
|
||||||
|
* - 出厂重置后会改变
|
||||||
|
* - Android 8.0+ 后，每个应用和用户组合都会获得不同的 Android ID
|
||||||
|
* - 不需要特殊权限
|
||||||
|
*
|
||||||
|
* @return Android ID，如果获取失败则返回 "unknown"
|
||||||
|
*/
|
||||||
|
@Suppress("HardwareIds")
|
||||||
|
fun getAndroidId(): String {
|
||||||
|
return try {
|
||||||
|
Settings.Secure.getString(context.contentResolver, Settings.Secure.ANDROID_ID) ?: "unknown"
|
||||||
|
} catch (e: Exception) {
|
||||||
|
"unknown"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取 Google Advertising ID (GAID)
|
||||||
|
* 用于广告追踪的匿名标识符
|
||||||
|
*
|
||||||
|
* 注意事项：
|
||||||
|
* - 需要 Google Play Services
|
||||||
|
* - 用户可以重置此 ID
|
||||||
|
* - 用户可以选择限制广告追踪
|
||||||
|
* - 必须在后台线程调用
|
||||||
|
* - 需要添加依赖: com.google.android.gms:play-services-ads-identifier
|
||||||
|
*
|
||||||
|
* 使用示例：
|
||||||
|
* ```kotlin
|
||||||
|
* lifecycleScope.launch {
|
||||||
|
* val gaidInfo = deviceInfo.getAdvertisingId()
|
||||||
|
* if (gaidInfo != null) {
|
||||||
|
* println("GAID: ${gaidInfo.id}")
|
||||||
|
* println("是否限制追踪: ${gaidInfo.isLimitAdTrackingEnabled}")
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @return AdvertisingIdInfo 对象，包含 GAID 和追踪限制状态；如果获取失败则返回 null
|
||||||
|
*/
|
||||||
|
suspend fun getAdvertisingId(): AdvertisingIdInfo? = withContext(Dispatchers.IO) {
|
||||||
|
try {
|
||||||
|
// 使用反射调用 AdvertisingIdClient，避免强制依赖
|
||||||
|
val advertisingIdClientClass = Class.forName("com.google.android.gms.ads.identifier.AdvertisingIdClient")
|
||||||
|
val getAdvertisingIdInfoMethod = advertisingIdClientClass.getMethod("getAdvertisingIdInfo", Context::class.java)
|
||||||
|
val adInfo = getAdvertisingIdInfoMethod.invoke(null, context)
|
||||||
|
|
||||||
|
// 获取 ID 和追踪限制状态
|
||||||
|
val getId = adInfo.javaClass.getMethod("getId")
|
||||||
|
val isLimitAdTrackingEnabled = adInfo.javaClass.getMethod("isLimitAdTrackingEnabled")
|
||||||
|
|
||||||
|
val id = getId.invoke(adInfo) as? String
|
||||||
|
val isLimited = isLimitAdTrackingEnabled.invoke(adInfo) as? Boolean ?: false
|
||||||
|
|
||||||
|
if (id != null) {
|
||||||
|
AdvertisingIdInfo(id, isLimited)
|
||||||
|
} else {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
// Google Play Services 不可用或其他错误
|
||||||
|
null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 同步获取 GAID（不推荐，可能阻塞线程）
|
||||||
|
* 仅用于特殊场景，建议使用 getAdvertisingId() 的协程版本
|
||||||
|
*
|
||||||
|
* @return AdvertisingIdInfo 对象或 null
|
||||||
|
*/
|
||||||
|
fun getAdvertisingIdSync(): AdvertisingIdInfo? {
|
||||||
|
return try {
|
||||||
|
val advertisingIdClientClass = Class.forName("com.google.android.gms.ads.identifier.AdvertisingIdClient")
|
||||||
|
val getAdvertisingIdInfoMethod = advertisingIdClientClass.getMethod("getAdvertisingIdInfo", Context::class.java)
|
||||||
|
val adInfo = getAdvertisingIdInfoMethod.invoke(null, context)
|
||||||
|
|
||||||
|
val getId = adInfo.javaClass.getMethod("getId")
|
||||||
|
val isLimitAdTrackingEnabled = adInfo.javaClass.getMethod("isLimitAdTrackingEnabled")
|
||||||
|
|
||||||
|
val id = getId.invoke(adInfo) as? String
|
||||||
|
val isLimited = isLimitAdTrackingEnabled.invoke(adInfo) as? Boolean ?: false
|
||||||
|
|
||||||
|
if (id != null) {
|
||||||
|
AdvertisingIdInfo(id, isLimited)
|
||||||
|
} else {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 广告标识符信息数据类
|
||||||
|
*
|
||||||
|
* @property id Google Advertising ID (GAID)
|
||||||
|
* @property isLimitAdTrackingEnabled 用户是否限制广告追踪
|
||||||
|
*/
|
||||||
|
data class AdvertisingIdInfo(
|
||||||
|
val id: String, // GAID，示例: "38400000-8cf0-11bd-b23e-10b96e40000d"
|
||||||
|
val isLimitAdTrackingEnabled: Boolean // 是否限制广告追踪
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取所有可用的设备标识符
|
||||||
|
*
|
||||||
|
* @return DeviceIdentifiers 对象，包含所有标识符
|
||||||
|
*/
|
||||||
|
suspend fun getDeviceIdentifiers(): DeviceIdentifiers {
|
||||||
|
return DeviceIdentifiers(
|
||||||
|
androidId = getAndroidId(),
|
||||||
|
advertisingId = getAdvertisingId()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备标识符集合数据类
|
||||||
|
*
|
||||||
|
* @property androidId Android ID (设备标识符)
|
||||||
|
* @property advertisingId 广告标识符信息（可能为 null）
|
||||||
|
*/
|
||||||
|
data class DeviceIdentifiers(
|
||||||
|
val androidId: String, // Android ID
|
||||||
|
val advertisingId: AdvertisingIdInfo? // 广告标识符（如果可用）
|
||||||
|
)
|
||||||
}
|
}
|
||||||
|
|||||||
@ -1,55 +1,307 @@
|
|||||||
package com.xyzshell.andinfo.libs
|
package com.xyzshell.andinfo.libs
|
||||||
|
|
||||||
import android.content.Context
|
import android.content.Context
|
||||||
|
import android.content.pm.PackageManager
|
||||||
import android.hardware.input.InputManager
|
import android.hardware.input.InputManager
|
||||||
import android.os.Build
|
import android.os.Build
|
||||||
import android.view.InputDevice
|
import android.view.InputDevice
|
||||||
import android.view.KeyCharacterMap
|
import android.view.KeyCharacterMap
|
||||||
import androidx.annotation.RequiresApi
|
import androidx.annotation.RequiresApi
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 输入设备信息工具类
|
||||||
|
* 提供所有输入设备（键盘、鼠标、触摸屏、游戏手柄等）的详细信息
|
||||||
|
*/
|
||||||
class InputInfo(private val context: Context) {
|
class InputInfo(private val context: Context) {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 输入管理器
|
||||||
|
*/
|
||||||
private val inputManager = context.getSystemService(InputManager::class.java)
|
private val inputManager = context.getSystemService(InputManager::class.java)
|
||||||
|
|
||||||
fun getInputDevices(): List<InputDeviceInfo> {
|
/**
|
||||||
return inputManager.inputDeviceIds.toList().mapNotNull { id ->
|
* 获取所有输入设备列表
|
||||||
inputManager.getInputDevice(id)?.let { device -> InputDeviceInfo(device) }
|
* @return 输入设备信息列表
|
||||||
}
|
*/
|
||||||
}
|
fun getInputDevices(): List<InputDeviceInfo> {
|
||||||
|
return inputManager.inputDeviceIds.toList().mapNotNull { id ->
|
||||||
|
inputManager.getInputDevice(id)?.let { device -> InputDeviceInfo(device) }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 根据设备ID获取指定的输入设备信息
|
||||||
|
* @param deviceId 设备ID
|
||||||
|
* @return 输入设备信息，如果设备不存在则返回null
|
||||||
|
*/
|
||||||
fun getInputDevice(deviceId: Int): InputDeviceInfo? {
|
fun getInputDevice(deviceId: Int): InputDeviceInfo? {
|
||||||
return inputManager.getInputDevice(deviceId)?.let { device ->
|
return inputManager.getInputDevice(deviceId)?.let { device ->
|
||||||
InputDeviceInfo(device)
|
InputDeviceInfo(device)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取触摸的最大遮挡不透明度
|
||||||
|
* Android 12+ 可用
|
||||||
|
* 用于安全性，防止恶意应用遮挡触摸事件
|
||||||
|
* @return 最大不透明度值 (0.0-1.0)
|
||||||
|
*/
|
||||||
@RequiresApi(Build.VERSION_CODES.S)
|
@RequiresApi(Build.VERSION_CODES.S)
|
||||||
fun getMaximumObscuringOpacityForTouch(): Float {
|
fun getMaximumObscuringOpacityForTouch(): Float {
|
||||||
return inputManager.maximumObscuringOpacityForTouch
|
return inputManager.maximumObscuringOpacityForTouch
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查是否启用了触控笔指针图标
|
||||||
|
* Android 14+ 可用
|
||||||
|
* @return 是否启用触控笔指针图标
|
||||||
|
*/
|
||||||
@RequiresApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
|
@RequiresApi(Build.VERSION_CODES.UPSIDE_DOWN_CAKE)
|
||||||
fun isStylusPointerIconEnabled(): Boolean {
|
fun isStylusPointerIconEnabled(): Boolean {
|
||||||
return inputManager.isStylusPointerIconEnabled
|
return inputManager.isStylusPointerIconEnabled
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ==================== 硬件特性检测 ====================
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查设备是否支持 USB Host 模式
|
||||||
|
* USB Host 模式允许 Android 设备作为主机连接其他 USB 设备
|
||||||
|
* @return 是否支持 USB Host
|
||||||
|
*/
|
||||||
|
fun hasUsbHostSupport(): Boolean {
|
||||||
|
return context.packageManager.hasSystemFeature(PackageManager.FEATURE_USB_HOST)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查设备是否支持 USB 配件模式
|
||||||
|
* USB 配件模式允许 Android 设备作为 USB 配件连接到其他设备
|
||||||
|
* @return 是否支持 USB 配件模式
|
||||||
|
*/
|
||||||
|
fun hasUsbAccessorySupport(): Boolean {
|
||||||
|
return context.packageManager.hasSystemFeature(PackageManager.FEATURE_USB_ACCESSORY)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查设备是否有指纹识别器
|
||||||
|
* @return 是否有指纹识别器
|
||||||
|
*/
|
||||||
|
fun hasFingerprintSensor(): Boolean {
|
||||||
|
return context.packageManager.hasSystemFeature(PackageManager.FEATURE_FINGERPRINT)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查设备是否有红外线传感器（IR Blaster）
|
||||||
|
* 红外线传感器可用于遥控电视、空调等设备
|
||||||
|
* @return 是否有红外线传感器
|
||||||
|
*/
|
||||||
|
fun hasInfraredSensor(): Boolean {
|
||||||
|
return context.packageManager.hasSystemFeature(PackageManager.FEATURE_CONSUMER_IR)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查设备是否支持 UWB（Ultra-Wideband 超宽带）
|
||||||
|
* UWB 用于精确定位和设备间通信
|
||||||
|
* Android 12+ 可用
|
||||||
|
* @return 是否支持 UWB
|
||||||
|
*/
|
||||||
|
fun hasUwbSupport(): Boolean {
|
||||||
|
return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
|
||||||
|
context.packageManager.hasSystemFeature(PackageManager.FEATURE_UWB)
|
||||||
|
} else {
|
||||||
|
false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查设备是否支持 NFC（Near Field Communication 近场通信）
|
||||||
|
* @return 是否支持 NFC
|
||||||
|
*/
|
||||||
|
fun hasNfcSupport(): Boolean {
|
||||||
|
return context.packageManager.hasSystemFeature(PackageManager.FEATURE_NFC)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查设备是否支持 NFC HCE（Host Card Emulation 主机卡模拟）
|
||||||
|
* HCE 允许应用模拟 NFC 卡片
|
||||||
|
* @return 是否支持 NFC HCE
|
||||||
|
*/
|
||||||
|
fun hasNfcHostCardEmulation(): Boolean {
|
||||||
|
return context.packageManager.hasSystemFeature(PackageManager.FEATURE_NFC_HOST_CARD_EMULATION)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查设备是否支持 NFC 离线主机卡模拟
|
||||||
|
* 允许在设备离线时进行 NFC 交易
|
||||||
|
* @return 是否支持离线 HCE
|
||||||
|
*/
|
||||||
|
fun hasNfcHostCardEmulationOffHost(): Boolean {
|
||||||
|
return context.packageManager.hasSystemFeature(PackageManager.FEATURE_NFC_HOST_CARD_EMULATION_NFCF)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查设备是否支持安全 NFC（NFC with Secure Element）
|
||||||
|
* 使用安全元素进行 NFC 交易，更安全
|
||||||
|
* @return 是否支持安全 NFC
|
||||||
|
*/
|
||||||
|
fun hasSecureNfcSupport(): Boolean {
|
||||||
|
// 检查是否有安全元素相关的 NFC 功能
|
||||||
|
return context.packageManager.hasSystemFeature("android.hardware.nfc.ese") ||
|
||||||
|
context.packageManager.hasSystemFeature("android.hardware.nfc.uicc")
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查设备是否支持 GPS 定位
|
||||||
|
* @return 是否支持 GPS
|
||||||
|
*/
|
||||||
|
fun hasGpsSupport(): Boolean {
|
||||||
|
return context.packageManager.hasSystemFeature(PackageManager.FEATURE_LOCATION_GPS)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查设备是否支持网络定位
|
||||||
|
* @return 是否支持网络定位
|
||||||
|
*/
|
||||||
|
fun hasNetworkLocationSupport(): Boolean {
|
||||||
|
return context.packageManager.hasSystemFeature(PackageManager.FEATURE_LOCATION_NETWORK)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查设备是否支持任何定位服务
|
||||||
|
* @return 是否支持定位
|
||||||
|
*/
|
||||||
|
fun hasLocationSupport(): Boolean {
|
||||||
|
return context.packageManager.hasSystemFeature(PackageManager.FEATURE_LOCATION)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取所有硬件特性支持信息
|
||||||
|
* @return 硬件特性支持信息数据类
|
||||||
|
*/
|
||||||
|
fun getHardwareFeatures(): HardwareFeatures {
|
||||||
|
return HardwareFeatures(
|
||||||
|
usbHost = hasUsbHostSupport(),
|
||||||
|
usbAccessory = hasUsbAccessorySupport(),
|
||||||
|
fingerprint = hasFingerprintSensor(),
|
||||||
|
infrared = hasInfraredSensor(),
|
||||||
|
uwb = hasUwbSupport(),
|
||||||
|
nfc = hasNfcSupport(),
|
||||||
|
nfcHce = hasNfcHostCardEmulation(),
|
||||||
|
nfcHceOffHost = hasNfcHostCardEmulationOffHost(),
|
||||||
|
secureNfc = hasSecureNfcSupport(),
|
||||||
|
gps = hasGpsSupport(),
|
||||||
|
networkLocation = hasNetworkLocationSupport(),
|
||||||
|
location = hasLocationSupport()
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 硬件特性支持信息数据类
|
||||||
|
*/
|
||||||
|
data class HardwareFeatures(
|
||||||
|
val usbHost: Boolean, // USB Host 支持
|
||||||
|
val usbAccessory: Boolean, // USB 配件支持
|
||||||
|
val fingerprint: Boolean, // 指纹识别器
|
||||||
|
val infrared: Boolean, // 红外线传感器
|
||||||
|
val uwb: Boolean, // UWB 支持
|
||||||
|
val nfc: Boolean, // NFC 支持
|
||||||
|
val nfcHce: Boolean, // NFC 主机卡模拟
|
||||||
|
val nfcHceOffHost: Boolean, // NFC 离线主机卡模拟
|
||||||
|
val secureNfc: Boolean, // 安全 NFC
|
||||||
|
val gps: Boolean, // GPS 支持
|
||||||
|
val networkLocation: Boolean, // 网络定位支持
|
||||||
|
val location: Boolean // 任何定位支持
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 输入设备详细信息数据类
|
||||||
|
* 包含设备的所有属性和功能
|
||||||
|
*/
|
||||||
data class InputDeviceInfo(val inputDevice: InputDevice) {
|
data class InputDeviceInfo(val inputDevice: InputDevice) {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备ID
|
||||||
|
* 唯一标识一个输入设备
|
||||||
|
*/
|
||||||
val id: Int get() = inputDevice.id
|
val id: Int get() = inputDevice.id
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 控制器编号
|
||||||
|
* 对于游戏手柄，表示第几个手柄（1-4）
|
||||||
|
*/
|
||||||
val controllerNumber: Int get() = inputDevice.controllerNumber
|
val controllerNumber: Int get() = inputDevice.controllerNumber
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 供应商ID
|
||||||
|
* USB设备的供应商标识
|
||||||
|
*/
|
||||||
val vendorId: Int get() = inputDevice.vendorId
|
val vendorId: Int get() = inputDevice.vendorId
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 产品ID
|
||||||
|
* USB设备的产品标识
|
||||||
|
*/
|
||||||
val productId: Int get() = inputDevice.productId
|
val productId: Int get() = inputDevice.productId
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备描述符
|
||||||
|
* 设备的唯一描述字符串
|
||||||
|
*/
|
||||||
val descriptor: String? get() = inputDevice.descriptor
|
val descriptor: String? get() = inputDevice.descriptor
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 是否为虚拟设备
|
||||||
|
* 虚拟设备如软键盘、注入的输入事件等
|
||||||
|
*/
|
||||||
val isVirtual: Boolean get() = inputDevice.isVirtual
|
val isVirtual: Boolean get() = inputDevice.isVirtual
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 是否为外部设备
|
||||||
|
* Android 10+ 可用
|
||||||
|
* 外部设备如USB键盘、蓝牙鼠标等
|
||||||
|
*/
|
||||||
val isExternal: Boolean
|
val isExternal: Boolean
|
||||||
get() = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
|
get() = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
|
||||||
inputDevice.isExternal
|
inputDevice.isExternal
|
||||||
} else {
|
} else {
|
||||||
false
|
false
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备名称
|
||||||
|
* 示例: "Virtual Keyboard", "USB Mouse", "Bluetooth Gamepad"
|
||||||
|
*/
|
||||||
val name: String get() = inputDevice.name
|
val name: String get() = inputDevice.name
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 输入源类型标志位
|
||||||
|
* 表示设备支持的输入类型（键盘、鼠标、触摸屏等）
|
||||||
|
*/
|
||||||
val sources: Int get() = inputDevice.sources
|
val sources: Int get() = inputDevice.sources
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 键盘类型
|
||||||
|
* KEYBOARD_TYPE_NONE - 无键盘
|
||||||
|
* KEYBOARD_TYPE_NON_ALPHABETIC - 非字母键盘（如数字键盘）
|
||||||
|
* KEYBOARD_TYPE_ALPHABETIC - 字母键盘
|
||||||
|
*/
|
||||||
val keyboardType: Int get() = inputDevice.keyboardType
|
val keyboardType: Int get() = inputDevice.keyboardType
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 键盘字符映射类型
|
||||||
|
* 表示键盘的字符映射能力
|
||||||
|
*/
|
||||||
val keyCharacterMapKeyboardType: Int get() = inputDevice.keyCharacterMap.keyboardType
|
val keyCharacterMapKeyboardType: Int get() = inputDevice.keyCharacterMap.keyboardType
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 运动范围数量
|
||||||
|
* 表示设备支持的轴数量（如游戏手柄的摇杆、扳机键等）
|
||||||
|
*/
|
||||||
val motionRangesCount: Int get() = inputDevice.motionRanges.size
|
val motionRangesCount: Int get() = inputDevice.motionRanges.size
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 是否有震动功能
|
||||||
|
* Android 12+ 使用 vibratorManager，之前版本使用 vibrator
|
||||||
|
*/
|
||||||
val hasVibrator: Boolean
|
val hasVibrator: Boolean
|
||||||
get() = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
|
get() = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
|
||||||
inputDevice.vibratorManager.vibratorIds.isNotEmpty()
|
inputDevice.vibratorManager.vibratorIds.isNotEmpty()
|
||||||
@ -57,21 +309,47 @@ class InputInfo(private val context: Context) {
|
|||||||
@Suppress("DEPRECATION")
|
@Suppress("DEPRECATION")
|
||||||
inputDevice.vibrator.hasVibrator()
|
inputDevice.vibrator.hasVibrator()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备是否已启用
|
||||||
|
* Android 8.1+ 可用
|
||||||
|
* 禁用的设备不会产生输入事件
|
||||||
|
*/
|
||||||
val isEnabled: Boolean
|
val isEnabled: Boolean
|
||||||
get() = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O_MR1) {
|
get() = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O_MR1) {
|
||||||
inputDevice.isEnabled
|
inputDevice.isEnabled
|
||||||
} else {
|
} else {
|
||||||
true
|
true
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 是否有麦克风
|
||||||
|
* 某些输入设备（如游戏手柄）可能内置麦克风
|
||||||
|
*/
|
||||||
val hasMicrophone: Boolean get() = inputDevice.hasMicrophone()
|
val hasMicrophone: Boolean get() = inputDevice.hasMicrophone()
|
||||||
|
|
||||||
companion object {
|
companion object {
|
||||||
|
/**
|
||||||
|
* 键盘类型映射表（英文）
|
||||||
|
*/
|
||||||
val keyboardTypeToString = mapOf(
|
val keyboardTypeToString = mapOf(
|
||||||
InputDevice.KEYBOARD_TYPE_NONE to "None",
|
InputDevice.KEYBOARD_TYPE_NONE to "None",
|
||||||
InputDevice.KEYBOARD_TYPE_NON_ALPHABETIC to "Non-alphabetic",
|
InputDevice.KEYBOARD_TYPE_NON_ALPHABETIC to "Non-alphabetic",
|
||||||
InputDevice.KEYBOARD_TYPE_ALPHABETIC to "Alphabetic",
|
InputDevice.KEYBOARD_TYPE_ALPHABETIC to "Alphabetic",
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 键盘类型映射表（中文）
|
||||||
|
*/
|
||||||
|
val keyboardTypeToStringChinese = mapOf(
|
||||||
|
InputDevice.KEYBOARD_TYPE_NONE to "无键盘",
|
||||||
|
InputDevice.KEYBOARD_TYPE_NON_ALPHABETIC to "非字母键盘",
|
||||||
|
InputDevice.KEYBOARD_TYPE_ALPHABETIC to "字母键盘",
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 键盘字符映射类型映射表（英文）
|
||||||
|
*/
|
||||||
val keyCharacterMapKeyboardTypeToString = mapOf(
|
val keyCharacterMapKeyboardTypeToString = mapOf(
|
||||||
KeyCharacterMap.NUMERIC to "Numeric",
|
KeyCharacterMap.NUMERIC to "Numeric",
|
||||||
KeyCharacterMap.PREDICTIVE to "Predictive",
|
KeyCharacterMap.PREDICTIVE to "Predictive",
|
||||||
@ -80,6 +358,20 @@ class InputInfo(private val context: Context) {
|
|||||||
KeyCharacterMap.SPECIAL_FUNCTION to "Special Function",
|
KeyCharacterMap.SPECIAL_FUNCTION to "Special Function",
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 键盘字符映射类型映射表（中文）
|
||||||
|
*/
|
||||||
|
val keyCharacterMapKeyboardTypeToStringChinese = mapOf(
|
||||||
|
KeyCharacterMap.NUMERIC to "数字键盘",
|
||||||
|
KeyCharacterMap.PREDICTIVE to "预测输入",
|
||||||
|
KeyCharacterMap.ALPHA to "字母键盘",
|
||||||
|
KeyCharacterMap.FULL to "完整键盘",
|
||||||
|
KeyCharacterMap.SPECIAL_FUNCTION to "特殊功能键盘",
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 输入源类别映射表（英文）
|
||||||
|
*/
|
||||||
val sourceClassToString = mapOf(
|
val sourceClassToString = mapOf(
|
||||||
InputDevice.SOURCE_CLASS_BUTTON to "Button",
|
InputDevice.SOURCE_CLASS_BUTTON to "Button",
|
||||||
InputDevice.SOURCE_CLASS_POINTER to "Pointer",
|
InputDevice.SOURCE_CLASS_POINTER to "Pointer",
|
||||||
@ -88,6 +380,20 @@ class InputInfo(private val context: Context) {
|
|||||||
InputDevice.SOURCE_CLASS_JOYSTICK to "Joystick",
|
InputDevice.SOURCE_CLASS_JOYSTICK to "Joystick",
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 输入源类别映射表（中文）
|
||||||
|
*/
|
||||||
|
val sourceClassToStringChinese = mapOf(
|
||||||
|
InputDevice.SOURCE_CLASS_BUTTON to "按钮",
|
||||||
|
InputDevice.SOURCE_CLASS_POINTER to "指针",
|
||||||
|
InputDevice.SOURCE_CLASS_TRACKBALL to "轨迹球",
|
||||||
|
InputDevice.SOURCE_CLASS_POSITION to "位置",
|
||||||
|
InputDevice.SOURCE_CLASS_JOYSTICK to "游戏杆",
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 输入源类型映射表（英文）
|
||||||
|
*/
|
||||||
val sourceToString = mapOf(
|
val sourceToString = mapOf(
|
||||||
InputDevice.SOURCE_KEYBOARD to "Keyboard",
|
InputDevice.SOURCE_KEYBOARD to "Keyboard",
|
||||||
InputDevice.SOURCE_DPAD to "D-Pad",
|
InputDevice.SOURCE_DPAD to "D-Pad",
|
||||||
@ -102,6 +408,24 @@ class InputInfo(private val context: Context) {
|
|||||||
InputDevice.SOURCE_JOYSTICK to "Joystick",
|
InputDevice.SOURCE_JOYSTICK to "Joystick",
|
||||||
InputDevice.SOURCE_HDMI to "HDMI",
|
InputDevice.SOURCE_HDMI to "HDMI",
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 输入源类型映射表（中文）
|
||||||
|
*/
|
||||||
|
val sourceToStringChinese = mapOf(
|
||||||
|
InputDevice.SOURCE_KEYBOARD to "键盘",
|
||||||
|
InputDevice.SOURCE_DPAD to "方向键",
|
||||||
|
InputDevice.SOURCE_GAMEPAD to "游戏手柄",
|
||||||
|
InputDevice.SOURCE_TOUCHSCREEN to "触摸屏",
|
||||||
|
InputDevice.SOURCE_MOUSE to "鼠标",
|
||||||
|
InputDevice.SOURCE_STYLUS to "触控笔",
|
||||||
|
InputDevice.SOURCE_TRACKBALL to "轨迹球",
|
||||||
|
InputDevice.SOURCE_TOUCHPAD to "触控板",
|
||||||
|
InputDevice.SOURCE_TOUCH_NAVIGATION to "触摸导航",
|
||||||
|
InputDevice.SOURCE_ROTARY_ENCODER to "旋转编码器",
|
||||||
|
InputDevice.SOURCE_JOYSTICK to "游戏杆",
|
||||||
|
InputDevice.SOURCE_HDMI to "HDMI",
|
||||||
|
)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@ -2,20 +2,31 @@ package com.xyzshell.andinfo.libs
|
|||||||
|
|
||||||
import android.content.Context
|
import android.content.Context
|
||||||
import java.io.File
|
import java.io.File
|
||||||
import java.io.RandomAccessFile
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 内存信息数据类
|
||||||
|
* 包含设备的完整内存信息
|
||||||
|
*/
|
||||||
data class MemoryInfo(
|
data class MemoryInfo(
|
||||||
val totalRam: Long, // 总内存 (字节)
|
val totalRam: Long, // 总内存 (字节)
|
||||||
val availableRam: Long, // 可用内存 (字节)
|
val availableRam: Long, // 可用内存 (字节)
|
||||||
val usedRam: Long, // 已使用内存 (字节)
|
val usedRam: Long, // 已使用内存 (字节)
|
||||||
val memType: String, // 内存类型 (LPDDR4/LPDDR5等)
|
val memType: String, // 内存类型 (LPDDR4/LPDDR5/LPDDR5X等)
|
||||||
val channels: Int, // 内存通道数
|
val channels: Int, // 内存通道数 (1/2/4)
|
||||||
val zramTotal: Long, // zram 总大小 (字节)
|
val zramTotal: Long, // zram 总大小 (字节)
|
||||||
val zramUsed: Long // zram 已使用 (字节)
|
val zramUsed: Long // zram 已使用 (字节)
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 内存信息工具类
|
||||||
|
* 提供内存相关的详细信息，包括总内存、可用内存、内存类型、通道数、ZRAM等
|
||||||
|
*/
|
||||||
class MemInfo(private val context: Context){
|
class MemInfo(private val context: Context){
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取完整的内存信息
|
||||||
|
* @return MemoryInfo 包含所有内存相关信息的数据对象
|
||||||
|
*/
|
||||||
fun getMemoryInfo(): MemoryInfo {
|
fun getMemoryInfo(): MemoryInfo {
|
||||||
val totalRam = getTotalMemory()
|
val totalRam = getTotalMemory()
|
||||||
val availableRam = getAvailableMemory()
|
val availableRam = getAvailableMemory()
|
||||||
@ -35,6 +46,11 @@ class MemInfo(private val context: Context){
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取总内存大小
|
||||||
|
* 从 /proc/meminfo 读取 MemTotal 值
|
||||||
|
* @return 总内存字节数
|
||||||
|
*/
|
||||||
private fun getTotalMemory(): Long {
|
private fun getTotalMemory(): Long {
|
||||||
return try {
|
return try {
|
||||||
val memInfo = File("/proc/meminfo")
|
val memInfo = File("/proc/meminfo")
|
||||||
@ -46,6 +62,11 @@ class MemInfo(private val context: Context){
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取可用内存大小
|
||||||
|
* 从 /proc/meminfo 读取 MemAvailable 值
|
||||||
|
* @return 可用内存字节数
|
||||||
|
*/
|
||||||
private fun getAvailableMemory(): Long {
|
private fun getAvailableMemory(): Long {
|
||||||
return try {
|
return try {
|
||||||
val memInfo = File("/proc/meminfo")
|
val memInfo = File("/proc/meminfo")
|
||||||
@ -57,33 +78,255 @@ class MemInfo(private val context: Context){
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取内存类型（LPDDR4、LPDDR4X、LPDDR5、LPDDR5X等）
|
||||||
|
* 通过多种方式检测内存类型
|
||||||
|
*/
|
||||||
private fun getMemoryType(): String {
|
private fun getMemoryType(): String {
|
||||||
return try {
|
return try {
|
||||||
// 尝试从多个可能的位置读取
|
// 1. 尝试从系统属性获取
|
||||||
val paths = listOf(
|
val propResult = getMemoryTypeFromProps()
|
||||||
"/sys/class/devfreq/ddrfreq/device/type",
|
if (propResult != "Unknown") return propResult
|
||||||
"/sys/class/devfreq/soc:qcom,cpu-cpu-llcc-bw/device/type",
|
|
||||||
"/proc/device-tree/memory/device_type"
|
|
||||||
)
|
|
||||||
|
|
||||||
for (path in paths) {
|
// 2. 尝试从 sysfs 设备文件获取
|
||||||
val file = File(path)
|
val sysfsResult = getMemoryTypeFromSysfs()
|
||||||
if (file.exists()) {
|
if (sysfsResult != "Unknown") return sysfsResult
|
||||||
val content = file.readText().trim()
|
|
||||||
if (content.isNotEmpty()) {
|
|
||||||
return content
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// 尝试从 getprop 获取
|
// 3. 尝试从设备树获取
|
||||||
Runtime.getRuntime().exec("getprop ro.boot.ddr_type").inputStream.bufferedReader().readText().trim()
|
val deviceTreeResult = getMemoryTypeFromDeviceTree()
|
||||||
.ifEmpty { "Unknown" }
|
if (deviceTreeResult != "Unknown") return deviceTreeResult
|
||||||
|
|
||||||
|
// 4. 尝试从内核日志获取
|
||||||
|
val dmesgResult = getMemoryTypeFromDmesg()
|
||||||
|
if (dmesgResult != "Unknown") return dmesgResult
|
||||||
|
|
||||||
|
// 5. 根据 Android 版本和设备信息推测
|
||||||
|
val estimatedType = estimateMemoryType()
|
||||||
|
if (estimatedType != "Unknown") return estimatedType
|
||||||
|
|
||||||
|
"Unknown"
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
"Unknown"
|
"Unknown"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从系统属性获取内存类型
|
||||||
|
*/
|
||||||
|
private fun getMemoryTypeFromProps(): String {
|
||||||
|
val propKeys = listOf(
|
||||||
|
"ro.boot.ddr_type",
|
||||||
|
"ro.boot.ddrtype",
|
||||||
|
"ro.boot.em.ddr_type",
|
||||||
|
"ro.vendor.boot.ddr_type",
|
||||||
|
"ro.product.vendor.boot.ddr_type",
|
||||||
|
"persist.vendor.ddr.type",
|
||||||
|
"vendor.boot.ddr.type"
|
||||||
|
)
|
||||||
|
|
||||||
|
for (key in propKeys) {
|
||||||
|
try {
|
||||||
|
val result = Runtime.getRuntime()
|
||||||
|
.exec(arrayOf("getprop", key))
|
||||||
|
.inputStream.bufferedReader().readText().trim()
|
||||||
|
|
||||||
|
if (result.isNotEmpty() && result != "Unknown") {
|
||||||
|
return parseMemoryType(result)
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return "Unknown"
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从 sysfs 文件系统获取内存类型
|
||||||
|
*/
|
||||||
|
private fun getMemoryTypeFromSysfs(): String {
|
||||||
|
val paths = listOf(
|
||||||
|
// Qualcomm 设备
|
||||||
|
"/sys/class/devfreq/soc:qcom,cpu-cpu-llcc-bw/device/type",
|
||||||
|
"/sys/class/devfreq/soc:qcom,cpu-llcc-ddr-bw/device/type",
|
||||||
|
"/sys/class/devfreq/ddrfreq/device/type",
|
||||||
|
"/sys/devices/platform/soc/soc:qcom,cpu-cpu-llcc-bw/devfreq/*/type",
|
||||||
|
"/sys/kernel/debug/clk/measure_only_mccc_clk/measure",
|
||||||
|
|
||||||
|
// MediaTek 设备
|
||||||
|
"/sys/kernel/debug/emi_mbw/dram_type",
|
||||||
|
"/sys/devices/platform/soc/10012000.dvfsrc/helio-dvfsrc/dvfsrc_dump",
|
||||||
|
|
||||||
|
// Samsung Exynos 设备
|
||||||
|
"/sys/class/devfreq/17000010.devfreq_mif/device/type",
|
||||||
|
"/sys/devices/platform/17000010.devfreq_mif/devfreq/devfreq0/type",
|
||||||
|
|
||||||
|
// 通用路径
|
||||||
|
"/proc/device-tree/memory/device_type",
|
||||||
|
"/sys/firmware/devicetree/base/memory/device_type"
|
||||||
|
)
|
||||||
|
|
||||||
|
for (path in paths) {
|
||||||
|
try {
|
||||||
|
val file = File(path)
|
||||||
|
if (file.exists() && file.canRead()) {
|
||||||
|
val content = file.readText().trim()
|
||||||
|
if (content.isNotEmpty()) {
|
||||||
|
val parsed = parseMemoryType(content)
|
||||||
|
if (parsed != "Unknown") return parsed
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return "Unknown"
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从设备树获取内存类型
|
||||||
|
*/
|
||||||
|
private fun getMemoryTypeFromDeviceTree(): String {
|
||||||
|
val dtPaths = listOf(
|
||||||
|
"/proc/device-tree/memory/ddr-type",
|
||||||
|
"/proc/device-tree/memory@*/ddr-type",
|
||||||
|
"/sys/firmware/devicetree/base/memory/ddr-type",
|
||||||
|
"/sys/firmware/devicetree/base/memory@*/ddr-type"
|
||||||
|
)
|
||||||
|
|
||||||
|
for (path in dtPaths) {
|
||||||
|
try {
|
||||||
|
if (path.contains("*")) {
|
||||||
|
// 处理通配符路径
|
||||||
|
val parent = File(path.substringBeforeLast("/"))
|
||||||
|
if (parent.exists()) {
|
||||||
|
parent.listFiles()?.forEach { file ->
|
||||||
|
if (file.name.startsWith("memory") && File(file, "ddr-type").exists()) {
|
||||||
|
val content = File(file, "ddr-type").readText().trim()
|
||||||
|
val parsed = parseMemoryType(content)
|
||||||
|
if (parsed != "Unknown") return parsed
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
val file = File(path)
|
||||||
|
if (file.exists()) {
|
||||||
|
val content = file.readText().trim()
|
||||||
|
val parsed = parseMemoryType(content)
|
||||||
|
if (parsed != "Unknown") return parsed
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return "Unknown"
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从内核日志获取内存类型
|
||||||
|
*/
|
||||||
|
private fun getMemoryTypeFromDmesg(): String {
|
||||||
|
try {
|
||||||
|
val dmesg = Runtime.getRuntime()
|
||||||
|
.exec(arrayOf("sh", "-c", "dmesg | grep -iE 'ddr|lpddr|memory.*type'"))
|
||||||
|
.inputStream.bufferedReader().readText()
|
||||||
|
|
||||||
|
return parseMemoryType(dmesg)
|
||||||
|
} catch (e: Exception) {
|
||||||
|
return "Unknown"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 解析内存类型字符串，提取标准化的内存类型
|
||||||
|
*/
|
||||||
|
private fun parseMemoryType(input: String): String {
|
||||||
|
val normalized = input.uppercase()
|
||||||
|
|
||||||
|
return when {
|
||||||
|
// LPDDR5X
|
||||||
|
normalized.contains("LPDDR5X") ||
|
||||||
|
normalized.contains("LPDDR5-X") ||
|
||||||
|
normalized.contains("LP5X") -> "LPDDR5X"
|
||||||
|
|
||||||
|
// LPDDR5
|
||||||
|
normalized.contains("LPDDR5") ||
|
||||||
|
normalized.contains("LP5") ||
|
||||||
|
normalized.contains("DDR5") && normalized.contains("LP") -> "LPDDR5"
|
||||||
|
|
||||||
|
// LPDDR4X
|
||||||
|
normalized.contains("LPDDR4X") ||
|
||||||
|
normalized.contains("LPDDR4-X") ||
|
||||||
|
normalized.contains("LP4X") -> "LPDDR4X"
|
||||||
|
|
||||||
|
// LPDDR4
|
||||||
|
normalized.contains("LPDDR4") ||
|
||||||
|
normalized.contains("LP4") ||
|
||||||
|
normalized.contains("DDR4") && normalized.contains("LP") -> "LPDDR4"
|
||||||
|
|
||||||
|
// LPDDR3
|
||||||
|
normalized.contains("LPDDR3") ||
|
||||||
|
normalized.contains("LP3") ||
|
||||||
|
normalized.contains("DDR3") && normalized.contains("LP") -> "LPDDR3"
|
||||||
|
|
||||||
|
// LPDDR2
|
||||||
|
normalized.contains("LPDDR2") ||
|
||||||
|
normalized.contains("LP2") -> "LPDDR2"
|
||||||
|
|
||||||
|
// DDR5 (非LP)
|
||||||
|
normalized.contains("DDR5") -> "DDR5"
|
||||||
|
|
||||||
|
// DDR4 (非LP)
|
||||||
|
normalized.contains("DDR4") -> "DDR4"
|
||||||
|
|
||||||
|
// DDR3 (非LP)
|
||||||
|
normalized.contains("DDR3") -> "DDR3"
|
||||||
|
|
||||||
|
else -> "Unknown"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 根据 Android SDK 版本和发布年份估算内存类型
|
||||||
|
*/
|
||||||
|
private fun estimateMemoryType(): String {
|
||||||
|
return try {
|
||||||
|
val sdkInt = android.os.Build.VERSION.SDK_INT
|
||||||
|
val year = android.os.Build.TIME / 1000 / 60 / 60 / 24 / 365 + 1970
|
||||||
|
|
||||||
|
// 根据 SDK 版本和年份推测
|
||||||
|
when {
|
||||||
|
// Android 14+ (2023年后)，旗舰设备可能使用 LPDDR5X
|
||||||
|
sdkInt >= 34 && year >= 2023 -> "LPDDR5X (estimated)"
|
||||||
|
|
||||||
|
// Android 13 (2022-2023)，高端设备使用 LPDDR5
|
||||||
|
sdkInt >= 33 && year >= 2022 -> "LPDDR5 (estimated)"
|
||||||
|
|
||||||
|
// Android 12 (2021-2022)，开始出现 LPDDR5
|
||||||
|
sdkInt >= 31 && year >= 2021 -> "LPDDR5 (estimated)"
|
||||||
|
|
||||||
|
// Android 11 (2020-2021)，主流使用 LPDDR4X
|
||||||
|
sdkInt >= 30 && year >= 2020 -> "LPDDR4X (estimated)"
|
||||||
|
|
||||||
|
// Android 10 (2019-2020)，使用 LPDDR4X
|
||||||
|
sdkInt >= 29 && year >= 2019 -> "LPDDR4X (estimated)"
|
||||||
|
|
||||||
|
// 更早期的设备，使用 LPDDR4 或 LPDDR3
|
||||||
|
sdkInt >= 28 -> "LPDDR4 (estimated)"
|
||||||
|
|
||||||
|
else -> "LPDDR3 (estimated)"
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
"Unknown"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取内存通道数
|
||||||
|
* 通道数影响内存带宽，常见的有单通道、双通道、四通道
|
||||||
|
*
|
||||||
|
* @return 内存通道数 (1/2/4)，默认返回 2（双通道）
|
||||||
|
*/
|
||||||
private fun getMemoryChannels(): Int {
|
private fun getMemoryChannels(): Int {
|
||||||
return try {
|
return try {
|
||||||
// 尝试从设备树或内核日志获取
|
// 尝试从设备树或内核日志获取
|
||||||
@ -103,12 +346,18 @@ class MemInfo(private val context: Context){
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取 ZRAM（压缩内存）信息
|
||||||
|
* ZRAM 是一种压缩内存技术，可以在内存不足时提供额外的"虚拟内存"
|
||||||
|
*
|
||||||
|
* @return Pair<总大小, 已使用大小> (字节)
|
||||||
|
*/
|
||||||
private fun getZramInfo(): Pair<Long, Long> {
|
private fun getZramInfo(): Pair<Long, Long> {
|
||||||
return try {
|
return try {
|
||||||
var total = 0L
|
var total = 0L
|
||||||
var used = 0L
|
var used = 0L
|
||||||
|
|
||||||
// 检查所有 zram 设备
|
// 检查所有 zram 设备 (通常是 zram0 到 zram7)
|
||||||
for (i in 0..7) {
|
for (i in 0..7) {
|
||||||
val devicePath = "/sys/block/zram$i"
|
val devicePath = "/sys/block/zram$i"
|
||||||
if (!File(devicePath).exists()) continue
|
if (!File(devicePath).exists()) continue
|
||||||
@ -130,13 +379,18 @@ class MemInfo(private val context: Context){
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// 格式化内存大小
|
/**
|
||||||
|
* 格式化字节数为人类可读的格式
|
||||||
|
*
|
||||||
|
* @param bytes 字节数
|
||||||
|
* @return 格式化后的字符串 (如 "4.00 GB", "512.00 MB")
|
||||||
|
*/
|
||||||
fun formatBytes(bytes: Long): String {
|
fun formatBytes(bytes: Long): String {
|
||||||
return when {
|
return when {
|
||||||
bytes < 1024 -> "$bytes B"
|
bytes < 1024 -> "$bytes B"
|
||||||
bytes < 1024 * 1024 -> String.format("%.2f KB", bytes / 1024.0)
|
bytes < 1024 * 1024 -> String.format(java.util.Locale.US, "%.2f KB", bytes / 1024.0)
|
||||||
bytes < 1024 * 1024 * 1024 -> String.format("%.2f MB", bytes / (1024.0 * 1024))
|
bytes < 1024 * 1024 * 1024 -> String.format(java.util.Locale.US, "%.2f MB", bytes / (1024.0 * 1024))
|
||||||
else -> String.format("%.2f GB", bytes / (1024.0 * 1024 * 1024))
|
else -> String.format(java.util.Locale.US, "%.2f GB", bytes / (1024.0 * 1024 * 1024))
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@ -7,36 +7,43 @@ package com.xyzshell.andinfo.libs.cpu.models
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* `struct cpuinfo_cache`
|
* `struct cpuinfo_cache`
|
||||||
|
* CPU缓存结构体
|
||||||
*/
|
*/
|
||||||
data class Cache(
|
data class Cache(
|
||||||
/**
|
/**
|
||||||
* Cache size in bytes
|
* Cache size in bytes
|
||||||
|
* 缓存大小（字节）
|
||||||
*/
|
*/
|
||||||
val size: UInt,
|
val size: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Number of ways of associativity
|
* Number of ways of associativity
|
||||||
|
* 缓存关联路数
|
||||||
*/
|
*/
|
||||||
val associativity: UInt,
|
val associativity: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Number of sets
|
* Number of sets
|
||||||
|
* 缓存组数
|
||||||
*/
|
*/
|
||||||
val sets: UInt,
|
val sets: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Number of partitions
|
* Number of partitions
|
||||||
|
* 分区数量
|
||||||
*/
|
*/
|
||||||
val partitions: UInt,
|
val partitions: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Line size in bytes
|
* Line size in bytes
|
||||||
|
* 缓存行大小（字节）
|
||||||
*/
|
*/
|
||||||
val lineSize: UInt,
|
val lineSize: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Binary characteristics of the cache (unified cache, inclusive cache,
|
* Binary characteristics of the cache (unified cache, inclusive cache,
|
||||||
* cache with complex indexing).
|
* cache with complex indexing).
|
||||||
|
* 缓存的二进制特性标志（统一缓存、包容缓存、复杂索引缓存）
|
||||||
*
|
*
|
||||||
* @see `CPUINFO_CACHE_UNIFIED`, `CPUINFO_CACHE_INCLUSIVE`,
|
* @see `CPUINFO_CACHE_UNIFIED`, `CPUINFO_CACHE_INCLUSIVE`,
|
||||||
* `CPUINFO_CACHE_COMPLEX_INDEXING`
|
* `CPUINFO_CACHE_COMPLEX_INDEXING`
|
||||||
@ -45,11 +52,13 @@ data class Cache(
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* Index of the first logical processor that shares this cache
|
* Index of the first logical processor that shares this cache
|
||||||
|
* 共享此缓存的第一个逻辑处理器的索引
|
||||||
*/
|
*/
|
||||||
val processorStart: UInt,
|
val processorStart: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Number of logical processors that share this cache
|
* Number of logical processors that share this cache
|
||||||
|
* 共享此缓存的逻辑处理器数量
|
||||||
*/
|
*/
|
||||||
val processorCount: UInt,
|
val processorCount: UInt,
|
||||||
) {
|
) {
|
||||||
|
|||||||
@ -7,64 +7,78 @@ package com.xyzshell.andinfo.libs.cpu.models
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* `struct cpuinfo_cluster`
|
* `struct cpuinfo_cluster`
|
||||||
|
* CPU核心集群信息结构体（big.LITTLE架构中的大核小核集群）
|
||||||
*/
|
*/
|
||||||
data class Cluster(
|
data class Cluster(
|
||||||
/**
|
/**
|
||||||
* Index of the first logical processor in the cluster
|
* Index of the first logical processor in the cluster
|
||||||
|
* 集群中第一个逻辑处理器的索引
|
||||||
*/
|
*/
|
||||||
val processorStart: UInt,
|
val processorStart: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Number of logical processors in the cluster
|
* Number of logical processors in the cluster
|
||||||
|
* 集群中的逻辑处理器数量
|
||||||
*/
|
*/
|
||||||
val processorCount: UInt,
|
val processorCount: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Index of the first core in the cluster
|
* Index of the first core in the cluster
|
||||||
|
* 集群中第一个核心的索引
|
||||||
*/
|
*/
|
||||||
val coreStart: UInt,
|
val coreStart: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Number of cores on the cluster
|
* Number of cores on the cluster
|
||||||
|
* 集群中的核心数量
|
||||||
*/
|
*/
|
||||||
val coreCount: UInt,
|
val coreCount: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Cluster ID within a package
|
* Cluster ID within a package
|
||||||
|
* 封装内的集群ID
|
||||||
*/
|
*/
|
||||||
val clusterId: UInt,
|
val clusterId: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Physical package containing the cluster
|
* Physical package containing the cluster
|
||||||
|
* 包含此集群的物理封装
|
||||||
*/
|
*/
|
||||||
val cpuPackage: Package,
|
val cpuPackage: Package,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* CPU microarchitecture vendor of the cores in the cluster
|
* CPU microarchitecture vendor of the cores in the cluster
|
||||||
|
* 集群中核心的CPU微架构供应商
|
||||||
*/
|
*/
|
||||||
val vendor: Vendor,
|
val vendor: Vendor,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* CPU microarchitecture of the cores in the cluster
|
* CPU microarchitecture of the cores in the cluster
|
||||||
|
* 集群中核心的CPU微架构
|
||||||
*/
|
*/
|
||||||
val uarch: Uarch,
|
val uarch: Uarch,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* x86 only
|
* x86 only
|
||||||
|
* 仅x86架构
|
||||||
*
|
*
|
||||||
* Value of CPUID leaf 1 EAX register of the cores in the cluster
|
* Value of CPUID leaf 1 EAX register of the cores in the cluster
|
||||||
|
* 集群中核心的CPUID leaf 1 EAX寄存器值
|
||||||
*/
|
*/
|
||||||
val cpuid: UInt?,
|
val cpuid: UInt?,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM and ARM64 only
|
* ARM and ARM64 only
|
||||||
|
* 仅ARM和ARM64架构
|
||||||
*
|
*
|
||||||
* Value of Main ID Register (MIDR) of the cores in the cluster
|
* Value of Main ID Register (MIDR) of the cores in the cluster
|
||||||
|
* 集群中核心的主ID寄存器（MIDR）值
|
||||||
*/
|
*/
|
||||||
val midr: Midr?,
|
val midr: Midr?,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Clock rate (non-Turbo) of the cores in the cluster, in Hz
|
* Clock rate (non-Turbo) of the cores in the cluster, in Hz
|
||||||
|
* 集群中核心的时钟频率（非睿频），单位赫兹（Hz）
|
||||||
*/
|
*/
|
||||||
val frequency: ULong,
|
val frequency: ULong,
|
||||||
) {
|
) {
|
||||||
|
|||||||
@ -7,59 +7,72 @@ package com.xyzshell.andinfo.libs.cpu.models
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* `struct cpuinfo_core`
|
* `struct cpuinfo_core`
|
||||||
|
* CPU核心信息结构体
|
||||||
*/
|
*/
|
||||||
data class Core(
|
data class Core(
|
||||||
/**
|
/**
|
||||||
* Index of the first logical processor on this core.
|
* Index of the first logical processor on this core.
|
||||||
|
* 此核心上第一个逻辑处理器的索引
|
||||||
*/
|
*/
|
||||||
val processorStart: UInt,
|
val processorStart: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Number of logical processors on this core
|
* Number of logical processors on this core
|
||||||
|
* 此核心上的逻辑处理器数量
|
||||||
*/
|
*/
|
||||||
val processorCount: UInt,
|
val processorCount: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Core ID within a package
|
* Core ID within a package
|
||||||
|
* 核心在封装内的ID
|
||||||
*/
|
*/
|
||||||
val coreId: UInt,
|
val coreId: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Cluster containing this core
|
* Cluster containing this core
|
||||||
|
* 包含此核心的集群
|
||||||
*/
|
*/
|
||||||
val cluster: Cluster,
|
val cluster: Cluster,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Physical package containing this core.
|
* Physical package containing this core.
|
||||||
|
* 包含此核心的物理封装
|
||||||
*/
|
*/
|
||||||
val cpuPackage: Package,
|
val cpuPackage: Package,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Vendor of the CPU microarchitecture for this core
|
* Vendor of the CPU microarchitecture for this core
|
||||||
|
* 此核心的CPU微架构供应商
|
||||||
*/
|
*/
|
||||||
val vendor: Vendor,
|
val vendor: Vendor,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* CPU microarchitecture for this core
|
* CPU microarchitecture for this core
|
||||||
|
* 此核心的CPU微架构
|
||||||
*/
|
*/
|
||||||
val uarch: Uarch,
|
val uarch: Uarch,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* x86 only
|
* x86 only
|
||||||
|
* 仅x86架构
|
||||||
*
|
*
|
||||||
* Value of CPUID leaf 1 EAX register for this core
|
* Value of CPUID leaf 1 EAX register for this core
|
||||||
|
* 此核心的CPUID leaf 1 EAX寄存器值
|
||||||
*/
|
*/
|
||||||
val cpuid: UInt?,
|
val cpuid: UInt?,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM and ARM64 only
|
* ARM and ARM64 only
|
||||||
|
* 仅ARM和ARM64架构
|
||||||
*
|
*
|
||||||
* Value of Main ID Register (MIDR) for this core
|
* Value of Main ID Register (MIDR) for this core
|
||||||
|
* 此核心的主ID寄存器（MIDR）值
|
||||||
*/
|
*/
|
||||||
val midr: Midr?,
|
val midr: Midr?,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Clock rate (non-Turbo) of the core, in Hz
|
* Clock rate (non-Turbo) of the core, in Hz
|
||||||
|
* 核心的时钟频率（非睿频），单位赫兹（Hz）
|
||||||
*/
|
*/
|
||||||
val frequency: ULong,
|
val frequency: ULong,
|
||||||
) {
|
) {
|
||||||
|
|||||||
@ -9,7 +9,15 @@ import okio.FileSystem
|
|||||||
import okio.Path
|
import okio.Path
|
||||||
import okio.Path.Companion.toPath
|
import okio.Path.Companion.toPath
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Linux CPU information from sysfs
|
||||||
|
* 从sysfs获取的Linux CPU信息
|
||||||
|
*/
|
||||||
data class LinuxCpu(
|
data class LinuxCpu(
|
||||||
|
/**
|
||||||
|
* CPU ID (0-based)
|
||||||
|
* CPU编号（从0开始）
|
||||||
|
*/
|
||||||
val id: Int,
|
val id: Int,
|
||||||
) {
|
) {
|
||||||
private val cpuBaseDir = CPUINFO_BASE_DIR / "cpu${id}"
|
private val cpuBaseDir = CPUINFO_BASE_DIR / "cpu${id}"
|
||||||
@ -18,55 +26,78 @@ data class LinuxCpu(
|
|||||||
require(FILESYSTEM.exists(cpuBaseDir)) { "CPU $id doesn't exist" }
|
require(FILESYSTEM.exists(cpuBaseDir)) { "CPU $id doesn't exist" }
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Whether this CPU is online
|
||||||
|
* 此CPU是否在线
|
||||||
|
*/
|
||||||
val isOnline: Boolean?
|
val isOnline: Boolean?
|
||||||
get() = getIntArray(ONLINE_CPUS)?.contains(id)
|
get() = getIntArray(ONLINE_CPUS)?.contains(id)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Current frequency, in Hz.
|
* Current frequency, in Hz.
|
||||||
|
* 当前频率，单位赫兹（Hz）
|
||||||
*/
|
*/
|
||||||
val currentFrequencyHz: Long?
|
val currentFrequencyHz: Long?
|
||||||
get() = getLong(cpuBaseDir / CPUINFO_CURRENT_FREQ)?.let { it * 1000 }
|
get() = getLong(cpuBaseDir / CPUINFO_CURRENT_FREQ)?.let { it * 1000 }
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Minimum frequency, in Hz.
|
* Minimum frequency, in Hz.
|
||||||
|
* 最小频率，单位赫兹（Hz）
|
||||||
*/
|
*/
|
||||||
val minimumFrequencyHz: Long?
|
val minimumFrequencyHz: Long?
|
||||||
get() = getLong(cpuBaseDir / CPUINFO_MINIMUM_FREQ)?.let { it * 1000 }
|
get() = getLong(cpuBaseDir / CPUINFO_MINIMUM_FREQ)?.let { it * 1000 }
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Maximum frequency, in Hz.
|
* Maximum frequency, in Hz.
|
||||||
|
* 最大频率，单位赫兹（Hz）
|
||||||
*/
|
*/
|
||||||
val maximumFrequencyHz: Long?
|
val maximumFrequencyHz: Long?
|
||||||
get() = getLong(cpuBaseDir / CPUINFO_MAXIMUM_FREQ)?.let { it * 1000 }
|
get() = getLong(cpuBaseDir / CPUINFO_MAXIMUM_FREQ)?.let { it * 1000 }
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Current frequency, in Hz.
|
* Current frequency, in Hz.
|
||||||
|
* 当前频率（调频器），单位赫兹（Hz）
|
||||||
*/
|
*/
|
||||||
val scalingCurrentFrequencyHz: Long?
|
val scalingCurrentFrequencyHz: Long?
|
||||||
get() = getLong(cpuBaseDir / SCALING_CURRENT_FREQ)?.let { it * 1000 }
|
get() = getLong(cpuBaseDir / SCALING_CURRENT_FREQ)?.let { it * 1000 }
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Minimum frequency, in Hz.
|
* Minimum frequency, in Hz.
|
||||||
|
* 最小频率（调频器），单位赫兹（Hz）
|
||||||
*/
|
*/
|
||||||
val scalingMinimumFrequencyHz: Long?
|
val scalingMinimumFrequencyHz: Long?
|
||||||
get() = getLong(cpuBaseDir / SCALING_MINIMUM_FREQ)?.let { it * 1000 }
|
get() = getLong(cpuBaseDir / SCALING_MINIMUM_FREQ)?.let { it * 1000 }
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Maximum frequency, in Hz.
|
* Maximum frequency, in Hz.
|
||||||
|
* 最大频率（调频器），单位赫兹（Hz）
|
||||||
*/
|
*/
|
||||||
val scalingMaximumFrequencyHz: Long?
|
val scalingMaximumFrequencyHz: Long?
|
||||||
get() = getLong(cpuBaseDir / SCALING_MAXIMUM_FREQ)?.let { it * 1000 }
|
get() = getLong(cpuBaseDir / SCALING_MAXIMUM_FREQ)?.let { it * 1000 }
|
||||||
|
|
||||||
// File utils
|
// File utils
|
||||||
|
// 文件工具方法
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Read a string from a sysfs file
|
||||||
|
* 从sysfs文件读取字符串
|
||||||
|
*/
|
||||||
private fun getString(path: Path) = runCatching {
|
private fun getString(path: Path) = runCatching {
|
||||||
FILESYSTEM.read(path) {
|
FILESYSTEM.read(path) {
|
||||||
readUtf8Line()
|
readUtf8Line()
|
||||||
}
|
}
|
||||||
}.getOrNull()
|
}.getOrNull()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Read a long value from a sysfs file
|
||||||
|
* 从sysfs文件读取长整型值
|
||||||
|
*/
|
||||||
private fun getLong(path: Path) = getString(path)?.toLongOrNull()
|
private fun getLong(path: Path) = getString(path)?.toLongOrNull()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Parse CPU list from sysfs (e.g., "0-3,5,7-9" -> [0,1,2,3,5,7,8,9])
|
||||||
|
* 从sysfs解析CPU列表（例如，"0-3,5,7-9" -> [0,1,2,3,5,7,8,9]）
|
||||||
|
*/
|
||||||
private fun getIntArray(path: Path) = getString(path)?.let {
|
private fun getIntArray(path: Path) = getString(path)?.let {
|
||||||
mutableListOf<Int>().apply {
|
mutableListOf<Int>().apply {
|
||||||
for (item in it.split(",")) {
|
for (item in it.split(",")) {
|
||||||
@ -85,6 +116,10 @@ data class LinuxCpu(
|
|||||||
}
|
}
|
||||||
|
|
||||||
companion object {
|
companion object {
|
||||||
|
/**
|
||||||
|
* Base directory for CPU information in sysfs
|
||||||
|
* sysfs中CPU信息的基础目录
|
||||||
|
*/
|
||||||
val CPUINFO_BASE_DIR = "/sys/devices/system/cpu".toPath()
|
val CPUINFO_BASE_DIR = "/sys/devices/system/cpu".toPath()
|
||||||
|
|
||||||
private val FILESYSTEM = FileSystem.SYSTEM
|
private val FILESYSTEM = FileSystem.SYSTEM
|
||||||
@ -99,6 +134,10 @@ data class LinuxCpu(
|
|||||||
private const val SCALING_MINIMUM_FREQ = "cpufreq/scaling_min_freq"
|
private const val SCALING_MINIMUM_FREQ = "cpufreq/scaling_min_freq"
|
||||||
private const val SCALING_MAXIMUM_FREQ = "cpufreq/scaling_max_freq"
|
private const val SCALING_MAXIMUM_FREQ = "cpufreq/scaling_max_freq"
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Create LinuxCpu from Processor
|
||||||
|
* 从Processor创建LinuxCpu
|
||||||
|
*/
|
||||||
fun fromProcessor(processor: Processor) = LinuxCpu(processor.linuxId.toInt())
|
fun fromProcessor(processor: Processor) = LinuxCpu(processor.linuxId.toInt())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@ -7,33 +7,117 @@ package com.xyzshell.andinfo.libs.cpu.models
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM and ARM64 only
|
* ARM and ARM64 only
|
||||||
|
* 仅ARM和ARM64架构
|
||||||
*
|
*
|
||||||
* B4.1.105 MIDR, Main ID Register, VMSA
|
* B4.1.105 MIDR, Main ID Register, VMSA
|
||||||
|
* 主ID寄存器（MIDR），用于识别ARM处理器
|
||||||
*/
|
*/
|
||||||
data class Midr(
|
data class Midr(
|
||||||
|
/**
|
||||||
|
* ARM processor implementer
|
||||||
|
* ARM处理器实现者/制造商
|
||||||
|
*/
|
||||||
val implementer: Implementer,
|
val implementer: Implementer,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Variant number
|
||||||
|
* 变体号
|
||||||
|
*/
|
||||||
val variant: UByte,
|
val variant: UByte,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Architecture version
|
||||||
|
* 架构版本
|
||||||
|
*/
|
||||||
val architecture: Architecture,
|
val architecture: Architecture,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Primary part number
|
||||||
|
* 主要部件编号
|
||||||
|
*/
|
||||||
val primaryPartNumber: UInt,
|
val primaryPartNumber: UInt,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Revision number
|
||||||
|
* 修订号
|
||||||
|
*/
|
||||||
val revision: UByte,
|
val revision: UByte,
|
||||||
) {
|
) {
|
||||||
|
/**
|
||||||
|
* ARM processor implementer codes
|
||||||
|
* ARM处理器实现者代码
|
||||||
|
*/
|
||||||
enum class Implementer(val value: UByte) {
|
enum class Implementer(val value: UByte) {
|
||||||
|
/**
|
||||||
|
* Unknown implementer
|
||||||
|
* 未知实现者
|
||||||
|
*/
|
||||||
UNKNOWN(0x00U),
|
UNKNOWN(0x00U),
|
||||||
|
|
||||||
// From ARM spec
|
// From ARM spec
|
||||||
|
// 来自ARM规范
|
||||||
|
/**
|
||||||
|
* ARM Holdings
|
||||||
|
* ARM控股公司
|
||||||
|
*/
|
||||||
ARM(0x41U),
|
ARM(0x41U),
|
||||||
|
/**
|
||||||
|
* Digital Equipment Corporation
|
||||||
|
* 迪吉多公司
|
||||||
|
*/
|
||||||
DEC(0x44U),
|
DEC(0x44U),
|
||||||
|
/**
|
||||||
|
* Motorola/Freescale
|
||||||
|
* 摩托罗拉/飞思卡尔
|
||||||
|
*/
|
||||||
MOTOROLA(0x4DU),
|
MOTOROLA(0x4DU),
|
||||||
|
/**
|
||||||
|
* Qualcomm
|
||||||
|
* 高通
|
||||||
|
*/
|
||||||
QUALCOMM(0x51U),
|
QUALCOMM(0x51U),
|
||||||
|
/**
|
||||||
|
* Marvell
|
||||||
|
* 美满电子
|
||||||
|
*/
|
||||||
MARVELL(0x56U),
|
MARVELL(0x56U),
|
||||||
|
/**
|
||||||
|
* Intel
|
||||||
|
* 英特尔
|
||||||
|
*/
|
||||||
INTEL(0x69U),
|
INTEL(0x69U),
|
||||||
|
|
||||||
// Implementers not declared in the spec, taken from cpuinfo's arm/uarch.c
|
// Implementers not declared in the spec, taken from cpuinfo's arm/uarch.c
|
||||||
|
// 规范中未声明的实现者，取自cpuinfo的arm/uarch.c
|
||||||
|
/**
|
||||||
|
* Broadcom
|
||||||
|
* 博通
|
||||||
|
*/
|
||||||
BROADCOM(0x42U),
|
BROADCOM(0x42U),
|
||||||
|
/**
|
||||||
|
* Cavium
|
||||||
|
* Cavium公司
|
||||||
|
*/
|
||||||
CAVIUM(0x43U),
|
CAVIUM(0x43U),
|
||||||
|
/**
|
||||||
|
* Huawei (HiSilicon)
|
||||||
|
* 华为（海思）
|
||||||
|
*/
|
||||||
HUAWEI(0x48U),
|
HUAWEI(0x48U),
|
||||||
|
/**
|
||||||
|
* Nvidia
|
||||||
|
* 英伟达
|
||||||
|
*/
|
||||||
NVIDIA(0x4EU),
|
NVIDIA(0x4EU),
|
||||||
|
/**
|
||||||
|
* Applied Micro
|
||||||
|
* 应用微电路
|
||||||
|
*/
|
||||||
APM(0x50U),
|
APM(0x50U),
|
||||||
|
/**
|
||||||
|
* Samsung
|
||||||
|
* 三星
|
||||||
|
*/
|
||||||
SAMSUNG(0x53U);
|
SAMSUNG(0x53U);
|
||||||
|
|
||||||
companion object {
|
companion object {
|
||||||
@ -41,6 +125,10 @@ data class Midr(
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* ARM architecture versions
|
||||||
|
* ARM架构版本
|
||||||
|
*/
|
||||||
enum class Architecture(val value: UByte) {
|
enum class Architecture(val value: UByte) {
|
||||||
ARMV4(0x1U),
|
ARMV4(0x1U),
|
||||||
ARMV4T(0x2U),
|
ARMV4T(0x2U),
|
||||||
@ -49,6 +137,10 @@ data class Midr(
|
|||||||
ARMV5TE(0x5U),
|
ARMV5TE(0x5U),
|
||||||
ARMV5TEJ(0x6U),
|
ARMV5TEJ(0x6U),
|
||||||
ARMV6(0x7U),
|
ARMV6(0x7U),
|
||||||
|
/**
|
||||||
|
* Defined by CPUID register
|
||||||
|
* 由CPUID寄存器定义
|
||||||
|
*/
|
||||||
DEFINED_BY_CPUID(0xFU);
|
DEFINED_BY_CPUID(0xFU);
|
||||||
|
|
||||||
companion object {
|
companion object {
|
||||||
@ -57,6 +149,10 @@ data class Midr(
|
|||||||
}
|
}
|
||||||
|
|
||||||
companion object {
|
companion object {
|
||||||
|
/**
|
||||||
|
* Parse MIDR value from cpuinfo
|
||||||
|
* 从cpuinfo解析MIDR值
|
||||||
|
*/
|
||||||
fun fromCpuInfo(value: Int) = Midr(
|
fun fromCpuInfo(value: Int) = Midr(
|
||||||
Implementer.fromValue(value.shr(24).and(0xFF).toUByte()),
|
Implementer.fromValue(value.shr(24).and(0xFF).toUByte()),
|
||||||
value.shr(20).and(0xF).toUByte(),
|
value.shr(20).and(0xF).toUByte(),
|
||||||
|
|||||||
@ -5,39 +5,49 @@
|
|||||||
|
|
||||||
package com.xyzshell.andinfo.libs.cpu.models
|
package com.xyzshell.andinfo.libs.cpu.models
|
||||||
|
|
||||||
|
/**
|
||||||
|
* CPU物理封装信息
|
||||||
|
*/
|
||||||
data class Package(
|
data class Package(
|
||||||
/**
|
/**
|
||||||
* SoC or processor chip model name
|
* SoC or processor chip model name
|
||||||
|
* SoC或处理器芯片型号名称
|
||||||
*/
|
*/
|
||||||
val name: String,
|
val name: String,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Index of the first logical processor on this physical package
|
* Index of the first logical processor on this physical package
|
||||||
|
* 此物理封装上第一个逻辑处理器的索引
|
||||||
*/
|
*/
|
||||||
val processorStart: UInt,
|
val processorStart: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Number of logical processors on this physical package
|
* Number of logical processors on this physical package
|
||||||
|
* 此物理封装上的逻辑处理器数量
|
||||||
*/
|
*/
|
||||||
val processorCount: UInt,
|
val processorCount: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Index of the first core on this physical package
|
* Index of the first core on this physical package
|
||||||
|
* 此物理封装上第一个核心的索引
|
||||||
*/
|
*/
|
||||||
val coreStart: UInt,
|
val coreStart: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Number of cores on this physical package
|
* Number of cores on this physical package
|
||||||
|
* 此物理封装上的核心数量
|
||||||
*/
|
*/
|
||||||
val coreCount: UInt,
|
val coreCount: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Index of the first cluster of cores on this physical package
|
* Index of the first cluster of cores on this physical package
|
||||||
|
* 此物理封装上第一个核心集群的索引
|
||||||
*/
|
*/
|
||||||
val clusterStart: UInt,
|
val clusterStart: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Number of clusters of cores on this physical package
|
* Number of clusters of cores on this physical package
|
||||||
|
* 此物理封装上的核心集群数量
|
||||||
*/
|
*/
|
||||||
val clusterCount: UInt,
|
val clusterCount: UInt,
|
||||||
) {
|
) {
|
||||||
|
|||||||
@ -13,45 +13,56 @@ import com.xyzshell.andinfo.libs.cpu.models.ProcessorCache
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* `struct cpuinfo_processor`
|
* `struct cpuinfo_processor`
|
||||||
|
* 逻辑处理器信息结构体
|
||||||
*/
|
*/
|
||||||
data class Processor(
|
data class Processor(
|
||||||
/**
|
/**
|
||||||
* SMT (hyperthread) ID within a core
|
* SMT (hyperthread) ID within a core
|
||||||
|
* 核心内的SMT（超线程）ID
|
||||||
*/
|
*/
|
||||||
val smtId: UInt,
|
val smtId: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Core containing this logical processor
|
* Core containing this logical processor
|
||||||
|
* 包含此逻辑处理器的核心
|
||||||
*/
|
*/
|
||||||
val core: Core,
|
val core: Core,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Cluster of cores containing this logical processor
|
* Cluster of cores containing this logical processor
|
||||||
|
* 包含此逻辑处理器的核心集群
|
||||||
*/
|
*/
|
||||||
val cluster: Cluster,
|
val cluster: Cluster,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Physical package containing this logical processor
|
* Physical package containing this logical processor
|
||||||
|
* 包含此逻辑处理器的物理封装
|
||||||
*/
|
*/
|
||||||
val cpuPackage: Package,
|
val cpuPackage: Package,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Linux-specific ID for the logical processor:
|
* Linux-specific ID for the logical processor:
|
||||||
|
* Linux特定的逻辑处理器ID：
|
||||||
* - Linux kernel exposes information about this logical processor in
|
* - Linux kernel exposes information about this logical processor in
|
||||||
|
* - Linux内核在以下路径公开此逻辑处理器的信息
|
||||||
* /sys/devices/system/cpu/cpu<linux_id>/
|
* /sys/devices/system/cpu/cpu<linux_id>/
|
||||||
* - Bit <linux_id> in the cpu_set_t identifies this logical processor
|
* - Bit <linux_id> in the cpu_set_t identifies this logical processor
|
||||||
|
* - cpu_set_t中的位<linux_id>标识此逻辑处理器
|
||||||
*/
|
*/
|
||||||
val linuxId: UInt,
|
val linuxId: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* x86 only
|
* x86 only
|
||||||
|
* 仅x86架构
|
||||||
*
|
*
|
||||||
* APIC ID (unique x86-specific ID of the logical processor)
|
* APIC ID (unique x86-specific ID of the logical processor)
|
||||||
|
* APIC ID（逻辑处理器的唯一x86特定ID）
|
||||||
*/
|
*/
|
||||||
val apicId: UInt?,
|
val apicId: UInt?,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @see ProcessorCache
|
* @see ProcessorCache
|
||||||
|
* 处理器缓存信息
|
||||||
*/
|
*/
|
||||||
val cache: ProcessorCache,
|
val cache: ProcessorCache,
|
||||||
) {
|
) {
|
||||||
|
|||||||
@ -9,26 +9,32 @@ import com.xyzshell.andinfo.libs.cpu.models.Cache
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* `struct cpuinfo_processor { struct {...} cache }`
|
* `struct cpuinfo_processor { struct {...} cache }`
|
||||||
|
* 处理器缓存层次结构
|
||||||
*/
|
*/
|
||||||
data class ProcessorCache(
|
data class ProcessorCache(
|
||||||
/**
|
/**
|
||||||
* Level 1 instruction cache
|
* Level 1 instruction cache
|
||||||
|
* 一级指令缓存
|
||||||
*/
|
*/
|
||||||
val l1i: Cache?,
|
val l1i: Cache?,
|
||||||
/**
|
/**
|
||||||
* Level 1 data cache
|
* Level 1 data cache
|
||||||
|
* 一级数据缓存
|
||||||
*/
|
*/
|
||||||
val l1d: Cache?,
|
val l1d: Cache?,
|
||||||
/**
|
/**
|
||||||
* Level 2 unified or data cache
|
* Level 2 unified or data cache
|
||||||
|
* 二级统一缓存或数据缓存
|
||||||
*/
|
*/
|
||||||
val l2: Cache?,
|
val l2: Cache?,
|
||||||
/**
|
/**
|
||||||
* Level 3 unified or data cache
|
* Level 3 unified or data cache
|
||||||
|
* 三级统一缓存或数据缓存
|
||||||
*/
|
*/
|
||||||
val l3: Cache?,
|
val l3: Cache?,
|
||||||
/**
|
/**
|
||||||
* Level 4 unified or data cache
|
* Level 4 unified or data cache
|
||||||
|
* 四级统一缓存或数据缓存
|
||||||
*/
|
*/
|
||||||
val l4: Cache?,
|
val l4: Cache?,
|
||||||
) {
|
) {
|
||||||
|
|||||||
@ -7,10 +7,25 @@ package com.xyzshell.andinfo.libs.cpu.models
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* `struct cpuinfo_tlb`
|
* `struct cpuinfo_tlb`
|
||||||
|
* TLB（Translation Lookaside Buffer）转换后备缓冲区结构体
|
||||||
*/
|
*/
|
||||||
data class Tlb(
|
data class Tlb(
|
||||||
|
/**
|
||||||
|
* TLB entries count
|
||||||
|
* TLB条目数量
|
||||||
|
*/
|
||||||
val entries: UInt,
|
val entries: UInt,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Associativity of the TLB
|
||||||
|
* TLB的关联度
|
||||||
|
*/
|
||||||
val associativity: UInt,
|
val associativity: UInt,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Number of pages
|
||||||
|
* 页面数量
|
||||||
|
*/
|
||||||
val pages: ULong,
|
val pages: ULong,
|
||||||
) {
|
) {
|
||||||
companion object {
|
companion object {
|
||||||
|
|||||||
@ -7,9 +7,19 @@ package com.xyzshell.andinfo.libs.cpu.models
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* `struct cpuinfo_trace_cache`
|
* `struct cpuinfo_trace_cache`
|
||||||
|
* 跟踪缓存结构体（用于存储已解码的微操作）
|
||||||
*/
|
*/
|
||||||
data class TraceCache(
|
data class TraceCache(
|
||||||
|
/**
|
||||||
|
* Number of micro-operations
|
||||||
|
* 微操作数量
|
||||||
|
*/
|
||||||
val uops: UInt,
|
val uops: UInt,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Associativity of the trace cache
|
||||||
|
* 跟踪缓存的关联度
|
||||||
|
*/
|
||||||
val associativity: UInt,
|
val associativity: UInt,
|
||||||
) {
|
) {
|
||||||
companion object {
|
companion object {
|
||||||
|
|||||||
@ -7,12 +7,15 @@ package com.xyzshell.andinfo.libs.cpu.models
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* `enum cpuinfo_uarch`
|
* `enum cpuinfo_uarch`
|
||||||
|
* CPU微架构枚举
|
||||||
*
|
*
|
||||||
* Processor microarchitecture
|
* Processor microarchitecture
|
||||||
|
* 处理器微架构
|
||||||
*
|
*
|
||||||
* Processors with different microarchitectures often have different instruction
|
* Processors with different microarchitectures often have different instruction
|
||||||
* performance characteristics, and may have dramatically different pipeline
|
* performance characteristics, and may have dramatically different pipeline
|
||||||
* organization.
|
* organization.
|
||||||
|
* 不同微架构的处理器通常具有不同的指令性能特征，并且可能具有截然不同的流水线组织结构
|
||||||
*/
|
*/
|
||||||
enum class Uarch(
|
enum class Uarch(
|
||||||
val value: UInt,
|
val value: UInt,
|
||||||
@ -20,189 +23,227 @@ enum class Uarch(
|
|||||||
/**
|
/**
|
||||||
* Microarchitecture is unknown, or the library failed to get
|
* Microarchitecture is unknown, or the library failed to get
|
||||||
* information about the microarchitecture from OS
|
* information about the microarchitecture from OS
|
||||||
|
* 微架构未知，或库无法从操作系统获取微架构信息
|
||||||
*/
|
*/
|
||||||
UNKNOWN(0U),
|
UNKNOWN(0U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Pentium and Pentium MMX microarchitecture.
|
* Pentium and Pentium MMX microarchitecture.
|
||||||
|
* 奔腾和奔腾MMX微架构
|
||||||
*/
|
*/
|
||||||
P5(0x00100100U),
|
P5(0x00100100U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Quark microarchitecture.
|
* Intel Quark microarchitecture.
|
||||||
|
* 英特尔夸克微架构
|
||||||
*/
|
*/
|
||||||
QUARK(0x00100101U),
|
QUARK(0x00100101U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Pentium Pro, Pentium II, and Pentium III.
|
* Pentium Pro, Pentium II, and Pentium III.
|
||||||
|
* 奔腾Pro、奔腾II和奔腾III
|
||||||
*/
|
*/
|
||||||
P6(0x00100200U),
|
P6(0x00100200U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Pentium M.
|
* Pentium M.
|
||||||
|
* 奔腾M
|
||||||
*/
|
*/
|
||||||
DOTHAN(0x00100201U),
|
DOTHAN(0x00100201U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Core microarchitecture.
|
* Intel Core microarchitecture.
|
||||||
|
* 英特尔酷睿微架构
|
||||||
*/
|
*/
|
||||||
YONAH(0x00100202U),
|
YONAH(0x00100202U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Core 2 microarchitecture on 65 nm process.
|
* Intel Core 2 microarchitecture on 65 nm process.
|
||||||
|
* 英特尔酷睿2微架构（65纳米工艺）
|
||||||
*/
|
*/
|
||||||
CONROE(0x00100203U),
|
CONROE(0x00100203U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Core 2 microarchitecture on 45 nm process.
|
* Intel Core 2 microarchitecture on 45 nm process.
|
||||||
|
* 英特尔酷睿2微架构（45纳米工艺）
|
||||||
*/
|
*/
|
||||||
PENRYN(0x00100204U),
|
PENRYN(0x00100204U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Nehalem and Westmere microarchitectures (Core i3/i5/i7 1st
|
* Intel Nehalem and Westmere microarchitectures (Core i3/i5/i7 1st
|
||||||
* gen).
|
* gen).
|
||||||
|
* 英特尔Nehalem和Westmere微架构（酷睿i3/i5/i7第1代）
|
||||||
*/
|
*/
|
||||||
NEHALEM(0x00100205U),
|
NEHALEM(0x00100205U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Sandy Bridge microarchitecture (Core i3/i5/i7 2nd gen).
|
* Intel Sandy Bridge microarchitecture (Core i3/i5/i7 2nd gen).
|
||||||
|
* 英特尔Sandy Bridge微架构（酷睿i3/i5/i7第2代）
|
||||||
*/
|
*/
|
||||||
SANDY_BRIDGE(0x00100206U),
|
SANDY_BRIDGE(0x00100206U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Ivy Bridge microarchitecture (Core i3/i5/i7 3rd gen).
|
* Intel Ivy Bridge microarchitecture (Core i3/i5/i7 3rd gen).
|
||||||
|
* 英特尔Ivy Bridge微架构（酷睿i3/i5/i7第3代）
|
||||||
*/
|
*/
|
||||||
IVY_BRIDGE(0x00100207U),
|
IVY_BRIDGE(0x00100207U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Haswell microarchitecture (Core i3/i5/i7 4th gen).
|
* Intel Haswell microarchitecture (Core i3/i5/i7 4th gen).
|
||||||
|
* 英特尔Haswell微架构（酷睿i3/i5/i7第4代）
|
||||||
*/
|
*/
|
||||||
HASWELL(0x00100208U),
|
HASWELL(0x00100208U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Broadwell microarchitecture.
|
* Intel Broadwell microarchitecture.
|
||||||
|
* 英特尔Broadwell微架构（第5代）
|
||||||
*/
|
*/
|
||||||
BROADWELL(0x00100209U),
|
BROADWELL(0x00100209U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Sky Lake microarchitecture (14 nm, including
|
* Intel Sky Lake microarchitecture (14 nm, including
|
||||||
* Kaby/Coffee/Whiskey/Amber/Comet/Cascade/Cooper Lake).
|
* Kaby/Coffee/Whiskey/Amber/Comet/Cascade/Cooper Lake).
|
||||||
|
* 英特尔Sky Lake微架构（14纳米，包括Kaby/Coffee/Whiskey/Amber/Comet/Cascade/Cooper Lake）
|
||||||
*/
|
*/
|
||||||
SKY_LAKE(0x0010020AU),
|
SKY_LAKE(0x0010020AU),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* DEPRECATED (Intel Kaby Lake microarchitecture).
|
* DEPRECATED (Intel Kaby Lake microarchitecture).
|
||||||
|
* 已弃用（英特尔Kaby Lake微架构）
|
||||||
*/
|
*/
|
||||||
//KABY_LAKE(0x0010020AU),
|
//KABY_LAKE(0x0010020AU),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Palm Cove microarchitecture (10 nm, Cannon Lake).
|
* Intel Palm Cove microarchitecture (10 nm, Cannon Lake).
|
||||||
|
* 英特尔Palm Cove微架构（10纳米，Cannon Lake）
|
||||||
*/
|
*/
|
||||||
PALM_COVE(0x0010020BU),
|
PALM_COVE(0x0010020BU),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Sunny Cove microarchitecture (10 nm, Ice Lake).
|
* Intel Sunny Cove microarchitecture (10 nm, Ice Lake).
|
||||||
|
* 英特尔Sunny Cove微架构（10纳米，Ice Lake）
|
||||||
*/
|
*/
|
||||||
SUNNY_COVE(0x0010020CU),
|
SUNNY_COVE(0x0010020CU),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Pentium 4 with Willamette, Northwood, or Foster cores.
|
* Pentium 4 with Willamette, Northwood, or Foster cores.
|
||||||
|
* 奔腾4（Willamette、Northwood或Foster核心）
|
||||||
*/
|
*/
|
||||||
WILLAMETTE(0x00100300U),
|
WILLAMETTE(0x00100300U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Pentium 4 with Prescott and later cores.
|
* Pentium 4 with Prescott and later cores.
|
||||||
|
* 奔腾4（Prescott及更高版本核心）
|
||||||
*/
|
*/
|
||||||
PRESCOTT(0x00100301U),
|
PRESCOTT(0x00100301U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Atom on 45 nm process.
|
* Intel Atom on 45 nm process.
|
||||||
|
* 英特尔凌动（45纳米工艺）
|
||||||
*/
|
*/
|
||||||
BONNELL(0x00100400U),
|
BONNELL(0x00100400U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Atom on 32 nm process.
|
* Intel Atom on 32 nm process.
|
||||||
|
* 英特尔凌动（32纳米工艺）
|
||||||
*/
|
*/
|
||||||
SALTWELL(0x00100401U),
|
SALTWELL(0x00100401U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Silvermont microarchitecture (22 nm out-of-order Atom).
|
* Intel Silvermont microarchitecture (22 nm out-of-order Atom).
|
||||||
|
* 英特尔Silvermont微架构（22纳米乱序执行凌动）
|
||||||
*/
|
*/
|
||||||
SILVERMOUNT(0x00100402U),
|
SILVERMOUNT(0x00100402U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Airmont microarchitecture (14 nm out-of-order Atom).
|
* Intel Airmont microarchitecture (14 nm out-of-order Atom).
|
||||||
|
* 英特尔Airmont微架构（14纳米乱序执行凌动）
|
||||||
*/
|
*/
|
||||||
AIRMONT(0x00100403U),
|
AIRMONT(0x00100403U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Goldmont microarchitecture (Denverton, Apollo Lake).
|
* Intel Goldmont microarchitecture (Denverton, Apollo Lake).
|
||||||
|
* 英特尔Goldmont微架构（Denverton、Apollo Lake）
|
||||||
*/
|
*/
|
||||||
GOLDMONT(0x00100404U),
|
GOLDMONT(0x00100404U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Goldmont Plus microarchitecture (Gemini Lake).
|
* Intel Goldmont Plus microarchitecture (Gemini Lake).
|
||||||
|
* 英特尔Goldmont Plus微架构（Gemini Lake）
|
||||||
*/
|
*/
|
||||||
GOLDMONT_PLUS(0x00100405U),
|
GOLDMONT_PLUS(0x00100405U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Knights Ferry HPC boards.
|
* Intel Knights Ferry HPC boards.
|
||||||
|
* 英特尔Knights Ferry高性能计算板
|
||||||
*/
|
*/
|
||||||
KNIGHTS_FERRY(0x00100500U),
|
KNIGHTS_FERRY(0x00100500U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Knights Corner HPC boards (aka Xeon Phi).
|
* Intel Knights Corner HPC boards (aka Xeon Phi).
|
||||||
|
* 英特尔Knights Corner高性能计算板（即至强融核）
|
||||||
*/
|
*/
|
||||||
KNIGHTS_CORNER(0x00100501U),
|
KNIGHTS_CORNER(0x00100501U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Knights Landing microarchitecture (second-gen MIC).
|
* Intel Knights Landing microarchitecture (second-gen MIC).
|
||||||
|
* 英特尔Knights Landing微架构（第二代MIC）
|
||||||
*/
|
*/
|
||||||
KNIGHTS_LANDING(0x00100502U),
|
KNIGHTS_LANDING(0x00100502U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Knights Hill microarchitecture (third-gen MIC).
|
* Intel Knights Hill microarchitecture (third-gen MIC).
|
||||||
|
* 英特尔Knights Hill微架构（第三代MIC）
|
||||||
*/
|
*/
|
||||||
KNIGHTS_HILL(0x00100503U),
|
KNIGHTS_HILL(0x00100503U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Knights Mill Xeon Phi.
|
* Intel Knights Mill Xeon Phi.
|
||||||
|
* 英特尔Knights Mill至强融核
|
||||||
*/
|
*/
|
||||||
KNIGHTS_MILL(0x00100504U),
|
KNIGHTS_MILL(0x00100504U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel/Marvell XScale series.
|
* Intel/Marvell XScale series.
|
||||||
|
* 英特尔/美满XScale系列
|
||||||
*/
|
*/
|
||||||
XSCALE(0x00100600U),
|
XSCALE(0x00100600U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD K5.
|
* AMD K5.
|
||||||
|
* AMD K5微架构
|
||||||
*/
|
*/
|
||||||
K5(0x00200100U),
|
K5(0x00200100U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD K6 and alike.
|
* AMD K6 and alike.
|
||||||
|
* AMD K6及类似微架构
|
||||||
*/
|
*/
|
||||||
K6(0x00200101U),
|
K6(0x00200101U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD Athlon and Duron.
|
* AMD Athlon and Duron.
|
||||||
|
* AMD速龙和毒龙
|
||||||
*/
|
*/
|
||||||
K7(0x00200102U),
|
K7(0x00200102U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD Athlon 64, Opteron 64.
|
* AMD Athlon 64, Opteron 64.
|
||||||
|
* AMD速龙64、皓龙64
|
||||||
*/
|
*/
|
||||||
K8(0x00200103U),
|
K8(0x00200103U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD Family 10h (Barcelona, Istambul, Magny-Cours).
|
* AMD Family 10h (Barcelona, Istambul, Magny-Cours).
|
||||||
|
* AMD Family 10h（Barcelona、Istambul、Magny-Cours）
|
||||||
*/
|
*/
|
||||||
K10(0x00200104U),
|
K10(0x00200104U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD Bulldozer microarchitecture
|
* AMD Bulldozer microarchitecture
|
||||||
* Zambezi FX-series CPUs, Zurich, Valencia and Interlagos Opteron CPUs.
|
* Zambezi FX-series CPUs, Zurich, Valencia and Interlagos Opteron CPUs.
|
||||||
|
* AMD推土机微架构
|
||||||
|
* Zambezi FX系列CPU、Zurich、Valencia和Interlagos皓龙CPU
|
||||||
*/
|
*/
|
||||||
BULLDOZER(0x00200105U),
|
BULLDOZER(0x00200105U),
|
||||||
|
|
||||||
@ -210,317 +251,381 @@ enum class Uarch(
|
|||||||
* AMD Piledriver microarchitecture
|
* AMD Piledriver microarchitecture
|
||||||
* Vishera FX-series CPUs, Trinity and Richland APUs, Delhi, Seoul, Abu
|
* Vishera FX-series CPUs, Trinity and Richland APUs, Delhi, Seoul, Abu
|
||||||
* Dhabi Opteron CPUs.
|
* Dhabi Opteron CPUs.
|
||||||
|
* AMD打桩机微架构
|
||||||
|
* Vishera FX系列CPU、Trinity和Richland APU、Delhi、Seoul、Abu Dhabi皓龙CPU
|
||||||
*/
|
*/
|
||||||
PILEDRIVER(0x00200106U),
|
PILEDRIVER(0x00200106U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD Steamroller microarchitecture (Kaveri APUs).
|
* AMD Steamroller microarchitecture (Kaveri APUs).
|
||||||
|
* AMD压路机微架构（Kaveri APU）
|
||||||
*/
|
*/
|
||||||
STEAMROLLER(0x00200107U),
|
STEAMROLLER(0x00200107U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD Excavator microarchitecture (Carizzo APUs).
|
* AMD Excavator microarchitecture (Carizzo APUs).
|
||||||
|
* AMD挖掘机微架构（Carizzo APU）
|
||||||
*/
|
*/
|
||||||
EXCAVATOR(0x00200108U),
|
EXCAVATOR(0x00200108U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD Zen microarchitecture (12/14 nm Ryzen and EPYC CPUs).
|
* AMD Zen microarchitecture (12/14 nm Ryzen and EPYC CPUs).
|
||||||
|
* AMD Zen微架构（12/14纳米锐龙和霄龙CPU）
|
||||||
*/
|
*/
|
||||||
ZEN(0x00200109U),
|
ZEN(0x00200109U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD Zen 2 microarchitecture (7 nm Ryzen and EPYC CPUs).
|
* AMD Zen 2 microarchitecture (7 nm Ryzen and EPYC CPUs).
|
||||||
|
* AMD Zen 2微架构（7纳米锐龙和霄龙CPU）
|
||||||
*/
|
*/
|
||||||
ZEN2(0x0020010AU),
|
ZEN2(0x0020010AU),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD Zen 3 microarchitecture.
|
* AMD Zen 3 microarchitecture.
|
||||||
|
* AMD Zen 3微架构
|
||||||
*/
|
*/
|
||||||
ZEN3(0x0020010BU),
|
ZEN3(0x0020010BU),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD Zen 4 microarchitecture.
|
* AMD Zen 4 microarchitecture.
|
||||||
|
* AMD Zen 4微架构
|
||||||
*/
|
*/
|
||||||
ZEN4(0x0020010CU),
|
ZEN4(0x0020010CU),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* NSC Geode and AMD Geode GX and LX.
|
* NSC Geode and AMD Geode GX and LX.
|
||||||
|
* NSC Geode和AMD Geode GX和LX
|
||||||
*/
|
*/
|
||||||
GEODE(0x00200200U),
|
GEODE(0x00200200U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD Bobcat mobile microarchitecture.
|
* AMD Bobcat mobile microarchitecture.
|
||||||
|
* AMD山猫移动微架构
|
||||||
*/
|
*/
|
||||||
BOBCAT(0x00200201U),
|
BOBCAT(0x00200201U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD Jaguar mobile microarchitecture.
|
* AMD Jaguar mobile microarchitecture.
|
||||||
|
* AMD美洲豹移动微架构
|
||||||
*/
|
*/
|
||||||
JAGUAR(0x00200202U),
|
JAGUAR(0x00200202U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* AMD Puma mobile microarchitecture.
|
* AMD Puma mobile microarchitecture.
|
||||||
|
* AMD美洲狮移动微架构
|
||||||
*/
|
*/
|
||||||
PUMA(0x00200203U),
|
PUMA(0x00200203U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM7 series.
|
* ARM7 series.
|
||||||
|
* ARM7系列
|
||||||
*/
|
*/
|
||||||
ARM7(0x00300100U),
|
ARM7(0x00300100U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM9 series.
|
* ARM9 series.
|
||||||
|
* ARM9系列
|
||||||
*/
|
*/
|
||||||
ARM9(0x00300101U),
|
ARM9(0x00300101U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM 1136, ARM 1156, ARM 1176, or ARM 11MPCore.
|
* ARM 1136, ARM 1156, ARM 1176, or ARM 11MPCore.
|
||||||
|
* ARM 1136、ARM 1156、ARM 1176或ARM 11MPCore
|
||||||
*/
|
*/
|
||||||
ARM11(0x00300102U),
|
ARM11(0x00300102U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A5.
|
* ARM Cortex-A5.
|
||||||
|
* ARM Cortex-A5
|
||||||
*/
|
*/
|
||||||
CORTEX_A5(0x00300205U),
|
CORTEX_A5(0x00300205U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A7.
|
* ARM Cortex-A7.
|
||||||
|
* ARM Cortex-A7
|
||||||
*/
|
*/
|
||||||
CORTEX_A7(0x00300207U),
|
CORTEX_A7(0x00300207U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A8.
|
* ARM Cortex-A8.
|
||||||
|
* ARM Cortex-A8
|
||||||
*/
|
*/
|
||||||
CORTEX_A8(0x00300208U),
|
CORTEX_A8(0x00300208U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A9.
|
* ARM Cortex-A9.
|
||||||
|
* ARM Cortex-A9
|
||||||
*/
|
*/
|
||||||
CORTEX_A9(0x00300209U),
|
CORTEX_A9(0x00300209U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A12.
|
* ARM Cortex-A12.
|
||||||
|
* ARM Cortex-A12
|
||||||
*/
|
*/
|
||||||
CORTEX_A12(0x00300212U),
|
CORTEX_A12(0x00300212U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A15.
|
* ARM Cortex-A15.
|
||||||
|
* ARM Cortex-A15
|
||||||
*/
|
*/
|
||||||
CORTEX_A15(0x00300215U),
|
CORTEX_A15(0x00300215U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A17.
|
* ARM Cortex-A17.
|
||||||
|
* ARM Cortex-A17
|
||||||
*/
|
*/
|
||||||
CORTEX_A17(0x00300217U),
|
CORTEX_A17(0x00300217U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A32.
|
* ARM Cortex-A32.
|
||||||
|
* ARM Cortex-A32
|
||||||
*/
|
*/
|
||||||
CORTEX_A32(0x00300332U),
|
CORTEX_A32(0x00300332U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A35.
|
* ARM Cortex-A35.
|
||||||
|
* ARM Cortex-A35
|
||||||
*/
|
*/
|
||||||
CORTEX_A35(0x00300335U),
|
CORTEX_A35(0x00300335U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A53.
|
* ARM Cortex-A53.
|
||||||
|
* ARM Cortex-A53
|
||||||
*/
|
*/
|
||||||
CORTEX_A53(0x00300353U),
|
CORTEX_A53(0x00300353U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A55 revision 0 (restricted dual-issue capabilities
|
* ARM Cortex-A55 revision 0 (restricted dual-issue capabilities
|
||||||
* compared to revision 1+).
|
* compared to revision 1+).
|
||||||
|
* ARM Cortex-A55修订版0（相比修订版1+，双发射能力受限）
|
||||||
*/
|
*/
|
||||||
CORTEX_A55R0(0x00300354U),
|
CORTEX_A55R0(0x00300354U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A55.
|
* ARM Cortex-A55.
|
||||||
|
* ARM Cortex-A55
|
||||||
*/
|
*/
|
||||||
CORTEX_A55(0x00300355U),
|
CORTEX_A55(0x00300355U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A57.
|
* ARM Cortex-A57.
|
||||||
|
* ARM Cortex-A57
|
||||||
*/
|
*/
|
||||||
CORTEX_A57(0x00300357U),
|
CORTEX_A57(0x00300357U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A65.
|
* ARM Cortex-A65.
|
||||||
|
* ARM Cortex-A65
|
||||||
*/
|
*/
|
||||||
CORTEX_A65(0x00300365U),
|
CORTEX_A65(0x00300365U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A72.
|
* ARM Cortex-A72.
|
||||||
|
* ARM Cortex-A72
|
||||||
*/
|
*/
|
||||||
CORTEX_A72(0x00300372U),
|
CORTEX_A72(0x00300372U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A73.
|
* ARM Cortex-A73.
|
||||||
|
* ARM Cortex-A73
|
||||||
*/
|
*/
|
||||||
CORTEX_A73(0x00300373U),
|
CORTEX_A73(0x00300373U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A75.
|
* ARM Cortex-A75.
|
||||||
|
* ARM Cortex-A75
|
||||||
*/
|
*/
|
||||||
CORTEX_A75(0x00300375U),
|
CORTEX_A75(0x00300375U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A76.
|
* ARM Cortex-A76.
|
||||||
|
* ARM Cortex-A76
|
||||||
*/
|
*/
|
||||||
CORTEX_A76(0x00300376U),
|
CORTEX_A76(0x00300376U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A77.
|
* ARM Cortex-A77.
|
||||||
|
* ARM Cortex-A77
|
||||||
*/
|
*/
|
||||||
CORTEX_A77(0x00300377U),
|
CORTEX_A77(0x00300377U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A78.
|
* ARM Cortex-A78.
|
||||||
|
* ARM Cortex-A78
|
||||||
*/
|
*/
|
||||||
CORTEX_A78(0x00300378U),
|
CORTEX_A78(0x00300378U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Neoverse N1.
|
* ARM Neoverse N1.
|
||||||
|
* ARM Neoverse N1（服务器级）
|
||||||
*/
|
*/
|
||||||
NEOVERSE_N1(0x00300400U),
|
NEOVERSE_N1(0x00300400U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Neoverse E1.
|
* ARM Neoverse E1.
|
||||||
|
* ARM Neoverse E1（边缘计算级）
|
||||||
*/
|
*/
|
||||||
NEOVERSE_E1(0x00300401U),
|
NEOVERSE_E1(0x00300401U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Neoverse V1.
|
* ARM Neoverse V1.
|
||||||
|
* ARM Neoverse V1（高性能级）
|
||||||
*/
|
*/
|
||||||
NEOVERSE_V1(0x00300402U),
|
NEOVERSE_V1(0x00300402U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Neoverse N2.
|
* ARM Neoverse N2.
|
||||||
|
* ARM Neoverse N2
|
||||||
*/
|
*/
|
||||||
NEOVERSE_N2(0x00300403U),
|
NEOVERSE_N2(0x00300403U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Neoverse V2.
|
* ARM Neoverse V2.
|
||||||
|
* ARM Neoverse V2
|
||||||
*/
|
*/
|
||||||
NEOVERSE_V2(0x00300404U),
|
NEOVERSE_V2(0x00300404U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-X1.
|
* ARM Cortex-X1.
|
||||||
|
* ARM Cortex-X1（超大核）
|
||||||
*/
|
*/
|
||||||
CORTEX_X1(0x00300501U),
|
CORTEX_X1(0x00300501U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-X2.
|
* ARM Cortex-X2.
|
||||||
|
* ARM Cortex-X2（超大核）
|
||||||
*/
|
*/
|
||||||
CORTEX_X2(0x00300502U),
|
CORTEX_X2(0x00300502U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-X3.
|
* ARM Cortex-X3.
|
||||||
|
* ARM Cortex-X3（超大核）
|
||||||
*/
|
*/
|
||||||
CORTEX_X3(0x00300503U),
|
CORTEX_X3(0x00300503U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-X4.
|
* ARM Cortex-X4.
|
||||||
|
* ARM Cortex-X4（超大核）
|
||||||
*/
|
*/
|
||||||
CORTEX_X4(0x00300504U),
|
CORTEX_X4(0x00300504U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A510.
|
* ARM Cortex-A510.
|
||||||
|
* ARM Cortex-A510（小核）
|
||||||
*/
|
*/
|
||||||
CORTEX_A510(0x00300551U),
|
CORTEX_A510(0x00300551U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A520.
|
* ARM Cortex-A520.
|
||||||
|
* ARM Cortex-A520（小核）
|
||||||
*/
|
*/
|
||||||
CORTEX_A520(0x00300552U),
|
CORTEX_A520(0x00300552U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A710.
|
* ARM Cortex-A710.
|
||||||
|
* ARM Cortex-A710（大核）
|
||||||
*/
|
*/
|
||||||
CORTEX_A710(0x00300571U),
|
CORTEX_A710(0x00300571U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A715.
|
* ARM Cortex-A715.
|
||||||
|
* ARM Cortex-A715（大核）
|
||||||
*/
|
*/
|
||||||
CORTEX_A715(0x00300572U),
|
CORTEX_A715(0x00300572U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Cortex-A720.
|
* ARM Cortex-A720.
|
||||||
|
* ARM Cortex-A720（大核）
|
||||||
*/
|
*/
|
||||||
CORTEX_A720(0x00300573U),
|
CORTEX_A720(0x00300573U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Qualcomm Scorpion.
|
* Qualcomm Scorpion.
|
||||||
|
* 高通Scorpion（天蝎座）
|
||||||
*/
|
*/
|
||||||
SCORPION(0x00400100U),
|
SCORPION(0x00400100U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Qualcomm Krait.
|
* Qualcomm Krait.
|
||||||
|
* 高通Krait（银环蛇）
|
||||||
*/
|
*/
|
||||||
KRAIT(0x00400101U),
|
KRAIT(0x00400101U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Qualcomm Kryo.
|
* Qualcomm Kryo.
|
||||||
|
* 高通Kryo（骁龙820起）
|
||||||
*/
|
*/
|
||||||
KRYO(0x00400102U),
|
KRYO(0x00400102U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Qualcomm Falkor.
|
* Qualcomm Falkor.
|
||||||
|
* 高通Falkor（服务器级）
|
||||||
*/
|
*/
|
||||||
FALKOR(0x00400103U),
|
FALKOR(0x00400103U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Qualcomm Saphira.
|
* Qualcomm Saphira.
|
||||||
|
* 高通Saphira（服务器级）
|
||||||
*/
|
*/
|
||||||
SAPHIRA(0x00400104U),
|
SAPHIRA(0x00400104U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Nvidia Denver.
|
* Nvidia Denver.
|
||||||
|
* 英伟达Denver（第1代）
|
||||||
*/
|
*/
|
||||||
DENVER(0x00500100U),
|
DENVER(0x00500100U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Nvidia Denver 2.
|
* Nvidia Denver 2.
|
||||||
|
* 英伟达Denver 2（第2代）
|
||||||
*/
|
*/
|
||||||
DENVER2(0x00500101U),
|
DENVER2(0x00500101U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Nvidia Carmel.
|
* Nvidia Carmel.
|
||||||
|
* 英伟达Carmel
|
||||||
*/
|
*/
|
||||||
CARMEL(0x00500102U),
|
CARMEL(0x00500102U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Samsung Exynos M1 (Exynos 8890 big cores).
|
* Samsung Exynos M1 (Exynos 8890 big cores).
|
||||||
|
* 三星Exynos M1（Exynos 8890大核）
|
||||||
*/
|
*/
|
||||||
EXYNOS_M1(0x00600100U),
|
EXYNOS_M1(0x00600100U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Samsung Exynos M2 (Exynos 8895 big cores).
|
* Samsung Exynos M2 (Exynos 8895 big cores).
|
||||||
|
* 三星Exynos M2（Exynos 8895大核）
|
||||||
*/
|
*/
|
||||||
EXYNOS_M2(0x00600101U),
|
EXYNOS_M2(0x00600101U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Samsung Exynos M3 (Exynos 9810 big cores).
|
* Samsung Exynos M3 (Exynos 9810 big cores).
|
||||||
|
* 三星Exynos M3（Exynos 9810大核）
|
||||||
*/
|
*/
|
||||||
EXYNOS_M3(0x00600102U),
|
EXYNOS_M3(0x00600102U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Samsung Exynos M4 (Exynos 9820 big cores).
|
* Samsung Exynos M4 (Exynos 9820 big cores).
|
||||||
|
* 三星Exynos M4（Exynos 9820大核）
|
||||||
*/
|
*/
|
||||||
EXYNOS_M4(0x00600103U),
|
EXYNOS_M4(0x00600103U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Samsung Exynos M5 (Exynos 9830 big cores).
|
* Samsung Exynos M5 (Exynos 9830 big cores).
|
||||||
|
* 三星Exynos M5（Exynos 9830大核）
|
||||||
*/
|
*/
|
||||||
EXYNOS_M5(0x00600104U),
|
EXYNOS_M5(0x00600104U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Deprecated synonym for Cortex-A76
|
* Deprecated synonym for Cortex-A76
|
||||||
|
* Cortex-A76的已弃用同义词
|
||||||
*/
|
*/
|
||||||
//CORTEX_A76AE(0x00300376U),
|
//CORTEX_A76AE(0x00300376U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Deprecated names for Exynos.
|
* Deprecated names for Exynos.
|
||||||
|
* Exynos的已弃用名称
|
||||||
*/
|
*/
|
||||||
//MONGOOSE_M1(0x00600100U),
|
//MONGOOSE_M1(0x00600100U),
|
||||||
//MONGOOSE_M2(0x00600101U),
|
//MONGOOSE_M2(0x00600101U),
|
||||||
@ -529,116 +634,139 @@ enum class Uarch(
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A6 and A6X processors.
|
* Apple A6 and A6X processors.
|
||||||
|
* 苹果A6和A6X处理器
|
||||||
*/
|
*/
|
||||||
SWIFT(0x00700100U),
|
SWIFT(0x00700100U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A7 processor.
|
* Apple A7 processor.
|
||||||
|
* 苹果A7处理器
|
||||||
*/
|
*/
|
||||||
CYCLONE(0x00700101U),
|
CYCLONE(0x00700101U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A8 and A8X processor.
|
* Apple A8 and A8X processor.
|
||||||
|
* 苹果A8和A8X处理器
|
||||||
*/
|
*/
|
||||||
TYPHOON(0x00700102U),
|
TYPHOON(0x00700102U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A9 and A9X processor.
|
* Apple A9 and A9X processor.
|
||||||
|
* 苹果A9和A9X处理器
|
||||||
*/
|
*/
|
||||||
TWISTER(0x00700103U),
|
TWISTER(0x00700103U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A10 and A10X processor.
|
* Apple A10 and A10X processor.
|
||||||
|
* 苹果A10和A10X处理器
|
||||||
*/
|
*/
|
||||||
HURRICANE(0x00700104U),
|
HURRICANE(0x00700104U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A11 processor (big cores).
|
* Apple A11 processor (big cores).
|
||||||
|
* 苹果A11处理器（大核）
|
||||||
*/
|
*/
|
||||||
MONSOON(0x00700105U),
|
MONSOON(0x00700105U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A11 processor (little cores).
|
* Apple A11 processor (little cores).
|
||||||
|
* 苹果A11处理器（小核）
|
||||||
*/
|
*/
|
||||||
MISTRAL(0x00700106U),
|
MISTRAL(0x00700106U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A12 processor (big cores).
|
* Apple A12 processor (big cores).
|
||||||
|
* 苹果A12处理器（大核）
|
||||||
*/
|
*/
|
||||||
VORTEX(0x00700107U),
|
VORTEX(0x00700107U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A12 processor (little cores).
|
* Apple A12 processor (little cores).
|
||||||
|
* 苹果A12处理器（小核）
|
||||||
*/
|
*/
|
||||||
TEMPEST(0x00700108U),
|
TEMPEST(0x00700108U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A13 processor (big cores).
|
* Apple A13 processor (big cores).
|
||||||
|
* 苹果A13处理器（大核）
|
||||||
*/
|
*/
|
||||||
LIGHTNING(0x00700109U),
|
LIGHTNING(0x00700109U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A13 processor (little cores).
|
* Apple A13 processor (little cores).
|
||||||
|
* 苹果A13处理器（小核）
|
||||||
*/
|
*/
|
||||||
THUNDER(0x0070010AU),
|
THUNDER(0x0070010AU),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A14 / M1 processor (big cores).
|
* Apple A14 / M1 processor (big cores).
|
||||||
|
* 苹果A14 / M1处理器（大核）
|
||||||
*/
|
*/
|
||||||
FIRESTORM(0x0070010BU),
|
FIRESTORM(0x0070010BU),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A14 / M1 processor (little cores).
|
* Apple A14 / M1 processor (little cores).
|
||||||
|
* 苹果A14 / M1处理器（小核）
|
||||||
*/
|
*/
|
||||||
ICESTORM(0x0070010CU),
|
ICESTORM(0x0070010CU),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A15 / M2 processor (big cores).
|
* Apple A15 / M2 processor (big cores).
|
||||||
|
* 苹果A15 / M2处理器（大核）
|
||||||
*/
|
*/
|
||||||
AVALANCHE(0x0070010DU),
|
AVALANCHE(0x0070010DU),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple A15 / M2 processor (little cores).
|
* Apple A15 / M2 processor (little cores).
|
||||||
|
* 苹果A15 / M2处理器（小核）
|
||||||
*/
|
*/
|
||||||
BLIZZARD(0x0070010EU),
|
BLIZZARD(0x0070010EU),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Cavium ThunderX.
|
* Cavium ThunderX.
|
||||||
|
* Cavium ThunderX（服务器级ARM）
|
||||||
*/
|
*/
|
||||||
THUNDERX(0x00800100U),
|
THUNDERX(0x00800100U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Cavium ThunderX2 (originally Broadcom Vulkan).
|
* Cavium ThunderX2 (originally Broadcom Vulkan).
|
||||||
|
* Cavium ThunderX2（原博通Vulkan）
|
||||||
*/
|
*/
|
||||||
THUNDERX2(0x00800200U),
|
THUNDERX2(0x00800200U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Marvell PJ4.
|
* Marvell PJ4.
|
||||||
|
* 美满PJ4
|
||||||
*/
|
*/
|
||||||
PJ4(0x00900100U),
|
PJ4(0x00900100U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Broadcom Brahma B15.
|
* Broadcom Brahma B15.
|
||||||
|
* 博通Brahma B15
|
||||||
*/
|
*/
|
||||||
BRAHMA_B15(0x00A00100U),
|
BRAHMA_B15(0x00A00100U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Broadcom Brahma B53.
|
* Broadcom Brahma B53.
|
||||||
|
* 博通Brahma B53
|
||||||
*/
|
*/
|
||||||
BRAHMA_B53(0x00A00101U),
|
BRAHMA_B53(0x00A00101U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Applied Micro X-Gene.
|
* Applied Micro X-Gene.
|
||||||
|
* 应用微电路X-Gene（服务器级ARM）
|
||||||
*/
|
*/
|
||||||
XGENE(0x00B00100U),
|
XGENE(0x00B00100U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Hygon Dhyana (a modification of AMD Zen for Chinese market).
|
* Hygon Dhyana (a modification of AMD Zen for Chinese market).
|
||||||
|
* 海光Dhyana（AMD Zen的中国市场修改版）
|
||||||
*/
|
*/
|
||||||
DHYANA(0x01000100U),
|
DHYANA(0x01000100U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* HiSilicon TaiShan v110 (Huawei Kunpeng 920 series processors).
|
* HiSilicon TaiShan v110 (Huawei Kunpeng 920 series processors).
|
||||||
|
* 海思泰山v110（华为鲲鹏920系列处理器）
|
||||||
*/
|
*/
|
||||||
TAISHAN_V110(0x00C00100U);
|
TAISHAN_V110(0x00C00100U);
|
||||||
|
|
||||||
|
|||||||
@ -10,30 +10,36 @@ import com.xyzshell.andinfo.libs.cpu.models.Uarch
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* `struct cpuinfo_uarch_info`
|
* `struct cpuinfo_uarch_info`
|
||||||
|
* CPU微架构信息结构体
|
||||||
*/
|
*/
|
||||||
data class UarchInfo(
|
data class UarchInfo(
|
||||||
/**
|
/**
|
||||||
* Type of CPU microarchitecture
|
* Type of CPU microarchitecture
|
||||||
|
* CPU微架构类型
|
||||||
*/
|
*/
|
||||||
val uarch: Uarch,
|
val uarch: Uarch,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Value of CPUID leaf 1 EAX register for the microarchitecture
|
* Value of CPUID leaf 1 EAX register for the microarchitecture
|
||||||
|
* 该微架构的CPUID leaf 1 EAX寄存器值（x86专用）
|
||||||
*/
|
*/
|
||||||
val cpuid: UInt?,
|
val cpuid: UInt?,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Value of Main ID Register (MIDR) for the microarchitecture
|
* Value of Main ID Register (MIDR) for the microarchitecture
|
||||||
|
* 该微架构的主ID寄存器（MIDR）值（ARM专用）
|
||||||
*/
|
*/
|
||||||
val midr: Midr?,
|
val midr: Midr?,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Number of logical processors with the microarchitecture
|
* Number of logical processors with the microarchitecture
|
||||||
|
* 使用此微架构的逻辑处理器数量
|
||||||
*/
|
*/
|
||||||
val processorCount: UInt,
|
val processorCount: UInt,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Number of cores with the microarchitecture
|
* Number of cores with the microarchitecture
|
||||||
|
* 使用此微架构的核心数量
|
||||||
*/
|
*/
|
||||||
val coreCount: UInt,
|
val coreCount: UInt,
|
||||||
) {
|
) {
|
||||||
|
|||||||
@ -7,8 +7,10 @@ package com.xyzshell.andinfo.libs.cpu.models
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* `enum cpuinfo_vendor`
|
* `enum cpuinfo_vendor`
|
||||||
|
* CPU供应商枚举
|
||||||
*
|
*
|
||||||
* Vendor of processor core design
|
* Vendor of processor core design
|
||||||
|
* 处理器核心设计的供应商
|
||||||
*/
|
*/
|
||||||
enum class Vendor(
|
enum class Vendor(
|
||||||
val value: UInt,
|
val value: UInt,
|
||||||
@ -16,207 +18,253 @@ enum class Vendor(
|
|||||||
/**
|
/**
|
||||||
* Processor vendor is not known to the library, or the library failed
|
* Processor vendor is not known to the library, or the library failed
|
||||||
* to get vendor information from the OS.
|
* to get vendor information from the OS.
|
||||||
|
* 处理器供应商未知，或库无法从操作系统获取供应商信息
|
||||||
*/
|
*/
|
||||||
UNKNOWN(0U),
|
UNKNOWN(0U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Intel Corporation. Vendor of x86, x86-64, IA64, and ARM processor
|
* Intel Corporation. Vendor of x86, x86-64, IA64, and ARM processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* 英特尔公司。x86、x86-64、IA64和ARM处理器微架构的供应商
|
||||||
*
|
*
|
||||||
* Sold its ARM design subsidiary in 2006. The last ARM processor design
|
* Sold its ARM design subsidiary in 2006. The last ARM processor design
|
||||||
* was released in 2004.
|
* was released in 2004.
|
||||||
|
* 2006年出售了其ARM设计子公司。最后一款ARM处理器设计于2004年发布
|
||||||
*/
|
*/
|
||||||
INTEL(1U),
|
INTEL(1U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Advanced Micro Devices, Inc. Vendor of x86 and x86-64 processor
|
* Advanced Micro Devices, Inc. Vendor of x86 and x86-64 processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* 超威半导体公司（AMD）。x86和x86-64处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
AMD(2U),
|
AMD(2U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* ARM Holdings plc. Vendor of ARM and ARM64 processor
|
* ARM Holdings plc. Vendor of ARM and ARM64 processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* ARM控股有限公司。ARM和ARM64处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
ARM(3U),
|
ARM(3U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Qualcomm Incorporated. Vendor of ARM and ARM64 processor
|
* Qualcomm Incorporated. Vendor of ARM and ARM64 processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* 高通公司。ARM和ARM64处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
QUALCOMM(4U),
|
QUALCOMM(4U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Apple Inc. Vendor of ARM and ARM64 processor microarchitectures.
|
* Apple Inc. Vendor of ARM and ARM64 processor microarchitectures.
|
||||||
|
* 苹果公司。ARM和ARM64处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
APPLE(5U),
|
APPLE(5U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Samsung Electronics Co., Ltd. Vendir if ARM64 processor
|
* Samsung Electronics Co., Ltd. Vendir if ARM64 processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* 三星电子有限公司。ARM64处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
SAMSUNG(6U),
|
SAMSUNG(6U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Nvidia Corporation. Vendor of ARM64-compatible processor
|
* Nvidia Corporation. Vendor of ARM64-compatible processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* 英伟达公司。ARM64兼容处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
NVIDIA(7U),
|
NVIDIA(7U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* MIPS Technologies, Inc. Vendor of MIPS processor microarchitectures.
|
* MIPS Technologies, Inc. Vendor of MIPS processor microarchitectures.
|
||||||
|
* MIPS科技公司。MIPS处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
MIPS(8U),
|
MIPS(8U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* International Business Machines Corporation. Vendor of PowerPC
|
* International Business Machines Corporation. Vendor of PowerPC
|
||||||
* processor microarchitectures.
|
* processor microarchitectures.
|
||||||
|
* 国际商业机器公司（IBM）。PowerPC处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
IBM(9U),
|
IBM(9U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Ingenic Semiconductor. Vendor of MIPS processor microarchitectures.
|
* Ingenic Semiconductor. Vendor of MIPS processor microarchitectures.
|
||||||
|
* 君正半导体。MIPS处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
INGENIC(10U),
|
INGENIC(10U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* VIA Technologies, Inc. Vendor of x86 and x86-64 processor
|
* VIA Technologies, Inc. Vendor of x86 and x86-64 processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* 威盛科技股份有限公司。x86和x86-64处理器微架构的供应商
|
||||||
*
|
*
|
||||||
* Processors are designed by Centaur Technology, a subsidiary of VIA
|
* Processors are designed by Centaur Technology, a subsidiary of VIA
|
||||||
* Technologies.
|
* Technologies.
|
||||||
|
* 处理器由威盛科技的子公司Centaur Technology设计
|
||||||
*/
|
*/
|
||||||
VIA(11U),
|
VIA(11U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Cavium, Inc. Vendor of ARM64 processor microarchitectures.
|
* Cavium, Inc. Vendor of ARM64 processor microarchitectures.
|
||||||
|
* Cavium公司。ARM64处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
CAVIUM(12U),
|
CAVIUM(12U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Broadcom, Inc. Vendor of ARM processor microarchitectures.
|
* Broadcom, Inc. Vendor of ARM processor microarchitectures.
|
||||||
|
* 博通公司。ARM处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
BROADCOM(13U),
|
BROADCOM(13U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Applied Micro Circuits Corporation (APM). Vendor of ARM64 processor
|
* Applied Micro Circuits Corporation (APM). Vendor of ARM64 processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* 应用微电路公司（APM）。ARM64处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
APM(14U),
|
APM(14U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Huawei Technologies Co., Ltd. Vendor of ARM64 processor
|
* Huawei Technologies Co., Ltd. Vendor of ARM64 processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* 华为技术有限公司。ARM64处理器微架构的供应商
|
||||||
*
|
*
|
||||||
* Processors are designed by HiSilicon, a subsidiary of Huawei.
|
* Processors are designed by HiSilicon, a subsidiary of Huawei.
|
||||||
|
* 处理器由华为的子公司海思半导体设计
|
||||||
*/
|
*/
|
||||||
HUAWEI(15U),
|
HUAWEI(15U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Hygon (Chengdu Haiguang Integrated Circuit Design Co., Ltd), Vendor
|
* Hygon (Chengdu Haiguang Integrated Circuit Design Co., Ltd), Vendor
|
||||||
* of x86-64 processor microarchitectures.
|
* of x86-64 processor microarchitectures.
|
||||||
|
* 海光（成都海光集成电路设计有限公司）。x86-64处理器微架构的供应商
|
||||||
*
|
*
|
||||||
* Processors are variants of AMD cores.
|
* Processors are variants of AMD cores.
|
||||||
|
* 处理器是AMD核心的变体
|
||||||
*/
|
*/
|
||||||
HYGON(16U),
|
HYGON(16U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* SiFive, Inc. Vendor of RISC-V processor microarchitectures.
|
* SiFive, Inc. Vendor of RISC-V processor microarchitectures.
|
||||||
|
* SiFive公司。RISC-V处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
SIFIVE(17U),
|
SIFIVE(17U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Texas Instruments Inc. Vendor of ARM processor microarchitectures.
|
* Texas Instruments Inc. Vendor of ARM processor microarchitectures.
|
||||||
|
* 德州仪器公司。ARM处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
TEXAS_INSTRUMENTS(30U),
|
TEXAS_INSTRUMENTS(30U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Marvell Technology Group Ltd. Vendor of ARM processor
|
* Marvell Technology Group Ltd. Vendor of ARM processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* 美满电子科技集团。ARM处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
MARVELL(31U),
|
MARVELL(31U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* RDC Semiconductor Co., Ltd. Vendor of x86 processor
|
* RDC Semiconductor Co., Ltd. Vendor of x86 processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* 扬智科技股份有限公司。x86处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
RDC(32U),
|
RDC(32U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* DM&P Electronics Inc. Vendor of x86 processor microarchitectures.
|
* DM&P Electronics Inc. Vendor of x86 processor microarchitectures.
|
||||||
|
* 帝睿电子公司。x86处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
DMP(33U),
|
DMP(33U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Motorola, Inc. Vendor of PowerPC and ARM processor
|
* Motorola, Inc. Vendor of PowerPC and ARM processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* 摩托罗拉公司。PowerPC和ARM处理器微架构的供应商
|
||||||
*/
|
*/
|
||||||
MOTOROLA(34U),
|
MOTOROLA(34U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Transmeta Corporation. Vendor of x86 processor microarchitectures.
|
* Transmeta Corporation. Vendor of x86 processor microarchitectures.
|
||||||
|
* 全美达公司。x86处理器微架构的供应商
|
||||||
*
|
*
|
||||||
* Now defunct. The last processor design was released in 2004.
|
* Now defunct. The last processor design was released in 2004.
|
||||||
* Transmeta processors implemented VLIW ISA and used binary translation
|
* Transmeta processors implemented VLIW ISA and used binary translation
|
||||||
* to execute x86 code.
|
* to execute x86 code.
|
||||||
|
* 现已倒闭。最后一款处理器设计于2004年发布。全美达处理器实现了VLIW指令集，
|
||||||
|
* 并使用二进制翻译来执行x86代码
|
||||||
*/
|
*/
|
||||||
TRANSMETA(50U),
|
TRANSMETA(50U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Cyrix Corporation. Vendor of x86 processor microarchitectures.
|
* Cyrix Corporation. Vendor of x86 processor microarchitectures.
|
||||||
|
* Cyrix公司。x86处理器微架构的供应商
|
||||||
*
|
*
|
||||||
* Now defunct. The last processor design was released in 1996.
|
* Now defunct. The last processor design was released in 1996.
|
||||||
|
* 现已倒闭。最后一款处理器设计于1996年发布
|
||||||
*/
|
*/
|
||||||
CYRIX(51U),
|
CYRIX(51U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Rise Technology. Vendor of x86 processor microarchitectures.
|
* Rise Technology. Vendor of x86 processor microarchitectures.
|
||||||
|
* Rise科技。x86处理器微架构的供应商
|
||||||
*
|
*
|
||||||
* Now defunct. The last processor design was released in 1999.
|
* Now defunct. The last processor design was released in 1999.
|
||||||
|
* 现已倒闭。最后一款处理器设计于1999年发布
|
||||||
*/
|
*/
|
||||||
RISE(52U),
|
RISE(52U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* National Semiconductor. Vendor of x86 processor microarchitectures.
|
* National Semiconductor. Vendor of x86 processor microarchitectures.
|
||||||
|
* 美国国家半导体公司。x86处理器微架构的供应商
|
||||||
*
|
*
|
||||||
* Sold its x86 design subsidiary in 1999. The last processor design was
|
* Sold its x86 design subsidiary in 1999. The last processor design was
|
||||||
* released in 1998.
|
* released in 1998.
|
||||||
|
* 1999年出售了其x86设计子公司。最后一款处理器设计于1998年发布
|
||||||
*/
|
*/
|
||||||
NSC(53U),
|
NSC(53U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Silicon Integrated Systems. Vendor of x86 processor
|
* Silicon Integrated Systems. Vendor of x86 processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* 矽统科技。x86处理器微架构的供应商
|
||||||
*
|
*
|
||||||
* Sold its x86 design subsidiary in 2001. The last processor design was
|
* Sold its x86 design subsidiary in 2001. The last processor design was
|
||||||
* released in 2001.
|
* released in 2001.
|
||||||
|
* 2001年出售了其x86设计子公司。最后一款处理器设计于2001年发布
|
||||||
*/
|
*/
|
||||||
SIS(54U),
|
SIS(54U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* NexGen. Vendor of x86 processor microarchitectures.
|
* NexGen. Vendor of x86 processor microarchitectures.
|
||||||
|
* NexGen公司。x86处理器微架构的供应商
|
||||||
*
|
*
|
||||||
* Now defunct. The last processor design was released in 1994.
|
* Now defunct. The last processor design was released in 1994.
|
||||||
* NexGen designed the first x86 microarchitecture which decomposed x86
|
* NexGen designed the first x86 microarchitecture which decomposed x86
|
||||||
* instructions into simple microoperations.
|
* instructions into simple microoperations.
|
||||||
|
* 现已倒闭。最后一款处理器设计于1994年发布。NexGen设计了第一个将x86
|
||||||
|
* 指令分解为简单微操作的x86微架构
|
||||||
*/
|
*/
|
||||||
NEXGEN(55U),
|
NEXGEN(55U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* United Microelectronics Corporation. Vendor of x86 processor
|
* United Microelectronics Corporation. Vendor of x86 processor
|
||||||
* microarchitectures.
|
* microarchitectures.
|
||||||
|
* 联华电子公司。x86处理器微架构的供应商
|
||||||
*
|
*
|
||||||
* Ceased x86 in the early 1990s. The last processor design was released
|
* Ceased x86 in the early 1990s. The last processor design was released
|
||||||
* in 1991. Designed U5C and U5D processors. Both are 486 level.
|
* in 1991. Designed U5C and U5D processors. Both are 486 level.
|
||||||
|
* 在1990年代初停止x86业务。最后一款处理器设计于1991年发布。设计了U5C
|
||||||
|
* 和U5D处理器，均为486级别
|
||||||
*/
|
*/
|
||||||
UMC(56U),
|
UMC(56U),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Digital Equipment Corporation. Vendor of ARM processor
|
* Digital Equipment Corporation. Vendor of ARM processor
|
||||||
* microarchitecture.
|
* microarchitecture.
|
||||||
|
* 迪吉多公司（DEC）。ARM处理器微架构的供应商
|
||||||
*
|
*
|
||||||
* Sold its ARM designs in 1997. The last processor design was released
|
* Sold its ARM designs in 1997. The last processor design was released
|
||||||
* in 1997.
|
* in 1997.
|
||||||
|
* 1997年出售了其ARM设计。最后一款处理器设计于1997年发布
|
||||||
*/
|
*/
|
||||||
DEC(57U);
|
DEC(57U);
|
||||||
|
|
||||||
|
|||||||
@ -0,0 +1,108 @@
|
|||||||
|
package com.xyzshell.andinfo.models
|
||||||
|
|
||||||
|
import com.google.gson.annotations.SerializedName
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备信息上传请求数据模型
|
||||||
|
*/
|
||||||
|
data class DeviceInfoRequest(
|
||||||
|
@SerializedName("cpuInfo")
|
||||||
|
val cpuInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("gpuInfo")
|
||||||
|
val gpuInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("screenInfo")
|
||||||
|
val screenInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("memoryInfo")
|
||||||
|
val memoryInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("diskInfo")
|
||||||
|
val diskInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("networkInfo")
|
||||||
|
val networkInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("batteryInfo")
|
||||||
|
val batteryInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("deviceInfo")
|
||||||
|
val deviceInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("appInfo")
|
||||||
|
val appInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("systemInfo")
|
||||||
|
val systemInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("locationInfo")
|
||||||
|
val locationInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("cameraInfo")
|
||||||
|
val cameraInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("sensorInfo")
|
||||||
|
val sensorInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("propsInfo")
|
||||||
|
val propsInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("bluetoothInfo")
|
||||||
|
val bluetoothInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("wifiInfo")
|
||||||
|
val wifiInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("nfcInfo")
|
||||||
|
val nfcInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("usbInfo")
|
||||||
|
val usbInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("buildInfo")
|
||||||
|
val buildInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("deviceId")
|
||||||
|
val deviceId: String,
|
||||||
|
|
||||||
|
@SerializedName("deviceName")
|
||||||
|
val deviceName: String,
|
||||||
|
|
||||||
|
@SerializedName("drmInfo")
|
||||||
|
val drmInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("inputInfo")
|
||||||
|
val inputInfo: String,
|
||||||
|
|
||||||
|
@SerializedName("gaid")
|
||||||
|
val gaid: String
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 加密请求数据模型
|
||||||
|
*/
|
||||||
|
data class EncryptedRequest(
|
||||||
|
@SerializedName("encrypted")
|
||||||
|
val encrypted: String
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* API 响应数据模型
|
||||||
|
*/
|
||||||
|
data class ApiResponse(
|
||||||
|
@SerializedName("data")
|
||||||
|
val data: Any?,
|
||||||
|
|
||||||
|
@SerializedName("message")
|
||||||
|
val message: String,
|
||||||
|
|
||||||
|
@SerializedName("status")
|
||||||
|
val status: String // "Success" 或 "Fail"
|
||||||
|
) {
|
||||||
|
/**
|
||||||
|
* 判断请求是否成功
|
||||||
|
*/
|
||||||
|
fun isSuccess(): Boolean = status == "Success"
|
||||||
|
}
|
||||||
|
|
||||||
@ -9,13 +9,39 @@ import java.io.IOException
|
|||||||
import javax.crypto.Cipher
|
import javax.crypto.Cipher
|
||||||
import javax.crypto.spec.SecretKeySpec
|
import javax.crypto.spec.SecretKeySpec
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 设备信息上传 API 地址
|
||||||
|
*/
|
||||||
|
const val upload_info_api = "https://api.xyzshell.com/api/mobile/checker/save"
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Web 服务工具类
|
||||||
|
* 提供 HTTP 请求、JSON 序列化和 AES 加密功能
|
||||||
|
*/
|
||||||
class WebService {
|
class WebService {
|
||||||
|
/**
|
||||||
|
* OkHttp 客户端实例
|
||||||
|
*/
|
||||||
private val client = OkHttpClient()
|
private val client = OkHttpClient()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Gson 序列化工具
|
||||||
|
*/
|
||||||
val gson = Gson()
|
val gson = Gson()
|
||||||
// AES 密钥 (必须是 16/24/32 字节)
|
|
||||||
|
/**
|
||||||
|
* AES 加密密钥（必须是 16/24/32 字节）
|
||||||
|
*/
|
||||||
private val aesKey = "e67cbcee5e573d1b"
|
private val aesKey = "e67cbcee5e573d1b"
|
||||||
|
|
||||||
// AES 加密
|
/**
|
||||||
|
* AES 加密方法
|
||||||
|
* 使用 AES/ECB 模式加密字符串
|
||||||
|
*
|
||||||
|
* @param plainText 明文字符串
|
||||||
|
* @return Base64 编码的加密字符串
|
||||||
|
* @throws Exception 加密失败时抛出异常
|
||||||
|
*/
|
||||||
fun encrypt(plainText: String): String {
|
fun encrypt(plainText: String): String {
|
||||||
return try {
|
return try {
|
||||||
val secretKey = SecretKeySpec(aesKey.toByteArray(), "AES")
|
val secretKey = SecretKeySpec(aesKey.toByteArray(), "AES")
|
||||||
@ -27,6 +53,14 @@ class WebService {
|
|||||||
throw Exception("加密失败: ${e.message}")
|
throw Exception("加密失败: ${e.message}")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 异步 POST 请求
|
||||||
|
*
|
||||||
|
* @param url 请求地址
|
||||||
|
* @param jsonData JSON 格式的请求数据
|
||||||
|
* @param callback 回调函数 (响应字符串, 错误异常)
|
||||||
|
*/
|
||||||
fun postData(url: String, jsonData: String, callback: (String?, Exception?) -> Unit) {
|
fun postData(url: String, jsonData: String, callback: (String?, Exception?) -> Unit) {
|
||||||
val mediaType = "application/json; charset=utf-8".toMediaType()
|
val mediaType = "application/json; charset=utf-8".toMediaType()
|
||||||
val body = jsonData.toRequestBody(mediaType)
|
val body = jsonData.toRequestBody(mediaType)
|
||||||
@ -53,7 +87,13 @@ class WebService {
|
|||||||
})
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
// 同步版本
|
/**
|
||||||
|
* 同步 POST 请求（阻塞当前线程）
|
||||||
|
*
|
||||||
|
* @param url 请求地址
|
||||||
|
* @param jsonData JSON 格式的请求数据
|
||||||
|
* @return 响应字符串，失败时返回 null
|
||||||
|
*/
|
||||||
fun postDataSync(url: String, jsonData: String): String? {
|
fun postDataSync(url: String, jsonData: String): String? {
|
||||||
val mediaType = "application/json; charset=utf-8".toMediaType()
|
val mediaType = "application/json; charset=utf-8".toMediaType()
|
||||||
val body = jsonData.toRequestBody(mediaType)
|
val body = jsonData.toRequestBody(mediaType)
|
||||||
@ -72,12 +112,22 @@ class WebService {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// 序列化对象为 JSON
|
/**
|
||||||
|
* 序列化对象为 JSON 字符串
|
||||||
|
*
|
||||||
|
* @param obj 要序列化的对象
|
||||||
|
* @return JSON 字符串
|
||||||
|
*/
|
||||||
fun <T> toJson(obj: T): String {
|
fun <T> toJson(obj: T): String {
|
||||||
return gson.toJson(obj)
|
return gson.toJson(obj)
|
||||||
}
|
}
|
||||||
|
|
||||||
// 反序列化 JSON 为对象
|
/**
|
||||||
|
* 反序列化 JSON 字符串为对象
|
||||||
|
*
|
||||||
|
* @param json JSON 字符串
|
||||||
|
* @return 反序列化的对象，失败时返回 null
|
||||||
|
*/
|
||||||
inline fun <reified T> fromJson(json: String): T? {
|
inline fun <reified T> fromJson(json: String): T? {
|
||||||
return try {
|
return try {
|
||||||
gson.fromJson(json, T::class.java)
|
gson.fromJson(json, T::class.java)
|
||||||
@ -86,12 +136,27 @@ class WebService {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// 带序列化的 POST 请求
|
/**
|
||||||
|
* 带序列化的 POST 请求
|
||||||
|
* 自动将对象序列化为 JSON 后发送
|
||||||
|
*
|
||||||
|
* @param url 请求地址
|
||||||
|
* @param obj 要发送的对象
|
||||||
|
* @param callback 回调函数 (响应字符串, 错误异常)
|
||||||
|
*/
|
||||||
fun <T> postObject(url: String, obj: T, callback: (String?, Exception?) -> Unit) {
|
fun <T> postObject(url: String, obj: T, callback: (String?, Exception?) -> Unit) {
|
||||||
val jsonData = toJson(obj)
|
val jsonData = toJson(obj)
|
||||||
postData(url, jsonData, callback)
|
postData(url, jsonData, callback)
|
||||||
}
|
}
|
||||||
// 带序列化和反序列化的 POST 请求
|
|
||||||
|
/**
|
||||||
|
* 带序列化和反序列化的 POST 请求
|
||||||
|
* 自动将请求对象序列化为 JSON，并将响应反序列化为对象
|
||||||
|
*
|
||||||
|
* @param url 请求地址
|
||||||
|
* @param obj 要发送的对象
|
||||||
|
* @param callback 回调函数 (响应对象, 错误异常)
|
||||||
|
*/
|
||||||
inline fun <reified T, reified R> postAndParse(
|
inline fun <reified T, reified R> postAndParse(
|
||||||
url: String,
|
url: String,
|
||||||
obj: T,
|
obj: T,
|
||||||
|
|||||||
528
设备信息收集和上传使用指南.md
Normal file
528
设备信息收集和上传使用指南.md
Normal file
@ -0,0 +1,528 @@
|
|||||||
|
# 设备信息收集和上传使用指南
|
||||||
|
|
||||||
|
## 概述
|
||||||
|
本功能提供了完整的设备信息收集、序列化、加密和上传功能。所有信息收集都是异步并发执行，性能优化且不会阻塞主线程。
|
||||||
|
|
||||||
|
## 功能特性
|
||||||
|
|
||||||
|
### 1. 信息收集模块
|
||||||
|
自动收集以下 24 类设备信息：
|
||||||
|
- CPU 信息
|
||||||
|
- GPU 信息
|
||||||
|
- 屏幕信息
|
||||||
|
- 内存信息
|
||||||
|
- 磁盘信息
|
||||||
|
- 网络信息
|
||||||
|
- 电池信息
|
||||||
|
- 设备信息
|
||||||
|
- 应用信息
|
||||||
|
- 系统信息
|
||||||
|
- 定位信息
|
||||||
|
- 相机信息
|
||||||
|
- 传感器信息
|
||||||
|
- 系统属性
|
||||||
|
- 蓝牙信息
|
||||||
|
- WiFi 信息
|
||||||
|
- NFC 信息
|
||||||
|
- USB 信息
|
||||||
|
- 构建信息
|
||||||
|
- DRM 信息
|
||||||
|
- 输入设备信息
|
||||||
|
- Device ID
|
||||||
|
- GAID
|
||||||
|
|
||||||
|
### 2. 数据处理流程
|
||||||
|
1. **异步收集** - 并发收集所有信息，提高性能
|
||||||
|
2. **JSON 序列化** - 将所有信息转换为 JSON 格式
|
||||||
|
3. **AES 加密** - 使用 AES 加密保护数据
|
||||||
|
4. **HTTP POST** - 发送加密数据到服务器
|
||||||
|
5. **响应处理** - 解析服务器响应
|
||||||
|
|
||||||
|
## 使用方法
|
||||||
|
|
||||||
|
### 1. 基本使用
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
import androidx.lifecycle.lifecycleScope
|
||||||
|
import com.xyzshell.andinfo.AndInfo
|
||||||
|
import com.xyzshell.andinfo.collector.DeviceInfoCollector
|
||||||
|
import kotlinx.coroutines.launch
|
||||||
|
|
||||||
|
class MainActivity : AppCompatActivity() {
|
||||||
|
override fun onCreate(savedInstanceState: Bundle?) {
|
||||||
|
super.onCreate(savedInstanceState)
|
||||||
|
|
||||||
|
// 初始化 AndInfo
|
||||||
|
AndInfo.init(applicationContext)
|
||||||
|
|
||||||
|
// 收集并上传设备信息
|
||||||
|
uploadDeviceInfo()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun uploadDeviceInfo() {
|
||||||
|
lifecycleScope.launch {
|
||||||
|
val collector = DeviceInfoCollector(applicationContext)
|
||||||
|
|
||||||
|
collector.collectAndUpload { message, error ->
|
||||||
|
if (error != null) {
|
||||||
|
// 上传失败
|
||||||
|
runOnUiThread {
|
||||||
|
Toast.makeText(
|
||||||
|
this@MainActivity,
|
||||||
|
"上传失败: ${error.message}",
|
||||||
|
Toast.LENGTH_LONG
|
||||||
|
).show()
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
// 上传成功
|
||||||
|
runOnUiThread {
|
||||||
|
Toast.makeText(
|
||||||
|
this@MainActivity,
|
||||||
|
"上传成功: $message",
|
||||||
|
Toast.LENGTH_SHORT
|
||||||
|
).show()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 仅收集信息（不上传）
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
lifecycleScope.launch {
|
||||||
|
val collector = DeviceInfoCollector(applicationContext)
|
||||||
|
|
||||||
|
// 仅收集信息，不上传
|
||||||
|
val deviceInfo = collector.collectAllInfo()
|
||||||
|
|
||||||
|
// 转换为 JSON 查看
|
||||||
|
val json = collector.gson.toJson(deviceInfo)
|
||||||
|
println("设备信息: $json")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 在 ViewModel 中使用
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class DeviceInfoViewModel : ViewModel() {
|
||||||
|
private val _uploadStatus = MutableLiveData<UploadStatus>()
|
||||||
|
val uploadStatus: LiveData<UploadStatus> = _uploadStatus
|
||||||
|
|
||||||
|
fun uploadDeviceInfo(context: Context) {
|
||||||
|
viewModelScope.launch {
|
||||||
|
_uploadStatus.value = UploadStatus.Loading
|
||||||
|
|
||||||
|
val collector = DeviceInfoCollector(context)
|
||||||
|
|
||||||
|
collector.collectAndUpload { message, error ->
|
||||||
|
if (error != null) {
|
||||||
|
_uploadStatus.postValue(UploadStatus.Error(error.message ?: "上传失败"))
|
||||||
|
} else {
|
||||||
|
_uploadStatus.postValue(UploadStatus.Success(message ?: "上传成功"))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
sealed class UploadStatus {
|
||||||
|
object Loading : UploadStatus()
|
||||||
|
data class Success(val message: String) : UploadStatus()
|
||||||
|
data class Error(val message: String) : UploadStatus()
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. 带进度显示的上传
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class UploadActivity : AppCompatActivity() {
|
||||||
|
private lateinit var progressDialog: ProgressDialog
|
||||||
|
|
||||||
|
private fun uploadWithProgress() {
|
||||||
|
// 显示进度对话框
|
||||||
|
progressDialog = ProgressDialog(this).apply {
|
||||||
|
setMessage("正在收集设备信息...")
|
||||||
|
setCancelable(false)
|
||||||
|
show()
|
||||||
|
}
|
||||||
|
|
||||||
|
lifecycleScope.launch {
|
||||||
|
val collector = DeviceInfoCollector(applicationContext)
|
||||||
|
|
||||||
|
// 更新进度
|
||||||
|
progressDialog.setMessage("正在上传...")
|
||||||
|
|
||||||
|
collector.collectAndUpload { message, error ->
|
||||||
|
runOnUiThread {
|
||||||
|
progressDialog.dismiss()
|
||||||
|
|
||||||
|
if (error != null) {
|
||||||
|
AlertDialog.Builder(this@UploadActivity)
|
||||||
|
.setTitle("上传失败")
|
||||||
|
.setMessage(error.message)
|
||||||
|
.setPositiveButton("确定", null)
|
||||||
|
.show()
|
||||||
|
} else {
|
||||||
|
AlertDialog.Builder(this@UploadActivity)
|
||||||
|
.setTitle("上传成功")
|
||||||
|
.setMessage(message)
|
||||||
|
.setPositiveButton("确定", null)
|
||||||
|
.show()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. 定时自动上传
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class AutoUploadService : Service() {
|
||||||
|
private val uploadInterval = 24 * 60 * 60 * 1000L // 24小时
|
||||||
|
private val handler = Handler(Looper.getMainLooper())
|
||||||
|
|
||||||
|
private val uploadRunnable = object : Runnable {
|
||||||
|
override fun run() {
|
||||||
|
uploadDeviceInfo()
|
||||||
|
handler.postDelayed(this, uploadInterval)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
|
||||||
|
handler.post(uploadRunnable)
|
||||||
|
return START_STICKY
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun uploadDeviceInfo() {
|
||||||
|
CoroutineScope(Dispatchers.IO).launch {
|
||||||
|
val collector = DeviceInfoCollector(applicationContext)
|
||||||
|
|
||||||
|
collector.collectAndUpload { message, error ->
|
||||||
|
if (error != null) {
|
||||||
|
Log.e("AutoUpload", "上传失败: ${error.message}")
|
||||||
|
} else {
|
||||||
|
Log.i("AutoUpload", "上传成功: $message")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun onDestroy() {
|
||||||
|
handler.removeCallbacks(uploadRunnable)
|
||||||
|
super.onDestroy()
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun onBind(intent: Intent?): IBinder? = null
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## API 接口说明
|
||||||
|
|
||||||
|
### 请求格式
|
||||||
|
|
||||||
|
**URL**: `https://api.xyzshell.com/api/mobile/checker/save`
|
||||||
|
|
||||||
|
**Method**: POST
|
||||||
|
|
||||||
|
**Content-Type**: application/json
|
||||||
|
|
||||||
|
**请求体**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"encrypted": "AES加密后的Base64字符串"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**加密前的数据格式**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"cpuInfo": "{\"processorName\":\"ARM\",\"cores\":8}",
|
||||||
|
"gpuInfo": "{\"vendor\":\"Qualcomm\",\"renderer\":\"Adreno 650\"}",
|
||||||
|
"screenInfo": "{\"width\":1080,\"height\":2400}",
|
||||||
|
"memoryInfo": "{\"totalMem\":8589934592}",
|
||||||
|
"diskInfo": "{\"totalSpace\":128000000000}",
|
||||||
|
"networkInfo": "{}",
|
||||||
|
"batteryInfo": "{\"level\":85,\"status\":3}",
|
||||||
|
"deviceInfo": "{\"brand\":\"Samsung\",\"model\":\"SM-G998B\"}",
|
||||||
|
"appInfo": "{}",
|
||||||
|
"systemInfo": "{\"androidVersion\":\"13\",\"sdkInt\":33}",
|
||||||
|
"locationInfo": "{\"gpsSupported\":true}",
|
||||||
|
"cameraInfo": "{\"cameraCount\":4}",
|
||||||
|
"sensorInfo": "{\"sensorCount\":20}",
|
||||||
|
"propsInfo": "{}",
|
||||||
|
"bluetoothInfo": "{\"supported\":true,\"enabled\":true}",
|
||||||
|
"wifiInfo": "{}",
|
||||||
|
"nfcInfo": "{\"supported\":true}",
|
||||||
|
"usbInfo": "{\"hostSupported\":true}",
|
||||||
|
"buildInfo": "{\"trebleEnabled\":true}",
|
||||||
|
"deviceId": "9774d56d682e549c",
|
||||||
|
"deviceName": "Samsung SM-G998B",
|
||||||
|
"drmInfo": "{\"supportedSchemes\":2}",
|
||||||
|
"inputInfo": "{\"deviceCount\":3}",
|
||||||
|
"gaid": "38400000-8cf0-11bd-b23e-10b96e40000d"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 响应格式
|
||||||
|
|
||||||
|
**成功响应**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"data": null,
|
||||||
|
"message": "设备信息保存成功",
|
||||||
|
"status": "Success"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**失败响应**:
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"data": null,
|
||||||
|
"message": "错误详情信息",
|
||||||
|
"status": "Fail"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 数据模型
|
||||||
|
|
||||||
|
### DeviceInfoRequest
|
||||||
|
```kotlin
|
||||||
|
data class DeviceInfoRequest(
|
||||||
|
val cpuInfo: String, // CPU信息JSON
|
||||||
|
val gpuInfo: String, // GPU信息JSON
|
||||||
|
val screenInfo: String, // 屏幕信息JSON
|
||||||
|
val memoryInfo: String, // 内存信息JSON
|
||||||
|
val diskInfo: String, // 磁盘信息JSON
|
||||||
|
val networkInfo: String, // 网络信息JSON
|
||||||
|
val batteryInfo: String, // 电池信息JSON
|
||||||
|
val deviceInfo: String, // 设备信息JSON
|
||||||
|
val appInfo: String, // 应用信息JSON
|
||||||
|
val systemInfo: String, // 系统信息JSON
|
||||||
|
val locationInfo: String, // 定位信息JSON
|
||||||
|
val cameraInfo: String, // 相机信息JSON
|
||||||
|
val sensorInfo: String, // 传感器信息JSON
|
||||||
|
val propsInfo: String, // 系统属性JSON
|
||||||
|
val bluetoothInfo: String, // 蓝牙信息JSON
|
||||||
|
val wifiInfo: String, // WiFi信息JSON
|
||||||
|
val nfcInfo: String, // NFC信息JSON
|
||||||
|
val usbInfo: String, // USB信息JSON
|
||||||
|
val buildInfo: String, // 构建信息JSON
|
||||||
|
val deviceId: String, // 设备ID
|
||||||
|
val deviceName: String, // 设备名称
|
||||||
|
val drmInfo: String, // DRM信息JSON
|
||||||
|
val inputInfo: String, // 输入信息JSON
|
||||||
|
val gaid: String // Google广告ID
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
### EncryptedRequest
|
||||||
|
```kotlin
|
||||||
|
data class EncryptedRequest(
|
||||||
|
val encrypted: String // AES加密后的Base64字符串
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
### ApiResponse
|
||||||
|
```kotlin
|
||||||
|
data class ApiResponse(
|
||||||
|
val data: Any?, // 响应数据
|
||||||
|
val message: String, // 响应消息
|
||||||
|
val status: String // 状态: "Success" 或 "Fail"
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
## 加密说明
|
||||||
|
|
||||||
|
### AES 加密
|
||||||
|
- **算法**: AES/ECB/PKCS5Padding
|
||||||
|
- **密钥**: "e67cbcee5e573d1b" (16字节)
|
||||||
|
- **编码**: Base64 (NO_WRAP)
|
||||||
|
|
||||||
|
### 加密示例
|
||||||
|
```kotlin
|
||||||
|
val webService = WebService()
|
||||||
|
val plainText = """{"test": "data"}"""
|
||||||
|
val encrypted = webService.encrypt(plainText)
|
||||||
|
println("加密结果: $encrypted")
|
||||||
|
```
|
||||||
|
|
||||||
|
## 权限要求
|
||||||
|
|
||||||
|
根据收集的信息类型，可能需要以下权限：
|
||||||
|
|
||||||
|
```xml
|
||||||
|
<!-- 必需权限 -->
|
||||||
|
<uses-permission android:name="android.permission.INTERNET" />
|
||||||
|
|
||||||
|
<!-- 可选权限（用于获取更多信息） -->
|
||||||
|
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
|
||||||
|
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
|
||||||
|
<uses-permission android:name="android.permission.BLUETOOTH" />
|
||||||
|
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
|
||||||
|
<uses-permission android:name="android.permission.CAMERA" />
|
||||||
|
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
|
||||||
|
```
|
||||||
|
|
||||||
|
## 性能优化
|
||||||
|
|
||||||
|
### 1. 并发收集
|
||||||
|
所有信息收集都是并发执行：
|
||||||
|
```kotlin
|
||||||
|
// 使用协程并发收集
|
||||||
|
val cpuInfoDeferred = async { collectCpuInfo() }
|
||||||
|
val gpuInfoDeferred = async { collectGpuInfo() }
|
||||||
|
// ... 其他信息并发收集
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. 异常处理
|
||||||
|
每个收集方法都有完善的异常处理：
|
||||||
|
```kotlin
|
||||||
|
private suspend fun collectCpuInfo(): String = withContext(Dispatchers.Default) {
|
||||||
|
try {
|
||||||
|
// 收集逻辑
|
||||||
|
} catch (e: Exception) {
|
||||||
|
"{}" // 返回空JSON对象
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. 线程调度
|
||||||
|
- 信息收集：使用 `Dispatchers.Default` 或 `Dispatchers.IO`
|
||||||
|
- 加密操作：使用 `Dispatchers.Default`
|
||||||
|
- 网络请求：使用 `Dispatchers.IO`
|
||||||
|
|
||||||
|
## 错误处理
|
||||||
|
|
||||||
|
### 常见错误及解决方案
|
||||||
|
|
||||||
|
1. **网络错误**
|
||||||
|
```kotlin
|
||||||
|
// 错误: java.net.UnknownHostException
|
||||||
|
// 解决: 检查网络连接和URL是否正确
|
||||||
|
```
|
||||||
|
|
||||||
|
2. **加密错误**
|
||||||
|
```kotlin
|
||||||
|
// 错误: 加密失败
|
||||||
|
// 解决: 检查密钥长度是否为16/24/32字节
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **序列化错误**
|
||||||
|
```kotlin
|
||||||
|
// 错误: JSON解析失败
|
||||||
|
// 解决: 确保所有收集方法返回有效的JSON字符串
|
||||||
|
```
|
||||||
|
|
||||||
|
## 注意事项
|
||||||
|
|
||||||
|
1. **隐私合规**：
|
||||||
|
- 确保用户知情并同意收集设备信息
|
||||||
|
- 遵守 GDPR、CCPA 等隐私法规
|
||||||
|
- 在隐私政策中说明数据用途
|
||||||
|
|
||||||
|
2. **网络使用**：
|
||||||
|
- 建议在 WiFi 环境下上传
|
||||||
|
- 可以添加网络类型检测
|
||||||
|
|
||||||
|
3. **频率控制**：
|
||||||
|
- 不要频繁上传
|
||||||
|
- 建议每天或每周上传一次
|
||||||
|
|
||||||
|
4. **错误重试**：
|
||||||
|
- 失败时可以实现重试机制
|
||||||
|
- 保存失败的数据，下次再试
|
||||||
|
|
||||||
|
## 完整示例
|
||||||
|
|
||||||
|
```kotlin
|
||||||
|
class DeviceCheckActivity : AppCompatActivity() {
|
||||||
|
|
||||||
|
override fun onCreate(savedInstanceState: Bundle?) {
|
||||||
|
super.onCreate(savedInstanceState)
|
||||||
|
setContentView(R.layout.activity_device_check)
|
||||||
|
|
||||||
|
// 初始化
|
||||||
|
AndInfo.init(applicationContext)
|
||||||
|
|
||||||
|
// 检查权限后上传
|
||||||
|
if (checkPermissions()) {
|
||||||
|
uploadDeviceInfo()
|
||||||
|
} else {
|
||||||
|
requestPermissions()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun uploadDeviceInfo() {
|
||||||
|
lifecycleScope.launch {
|
||||||
|
try {
|
||||||
|
val collector = DeviceInfoCollector(applicationContext)
|
||||||
|
|
||||||
|
// 显示加载对话框
|
||||||
|
val dialog = ProgressDialog(this@DeviceCheckActivity)
|
||||||
|
dialog.setMessage("正在收集设备信息...")
|
||||||
|
dialog.show()
|
||||||
|
|
||||||
|
collector.collectAndUpload { message, error ->
|
||||||
|
runOnUiThread {
|
||||||
|
dialog.dismiss()
|
||||||
|
|
||||||
|
if (error != null) {
|
||||||
|
showErrorDialog(error.message ?: "上传失败")
|
||||||
|
} else {
|
||||||
|
showSuccessDialog(message ?: "上传成功")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (e: Exception) {
|
||||||
|
runOnUiThread {
|
||||||
|
showErrorDialog("发生错误: ${e.message}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun showSuccessDialog(message: String) {
|
||||||
|
AlertDialog.Builder(this)
|
||||||
|
.setTitle("成功")
|
||||||
|
.setMessage(message)
|
||||||
|
.setPositiveButton("确定", null)
|
||||||
|
.show()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun showErrorDialog(message: String) {
|
||||||
|
AlertDialog.Builder(this)
|
||||||
|
.setTitle("失败")
|
||||||
|
.setMessage(message)
|
||||||
|
.setPositiveButton("确定", null)
|
||||||
|
.setNegativeButton("重试") { _, _ ->
|
||||||
|
uploadDeviceInfo()
|
||||||
|
}
|
||||||
|
.show()
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun checkPermissions(): Boolean {
|
||||||
|
// 检查必要权限
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun requestPermissions() {
|
||||||
|
// 请求权限
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 总结
|
||||||
|
|
||||||
|
本功能提供了完整的设备信息收集和上传解决方案：
|
||||||
|
- ✅ 异步并发收集，性能优化
|
||||||
|
- ✅ 完整的24类设备信息
|
||||||
|
- ✅ AES 加密保护数据
|
||||||
|
- ✅ 完善的错误处理
|
||||||
|
- ✅ 简单易用的 API
|
||||||
|
- ✅ 详细的中文注释
|
||||||
|
|
||||||
Loading…
Reference in New Issue
Block a user