胖鹅爱分享

SandboxFinder简介

SandboxFinder是一个专为 HarmonyOS 应用开发者设计的沙箱文件浏览器，通过内置 HTTP 服务器提供 Web 界面访问应用沙箱目录。专为 HarmonyOS 应用开发者打造，提供一种直观、高效的方式来访问和管理应用沙箱目录。通过内置的轻量级 HTTP 服务器，开发者可以在任意设备（模拟器或真机）上，使用浏览器快速浏览和操作应用内部文件，显著提升调试效率。

SandboxFinder核心功能

• 内置基于 TCP Socket 的轻量级 HTTP 服务器，启动后即提供文件浏览服务。
• 默认监听 7777 端口，可按需自定义。
• 支持模拟器与真机，方便联调与测试。
• 自动识别文本、图片、音视频与 SQLite 数据库等多种文件类型。

• 前端采用 Vue 3 + Tailwind CSS，界面自适应不同分辨率。
• 提供目录快捷入口（filesDir、cacheDir、tempDir、databaseDir 等），点击即跳转。
• 支持名称、大小、时间多维排序，以及实时关键字搜索。
• 内嵌预览组件，可直接查看文本、图片、视频、音频与数据库表。

• 新建、删除、重命名等基础操作一应俱全。
• 大文件分块、拖放、多选上传，稳定处理 GB 级文件。
• 直链下载，适合自动化脚本或浏览器直接保存。

沙箱目录速查

HarmonyOS 将应用数据隔离在 filesDir、cacheDir、tempDir、databaseDir 等路径，确保存储安全且互不干扰。这些目录均可通过 SandboxFinder 快捷访问，便于日志抓取、数据库调试与临时文件清理。

SandboxFinder快速上手

1. 在项目根目录执行 ohpm install @cxy/sandboxfinder并同步依赖。
2. 调用 SandboxFinder.run()，默认即可启动 7777 端口服务；如需修改，传入自定义端口号。
3. 确保手机与电脑在同一 Wi-Fi，浏览器访问 http://设备IP:端口即可。

SandboxFinder适用场景与优势

• 调试：无需 hdc 拉文件，浏览器即看即改，缩短排查耗时。
• 演示：在团队分享或课堂教学中，通过 URL 直接展示应用沙箱结构，提高讲解效率。
• 自动化：结合直链下载，可用脚本定时同步日志或数据库，便于持续集成。

通过以上特性，SandboxFinder 成为 HarmonyOS 开发环境下的高效文件管理利器，帮助开发者专注业务而非繁琐的设备文件操作。

SandboxFinder如何使用/项目地址

GitHub地址：https://github.com/iHongRen/SandboxFinder