鸿蒙沙箱浏览器 - SandboxFinder

快速访问鸿蒙应用沙箱目录，支持沙箱文件预览、下载、上传、删除、搜索。

核心特性

沙箱文件系统

• 内置 HTTP 服务器 - 基于 TCP Socket 实现的轻量级 HTTP 服务器
• 多设备 - 支持模拟器和真机
• 文件类型识别 - 智能识别文本、图片、视频、音频、SQLite 数据库等文件类型
• 自定义端口 - 默认端口7777

Web 界面访问

• 响应式 Web UI - 使用 Vue 3 + Tailwind CSS 构建的现代化界面
• 快速访问 - 提供便捷的沙箱目录访问（filesDir、cacheDir、tempDir、databaseDir 等）
• 预览 - 支持文本、图片、视频、音频、SQLite 数据库预览
• 排序 - 支持按名称、大小、时间排序
• 搜索 - 实时关键字搜索

文件操作功能

• 基础文件操作 - 创建、删除、重命名
• 文件上传 - 支持大文件分块、批量、拖放上传
• 下载 - 直链下载

快速开始

集成到项目

1. 安装

ohpm install @cxy/sandboxfinder

或 添加依赖，然后同步

// oh-package.json5
{
  "dependencies": {
    "@cxy/sandboxfinder": "^1.0.5"
  }
}

2. 导入并启动

// 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 (换成你的IP)

模拟器使用

沙箱浏览器开启后，模拟器需转发端口，才能访问。

# 查看模拟器设备
> hdc list targets   # 输出: 127.0.0.1:5555

# 转发端口 fport tcp:<localPort> tcp:<serverPort>
hdc -t 127.0.0.1:5555 fport tcp:7777 tcp:7777   

# 输出: Forwardport result:OK 表示成功

转发成功后，访问： http://127.0.0.1:7777 , 如果无法访问，关闭网络代理工具试试看。

使用 hdc 时如出现异常，可通过 hdc kill -r 命令终止异常进程并重启hdc服务。

SandboxFinder 类说明

1、SandboxFinder 提供了两个对外静态方法：

/**
 * 运行服务
 * @param port  端口号，默认7777
 * @param context UIAbilityContext, 默认 getContext()
 * @returns socket.NetAddress =》 { address: string , port: number }
 */
static async run(port: number = 7777,
  context: common.UIAbilityContext = getContext() as common.UIAbilityContext): Promise<socket.NetAddress>;
    
    
 /**
 * 停止服务
 */
static async stop();

2、查看 serverInfo

// EntryAbility.ets  - onWindowStageCreate()
import('@cxy/sandboxfinder').then(async (ns: ESObject) => {
  // 绑定到端口 6666, 使用 this.context
  ns.SandboxFinder.run(6666, this.context).then((serverInfo: ESObject) => {
    console.log(JSON.stringify(serverInfo))
  })
});

如果是使用过程中有什么问题，欢迎提 issues

作者

@仙银

鸿蒙开源作品，欢迎持续关注 🌟Star ，💖赞助

1、hpack - 鸿蒙 HarmonyOS 一键打包上传分发测试工具。

2、Open-in-DevEco-Studio - macOS 直接在 Finder 工具栏上，使用 DevEco-Studio 打开鸿蒙工程。

3、cxy-theme - DevEco-Studio 绿色护眼背景主题。

4、harmony-udid-tool - 简单易用的 HarmonyOS 设备 UDID 获取工具，适用于非开发人员。

5、SandboxFinder - 鸿蒙沙箱文件浏览器，支持模拟器和真机。快速访问沙箱目录。

6、WebServer - 鸿蒙轻量级Web服务器框架，类 Express.js API 风格，支持中间件，路由，静态服务。

7、SelectableMenu - 适用于聊天对话框中的文本选择菜单

8、RefreshList - 功能完善的上拉下拉加载组件，支持各种自定义。