SandboxFinder简介

SandboxFinder是一个

专为 HarmonyOS 应用开发者设计的

沙箱文件浏览器


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


SandboxFinder核心功能


沙箱文件系统

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


Web 界面

  • 前端采用 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