# filebrower

**Repository Path**: bill_hu1971/filebrower

## Basic Information

- **Project Name**: filebrower
- **Description**: 基于 HarmonyOS (ArkTS) 的文件浏览器应用，支持浏览设备目录、查看文件信息、选择文件并复制到应用沙箱目录。方便在Deveco Studio里把文件复制到PC
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-16
- **Last Updated**: 2026-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FileBrowser

基于 HarmonyOS (ArkTS) 的文件浏览器应用，支持浏览设备目录、查看文件信息、选择文件并复制到应用沙箱目录。

## 功能特性

- **目录浏览** — 以列表形式展示当前目录下的文件和子目录，目录在前、文件在后按名称排序
- **目录导航** — 点击目录进入子目录，支持返回上级目录
- **文件信息** — 显示文件名称、大小（自动换算 B/KB/MB/GB）和修改时间
- **文件选择** — 点击或长按选中文件，高亮显示选中状态
- **文件复制** — 将选中文件复制到应用沙箱目录，目标文件已存在时弹出覆盖确认对话框

## 项目信息

| 项目 | 说明 |
|------|------|
| 包名 | com.example.filebrowser |
| 版本 | 1.0.0 |
| 兼容 SDK | 5.0.0(12) |
| 目标 SDK | 6.1.1(24) |
| 设备类型 | phone, tablet |
| 开发语言 | ArkTS |

## 核心依赖

- `@kit.CoreFileKit` — 文件目录列表 (`fileIo.listFileSync`)、文件信息获取 (`fileIo.statSync`)、文件复制 (`fileIo.copyFileSync`)、文件存在检查 (`fileIo.accessSync`)
- `@kit.ArkUI` — Toast 提示与对话框 (`promptAction`)

## 项目结构

```
entry/src/main/
├── ets/
│   ├── entryability/
│   │   └── EntryAbility.ets      # Ability 入口
│   └── pages/
│       └── Index.ets             # 主页面（目录浏览与文件操作）
├── resources/                    # 资源文件
└── module.json5                  # 模块配置与权限声明
```

## 权限

| 权限 | 用途 |
|------|------|
| ohos.permission.READ_MEDIA | 读取设备媒体文件 |

## 沙箱目录

文件复制目标路径为应用沙箱目录：

- **应用沙箱路径**：`/data/storage/el2/base/files`
- **Device File Explorer 物理路径**：`data/app/el2/100/base/com.example.filebrowser/files/`

## 构建与运行

1. 使用 DevEco Studio 打开项目
2. 配置签名（build-profile.json5 → signingConfigs）
3. 连接设备或启动模拟器
4. 执行 Build → Run

## 使用说明

1. 启动应用后自动加载用户目录 `/storage/Users/currentUser`
2. 点击目录项进入子目录，点击"返回上级"返回父目录
3. 点击文件项选中文件（选中项高亮显示）
4. 选中文件后，底部出现操作栏，点击"复制文件"将文件复制到沙箱目录
5. 若沙箱中已存在同名文件，弹出对话框确认是否覆盖