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 验证连接

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

解决：

恢复出厂设置
不要登录任何账号
重新运行脚本

Q2: APK 安装失败

错误信息：INSTALL_FAILED_...

解决：

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

Q3: 看不到日志

原因：应用未启动或日志过滤不正确

解决：

手动启动应用
使用"启动应用并查看日志.bat"
或手动执行：adb logcat | findstr "MyApplication"

Q4: 应用卡死无法退出

解决方法：

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

方法 2：使用脚本

运行：移除DeviceOwner.bat

方法 3：手动命令

adb shell am task lock stop
adb shell am force-stop com.YuyeTech.HeartRate

🔧 手动命令参考

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

安装 APK

adb install -r app\build\outputs\apk\app_bbeng\release\app_bbeng_v2.0.8_26010903_2026-01-23.apk

设置 Device Owner

adb shell dpm set-device-owner com.YuyeTech.HeartRate/com.ble.mylockview.admin.KioskDeviceAdminReceiver

启动应用

adb shell am start -n com.YuyeTech.HeartRate/io.dcloud.PandoraEntry

查看日志

adb logcat | findstr "MyApplication KioskHelper KioskManager"

退出 Kiosk

adb shell am task lock stop

移除 Device Owner

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）
修改默认密码
准备应急恢复方案
保留至少一台测试设备

📞 技术支持

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

运行的脚本名称
完整的错误信息
设备型号和 Android 版本
adb devices 的输出
adb shell dumpsys device_policy 的输出

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

README_BAT脚本使用说明.md 7.2 KB История Директен файл