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开发生态中的实用工具,该工具能够显著提升开发者的工作效率,是鸿蒙应用开发不可或缺的调试助手。