SandboxFinder:HarmonyOS沙箱文件浏览器,便捷管理应用文件
SandboxFinder是一款专为HarmonyOS应用开发者设计的沙箱文件浏览器,通过Web界面访问应用沙箱目录,提供高效便捷的文件管理方式,助力开发者提升调试效率。
SandboxFinder简介
SandboxFinder是一款专为HarmonyOS应用开发者打造的沙箱文件浏览器,它通过内置的HTTP服务器提供Web界面访问应用沙箱目录,使得开发者能够直观、高效地管理应用沙箱目录。
查看SandboxFinder截图
SandboxFinder核心功能
沙箱文件系统
- 内置基于TCP Socket的轻量级HTTP服务器,启动后即提供文件浏览服务。
- 默认监听7777端口,可按需自定义。
- 支持模拟器与真机,方便联调与测试。
- 自动识别文本、图片、音视频与SQLite数据库等多种文件类型。
Web界面
- 前端采用Vue 3 + Tailwind CSS,界面自适应不同分辨率。
- 提供目录快捷入口(filesDir、cacheDir、tempDir、databaseDir等),点击即跳转。
- 支持名称、大小、时间多维排序,以及实时关键字搜索。
- 内嵌预览组件,可直接查看文本、图片、视频、音频与数据库表。
文件操作
- 新建、删除、重命名等基础操作一应俱全。
- 大文件分块、拖放、多选上传,稳定处理GB级文件。
- 直链下载,适合自动化脚本或浏览器直接保存。
沙箱目录速查
HarmonyOS将应用数据隔离在filesDir、cacheDir、tempDir、databaseDir等路径,确保存储安全且互不干扰。这些目录均可通过SandboxFinder快捷访问,便于日志抓取、数据库调试与临时文件清理。

SandboxFinder快速上手
- 在项目根目录执行
ohpm install @cxy/sandboxfinder并同步依赖。 - 调用
SandboxFinder.run(),默认即可启动7777端口服务;如需修改,传入自定义端口号。 - 确保手机与电脑在同一Wi-Fi,浏览器访问
http://设备IP:端口即可。
SandboxFinder适用场景与优势
- 调试:无需hdc拉文件,浏览器即看即改,缩短排查耗时。
- 演示:在团队分享或课堂教学中,通过URL直接展示应用沙箱结构,提高讲解效率。
- 自动化:结合直链下载,可用脚本定时同步日志或数据库,便于持续集成。
通过以上特性,SandboxFinder成为HarmonyOS开发环境下的高效文件管理利器,帮助开发者专注业务而非繁琐的设备文件操作。
SandboxFinder如何使用/项目地址
GitHub地址:SandboxFinder GitHub地址