SandboxFinder(鸿蒙沙箱文件浏览器)简介
SandboxFinder是一款专为HarmonyOS应用开发者打造的鸿蒙沙箱文件浏览器,通过内置的轻量级HTTP服务器,为开发者提供了便捷的Web界面来访问和管理应用沙箱目录,极大地简化了鸿蒙应用开发过程中的文件调试工作。该工具提供了全面的文件管理功能,包括快速访问filesDir、cacheDir、tempDir、databaseDir等关键沙箱目录,支持文件预览、按名称/大小/时间排序以及实时关键字搜索,还支持基础文件操作如创建、删除、重命名,以及强大的文件上传功能,包括大文件分块上传、批量上传和拖放上传。

该工具基于TCP Socket实现了高效的HTTP服务器,支持模拟器和真机双平台使用,具备智能文件类型识别功能,能够准确识别文本、图片、视频、音频和SQLite数据库等多种文件格式,响应式Web界面采用Vue 3和Tailwind CSS构建,为开发者提供了直观的操作体验。
SandboxFinder(鸿蒙沙箱文件浏览器)官网及及安装使用
1、开发者可通过ohpm包管理器轻松安装:
ohpm install @cxy/sandboxfinder或 添加依赖,然后同步
// oh-package.json5
{
  "dependencies": {
    "@cxy/sandboxfinder": "^1.0.0"
  }
}2、在EntryAbility中导入并启动服务:
// EntryAbility.ets
// 导入BuildProfile,编译工程自动生成
import BuildProfile from 'BuildProfile'; 
onWindowStageCreate(windowStage: window.WindowStage): void {
  windowStage.loadContent('pages/Index', (err) => {
    if (err.code) {
      return;
    }
    // 推荐在 DEBUG 模式下使用 - 动态加载
    if (BuildProfile.DEBUG) {
      import('@cxy/sandboxfinder').then(async (ns: ESObject) => {
        // 默认绑定到端口 7777
        ns.SandboxFinder.run()
      });
      // 避免服务挂起,设置不息屏
      windowStage.getMainWindowSync().setWindowKeepScreenOn(true)
    }
  });
}3、确保鸿蒙设备和电脑在同一网络, 获取访问地址: 查看打印log -> 搜索 ‘–‘。
或者直接查看设备IP:设置 -> WLAN -> 已连接的WIFI详情 -> IP地址。
 ----------------------------------------------------------
 
 沙箱浏览器启动成功
 请浏览器访问: http://192.168.2.38:7777
 
 ----------------------------------------------------------4、确保设备与电脑处于同一网络环境,即可通过浏览器访问 http://192.168.2.38:7777 来使用完整功能。
作为HarmonyOS开发生态中的实用工具,该工具能够显著提升开发者的工作效率,是鸿蒙应用开发不可或缺的调试助手。













