10344e0b05
ControlSchema.ControlItem: - 新增 semantic / grp / isPrimary / enumLabels 字段 - 拆分隐式 key() 为显式 dpKey()(涂鸦 publishDps 用数字dpId) 与 codeKey()(平台无关稳定标识, 场景规则/Mesh/云端用) 原实现两条链路口径不一致(一处dpId一处code), 极易用错 DeviceControlActivity: - 4 处 it.key() -> it.dpKey()(publishDps 路径) - 主开关选择新增物模型兜底: 后端 mainSwitchCode -> is_primary -> semantic=power (语义由后端 SpecSemanticResolver 落库, 取代客户端按名称猜测) 新增 SpecSwitchResolver: - 物模型驱动的开关通道解析器 - 通道来源 = control-schema 中 grp=switch 的功能点(即物模型 switch 组) - 物模型不可用(设备无产品/未同步/网络失败)返回 null -> 调用方回退本地打分 - 保证离线与新设备场景不降级 DeviceRowAdapter: - 新增物模型通道缓存(setSpecChannels), 回填后按设备局部刷新(不整表重绘) - 统一内部 SwChannel 视图, 屏蔽物模型/本地打分两种来源差异 - 通道解析优先级: 后端物模型 > 本地打分兜底 DevicesFragment: - 首次加载后异步拉取各设备 control-schema, 解析开关通道回填 adapter - 通道属静态数据, 只拉一次, 避免每次刷新发 N 个请求 SceneDetailActivity: - 规则下发的动作 key 改用 codeKey(), 并注释说明与 publishDps 的区别 验证: javac 编译 ControlSchema + SpecSwitchResolver 通过(两者不依赖 Android SDK); 其余改动为结构性替换, 待 Android Studio 编译验证
XHai 智能物联 - Android 客户端
基于涂鸦 Thing Smart Home SDK 7.5.0 原生开发的 Android 客户端。 实现：用户登录（iotsaas 后端）+ 涂鸦账号绑定/授权。
一、功能范围（当前阶段）
| 功能 | 状态 | 说明 |
|---|---|---|
| 用户登录 | ✅ | 对接 iotsaas 后端 POST /api/v1/auth/member/login |
| 用户注册 | ✅ | 对接 POST /api/v1/auth/member/register |
| 涂鸦账号绑定 | ✅ | 涂鸦原生 SDK 登录，绑定后同步 tuya_user_binding |
| 涂鸦账号解绑 | ✅ | 对接 POST /api/v1/tuya/auth/unbind |
| 绑定状态查询 | ✅ | 对接 GET /api/v1/tuya/auth/status |
| 设备管理/控制 | ⏳ | 走通绑定后再开发 |
二、环境要求
- Android Studio（Hedgehog 或更新版本）
- JDK 17（涂鸦 SDK 需要）
- Android SDK（API 34）
- NDK（
arm64-v8a、armeabi-v7a）
三、涂鸦平台配置（必须完成）
⚠️ 关键：涂鸦 SDK 初始化要求
AppKey、AppSecret、包名、签名 keystore 的 SHA256 四项全部与涂鸦平台登记一致，否则报illegal client。
1. 确认 App 授权信息
登录 涂鸦开发者平台 → 云开发 → 你的项目 → App 授权：
- AppKey（Client ID）：
wuvw788psccvxndpyxnv - AppSecret（Client Secret）：需确认
- 包名：
com.xhai.iot
2. 配置签名证书 SHA256
涂鸦 SDK 校验应用签名。必须把打包用 keystore 的 SHA256 配置到涂鸦平台对应 App 的"Android 签名证书"里。
本项目已生成开发用 keystore：app/xhai_iot.jks（密码 xhai123456，alias xhai）
- SHA256：
F0:D1:85:41:CD:D2:21:E2:84:77:FF:E1:A4:CF:F7:19:41:D4:8A:BD:B7:77:83:F2:C0:DB:CE:FB:69:25:F6:13 - SHA1（涂鸦 identifier 用）：
0C44B4A0C696BC823B5BEFD52B16CFBF7D169B78
⚠️ 注意：涂鸦平台"App授权"里的 identifier（SHA1+包名）必须与打包签名一致。若涂鸦后台已配置了其他 keystore 的 SHA1，请使用那个 keystore 替换
app/xhai_iot.jks，或在涂鸦后台更新 SHA1。
四、构建步骤
方式一：Android Studio（推荐）
- 用 Android Studio 打开
f:/work/iotsaas/Android文件夹 - Android Studio 会自动下载 Gradle、AGP、涂鸦 SDK 依赖（需网络）
- 等待首次 Gradle Sync 完成
- 连接手机，点击 Run
方式二：命令行
cd Android
gradle assembleDebug
五、关键配置文件
| 文件 | 作用 |
|---|---|
app/build.gradle |
依赖、签名、ABI 配置 |
app/src/main/AndroidManifest.xml |
AppKey/AppSecret、Activity 注册 |
app/src/main/java/.../data/ApiConfig.java |
后端地址、涂鸦密钥 |
app/src/main/java/.../TuyaApplication.java |
涂鸦 SDK 初始化 |
app/src/main/java/.../ui/TuyaBindActivity.java |
涂鸦登录+绑定 |
六、API 对接（iotsaas 后端）
| 后端接口 | 方法 | 作用 |
|---|---|---|
/api/v1/auth/member/login |
POST | 登录 |
/api/v1/auth/member/register |
POST | 注册 |
/api/v1/tuya/auth/status |
GET | 涂鸦绑定状态 |
/api/v1/tuya/auth/bind-native |
POST | 绑定同步 |
/api/v1/tuya/auth/unbind |
POST | 解绑 |
所有涂鸦接口需要
Authorization: Bearer <token>头。
七、常见问题
Q1: 启动报 illegal client
检查 AppKey/AppSecret/包名/keystore SHA256 四项与涂鸦平台是否一致。
Q2: 绑定同步失败
检查后端是否已登录（token 有效）、tuya_user_binding 是否写入。
Q3: 涂鸦登录失败
确认涂鸦账号存在、网络正常、SDK 已初始化成功。