# 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 版本**: 完整版

