# BAT 脚本使用说明

## 📦 脚本列表

### 1. 安装并配置Kiosk模式.bat ⭐⭐⭐⭐⭐
**用途**：一键安装 APK 并配置 Device Owner

**功能**：
- ✅ 检查 ADB 连接
- ✅ 卸载旧版本
- ✅ 安装新版本 APK
- ✅ 设置为 Device Owner
- ✅ 验证配置

**使用场景**：首次部署或更新应用

**前置条件**：
- 设备已恢复出厂设置
- 设备未添加任何账号
- 已启用 USB 调试

---

### 2. 启动应用并查看日志.bat ⭐⭐⭐⭐
**用途**：启动应用并实时查看 Kiosk 初始化日志

**功能**：
- ✅ 清空日志缓存
- ✅ 启动应用
- ✅ 实时显示 Kiosk 相关日志

**使用场景**：验证 Kiosk 自动初始化是否成功

**期望日志**：
```
D MyApplication: Application 初始化
D MyApplication: ✅ 绑定 Kiosk 到: PandoraEntry
D KioskHelper: ✅ 锁屏已禁用
D KioskHelper: ✅ 屏幕保持常亮
D KioskManager: ✅ LockTask 启用
```

---

### 3. 测试Kiosk功能.bat ⭐⭐⭐⭐
**用途**：全面测试 Kiosk 功能是否正确配置

**功能**：
- ✅ 检查应用安装状态
- ✅ 检查 Device Owner 状态
- ✅ 检查 MyApplication 配置
- ✅ 检查 BootReceiver 注册
- ✅ 检查 KioskDeviceAdminReceiver 注册
- ✅ 启动应用并捕获日志

**使用场景**：部署后验证功能

---

### 4. 移除DeviceOwner.bat ⭐⭐⭐
**用途**：移除 Device Owner 模式（应急使用）

**功能**：
- ✅ 退出 LockTask 模式
- ✅ 移除 Device Owner 权限

**使用场景**：
- 需要卸载应用
- 需要恢复正常模式
- 应急退出 Kiosk

**注意**：移除后将失去完整的 Kiosk 功能

---

### 5. 恢复出厂设置准备.bat ⭐⭐⭐
**用途**：检查设备状态，准备设置 Device Owner

**功能**：
- ✅ 检查当前 Device Owner 状态
- ✅ 检查账号状态
- ✅ 检查系统管理员

**使用场景**：设置 Device Owner 前的准备工作

---

## 🚀 快速开始

### 场景 1：首次部署（全新设备）

```
1. 恢复出厂设置准备.bat  （检查设备状态）
2. 安装并配置Kiosk模式.bat  （安装并配置）
3. 测试Kiosk功能.bat       （验证功能）
4. 启动应用并查看日志.bat   （查看实时日志）
```

### 场景 2：更新应用

```
1. 安装并配置Kiosk模式.bat  （会自动卸载旧版本）
2. 启动应用并查看日志.bat   （验证更新成功）
```

### 场景 3：测试验证

```
1. 测试Kiosk功能.bat       （全面测试）
2. 启动应用并查看日志.bat   （查看日志）
```

### 场景 4：应急退出

```
1. 移除DeviceOwner.bat     （移除 Device Owner）
```

---

## 📋 详细使用步骤

### 步骤 1：准备设备

#### 1.1 恢复出厂设置
- 设置 → 系统 → 重置 → 恢复出厂设置
- **重要**：不要登录任何账号！

#### 1.2 启用 USB 调试
- 设置 → 关于手机 → 连续点击版本号 7 次
- 设置 → 开发者选项 → USB 调试（开启）

#### 1.3 连接电脑
- 用 USB 线连接设备和电脑
- 设备上点击"允许 USB 调试"

#### 1.4 验证连接
```bash
adb devices
# 应该显示设备序列号
```

---

### 步骤 2：运行安装脚本

双击运行：**安装并配置Kiosk模式.bat**

脚本会自动执行以下操作：

```
[步骤 1/6] 检查 ADB 连接...
[步骤 2/6] 检查 APK 文件...
[步骤 3/6] 卸载旧版本...
[步骤 4/6] 安装新版本...
[步骤 5/6] 设置为 Device Owner...
[步骤 6/6] 验证配置...
```

---

### 步骤 3：验证功能

双击运行：**测试Kiosk功能.bat**

检查输出中是否包含：
```
✅ 应用已安装
✅ Device Owner: com.YuyeTech.HeartRate
✅ MyApplication: ✅ 绑定 Kiosk 到: PandoraEntry
```

---

### 步骤 4：查看实时日志

双击运行：**启动应用并查看日志.bat**

观察日志输出，确认看到：
```
D MyApplication: ✅ 绑定 Kiosk 到: PandoraEntry
D KioskHelper: ✅ 锁屏已禁用
D KioskHelper: ✅ 屏幕保持常亮
D KioskManager: ✅ LockTask 启用
```

---

## ⚠️ 常见问题

### Q1: Device Owner 设置失败
**错误信息**：`Not allowed to set the device owner...`

**原因**：
- 设备已有账号
- 设备未恢复出厂设置
- 已有其他 Device Owner

**解决**：
1. 恢复出厂设置
2. 不要登录任何账号
3. 重新运行脚本

---

### Q2: APK 安装失败
**错误信息**：`INSTALL_FAILED_...`

**解决**：
1. 检查 APK 文件路径是否正确
2. 手动卸载旧版本：`adb uninstall com.YuyeTech.HeartRate`
3. 重新运行脚本

---

### Q3: 看不到日志
**原因**：应用未启动或日志过滤不正确

**解决**：
1. 手动启动应用
2. 使用"启动应用并查看日志.bat"
3. 或手动执行：`adb logcat | findstr "MyApplication"`

---

### Q4: 应用卡死无法退出
**解决方法**：

**方法 1**：五指长按 5 秒 + 密码 9527

**方法 2**：使用脚本
```
运行：移除DeviceOwner.bat
```

**方法 3**：手动命令
```bash
adb shell am task lock stop
adb shell am force-stop com.YuyeTech.HeartRate
```

---

## 🔧 手动命令参考

如果脚本无法运行，可以手动执行以下命令：

### 安装 APK
```bash
adb install -r app\build\outputs\apk\app_bbeng\release\app_bbeng_v2.0.8_26010903_2026-01-23.apk
```

### 设置 Device Owner
```bash
adb shell dpm set-device-owner com.YuyeTech.HeartRate/com.ble.mylockview.admin.KioskDeviceAdminReceiver
```

### 启动应用
```bash
adb shell am start -n com.YuyeTech.HeartRate/io.dcloud.PandoraEntry
```

### 查看日志
```bash
adb logcat | findstr "MyApplication KioskHelper KioskManager"
```

### 退出 Kiosk
```bash
adb shell am task lock stop
```

### 移除 Device Owner
```bash
adb shell dpm remove-active-admin com.YuyeTech.HeartRate/com.ble.mylockview.admin.KioskDeviceAdminReceiver
```

---

## 📊 功能验证清单

部署完成后，请验证以下功能：

### 基础功能
- [ ] 应用已安装
- [ ] Device Owner 已设置
- [ ] 应用可以正常启动

### Kiosk 功能
- [ ] 应用启动时自动进入全屏
- [ ] 状态栏和导航栏自动隐藏
- [ ] 屏幕保持常亮不熄灭
- [ ] 按 Home 键无法退出应用
- [ ] 按 Back 键无法退出应用

### 自动初始化
- [ ] 日志显示 "✅ 绑定 Kiosk 到: PandoraEntry"
- [ ] 日志显示 "✅ 锁屏已禁用"（Device Owner 模式）
- [ ] 日志显示 "✅ 屏幕保持常亮"
- [ ] 日志显示 "✅ LockTask 启用"（Device Owner 模式）

### 开机自启动
- [ ] 重启设备后应用自动启动
- [ ] 自动进入 Kiosk 模式

### 退出机制
- [ ] 五指长按 5 秒能弹出密码框
- [ ] 输入密码 9527 能退出 Kiosk

---

## 🎯 最佳实践

### 开发环境
- 不设置 Device Owner（方便调试）
- 使用 Debug 版本
- 保留 ADB 访问

### 测试环境
- 设置 Device Owner
- 使用 Release 版本
- 测试所有功能

### 生产环境
- 批量配置 Device Owner（NFC/QR Code）
- 修改默认密码
- 准备应急恢复方案
- 保留至少一台测试设备

---

## 📞 技术支持

如遇到问题，请提供以下信息：

1. 运行的脚本名称
2. 完整的错误信息
3. 设备型号和 Android 版本
4. `adb devices` 的输出
5. `adb shell dumpsys device_policy` 的输出

---

**创建时间**：2026-01-22  
**适用版本**：哔蹦健身 v2.0.8  
**APK 文件**：app_bbeng_v2.0.8_26010903_2026-01-23.apk