Repository navigation
BKDeviceMonitor v1.4.0
本次公开版本包含自 v1.2.1 以来的两项主要功能：设备文件浏览与下载、本地 APK 安装。三个平台安装包均在本机完成构建，未使用 GitHub Actions。
新增：设备文件与下载
- 侧栏「设备文件」提供内部存储、下载、相机照片、截图、文档等快捷入口，支持路径跳转、返回上级、排序、筛选和显示隐藏项。
- 支持多选文件与整个文件夹下载，通过系统对话框选择电脑保存位置。
- 显示实际写入字节、速率和任务结果，支持取消、界面刷新后恢复任务，以及打开所在文件夹。
- 下载先写入临时目录，大小校验后保存为正式文件；同名自动编号，不覆盖已有内容，失败或取消会清理临时文件。
- 只读浏览
/sdcard共享存储，支持/storage/emulated/0路径别名。文件夹下载包含隐藏普通文件，跳过符号链接及特殊文件；受限目录明确提示权限问题。
新增：安装 APK
- 通过原生文件选择器选择独立 APK，明确指定已授权设备，使用
adb install -r保留数据覆盖更新。 - 后台安装状态在收起面板、切换页面或刷新后继续保留。
- 对签名冲突、版本降级、存储不足、设备未授权等常见情况提供对应提示与 ADB 详情。
- 不自动卸载旧应用、强制降级或授予全部运行时权限；不支持
.aab、.apks或拆分 APK 集合。
下载与使用
| 电脑平台 | 附件 |
|---|---|
| Mac · Apple Silicon（M 系列） | BKDeviceMonitor-1.4.0-mac-arm64.zip |
| Mac · Intel | BKDeviceMonitor-1.4.0-mac-x64.zip |
| Windows 11 · x64 | BKDeviceMonitor-1.4.0-win-x64.zip |
Mac 解压后将 BKDeviceMonitor.app 放入「应用程序」。Windows 请解压完整目录后运行 BKDeviceMonitor.exe，保留相邻的 resources 和 DLL。开启手机 USB 调试并允许此电脑连接。应用内置 Electron 与 ADB，使用无需 Node.js、Android Studio 或单独后端。附件 SHA256SUMS.txt 提供三个 ZIP 的 SHA-256 校验值。
验证与限制
- 52 项自动化测试通过，覆盖性能统计、APK 安装、文件下载、同名冲突、权限不足、断线、取消与退出清理。
- macOS ARM64 已连接小米 11 Ultra 验证目录浏览及文件下载（实机下载验证使用零字节
.nomedia系统标记）；APK 安装链路经模拟 ADB 验证。 - macOS Intel 与 Windows 为本地交叉构建，尚未在对应机器实测。macOS 包仅作 ad-hoc 签名，未经 Apple 公证；Windows 包没有开发者证书签名。
- 文件下载每次运行一个批次，最多选择 200 项、扫描 20,000 项 / 64 层。正式保存阶段不可取消；任务不支持断点续传，记录仅保留本次运行最近 20 条。
- 文件操作和 APK 安装仅在桌面版提供。界面当前为简体中文，项目文档提供中英文版本。原创代码采用 MIT，第三方组件保留上游许可与 NOTICE。
English
This release includes both major additions since v1.2.1: device file browsing and downloads, and local APK installation. All three packages were built locally, without GitHub Actions.
Highlights
- Browse internal shared storage, use folder shortcuts and path navigation, filter / sort entries, and show hidden files.
- Download multiple files or whole folders to a native-selected destination. Track actual byte progress, speed, cancellation, and results. Tasks survive UI reloads. Downloads are staged, size-checked, and automatically numbered when names collide.
- Install standalone APKs on an explicitly selected authorized device with
adb install -r. Background status and actionable errors cover signatures, downgrades, storage, and connection issues. No automatic uninstall, forced downgrade, or blanket runtime permission grants.
Packages
Choose mac-arm64 for Apple Silicon, mac-x64 for Intel Macs, or win-x64 for Windows 11. On Mac, extract and move the app to Applications. On Windows, extract the complete archive and keep resources / DLLs alongside the executable. Enable USB debugging and authorize your computer on the phone. Electron and ADB are bundled. Verify ZIP packages with SHA256SUMS.txt.
Validation and limits
All 52 automated tests passed. macOS ARM64 was tested with a Mi 11 Ultra for directory browsing and a zero-byte .nomedia marker download; APK installation was verified with mock ADB. Intel Mac and Windows builds are cross-built and have not been tested on matching hardware. macOS builds are ad-hoc signed, not notarized; Windows builds have no developer certificate signature.
File browsing is limited to shared storage (/sdcard and its /storage/emulated/0 alias). Permission-restricted directories report errors; symbolic links and special files are skipped in folder downloads. One batch runs at a time, with at most 200 selected roots, 20,000 scanned entries, and 64 levels. Final publication cannot be cancelled. Transfers are not resumable; the latest 20 task records remain in memory for this app run.
APK installation supports standalone APKs, not AAB / APKS or split sets. File operations and installation are desktop-only. The UI uses Simplified Chinese; documentation is bilingual. Original code is MIT licensed; third-party components retain their upstream licenses and notices.