访问设备文件

使用场景

• 查看设备上的文件列表及基本信息。
• 在设备上搜索文件及文件夹。
• 在设备上新建、删除文件。
• 从PC本地上传文件到设备上，从设备上下载文件到PC本地。

使用约束

• 已通过USB或Wi-Fi连接设备。
• 不支持访问无权限目录，新建、删除、上传、下载文件受设备权限约束。
• 不支持文件拖拽。
• 不支持文件修改。如需对文件进行修改，需下载至PC，在本地修改后再上传至设备。
• 不支持上传文件或文件夹的快捷方式。
• 应用沙箱视图不支持模拟器设备。
• 应用需为debug应用才可使用沙箱视图查看文件结构、对应用沙箱内的文件/文件夹进行新建、删除、上传或下载操作。

操作步骤

1. 在菜单栏单击View > Tool Windows > Device File Browser，打开Device File Browser。

   

2. 从下拉列表中选择设备（设备需已连接）。
3. 选择设备后，显示文件/文件夹列表，可进行以下操作：
   1. 右键单击目录或文件，进行新建/删除操作。
   2. 右键单击Save As将选定的文件或目录下载到PC上，右键单击Upload将PC上的文件上传到设备指定目录。

      如果需要查看数据库文件，可以通过该方式将数据库文件（路径举例：data > app > el2 > 100 > database >项目名称 > entry > rdb > 数据库文件）下载到PC上，再通过其他工具进行可视化查看。

      说明

      从DevEco Studio 6.0.0 Beta2版本开始，支持使用快捷键Ctrl或Shift+鼠标左键（macOS为Command或Shift+鼠标左键），选中多个文件/目录下载到本地计算机；从DevEco Studio 6.0.2 Beta1版本开始，支持使用快捷键选中多个文件/目录删除。

   3. 焦点在Device File Browser框中，输入字母可以快速进行搜索。
   4. 双击某个文件可在DevEco Studio中将其打开。打开文件会默认下载文件到临时目录（%USER%\AppData\Local\Huawei\DevEcoStudio{版本号}\device-file-browser\{设备名称}\{设备上的文件路径}），关闭文件后，临时文件将被删除。
   5. 如果通过命令行方式上传文件到设备后，需要右键对应文件夹，选择Synchronize后才可以在Device File Browser窗口中显示该文件。

可访问目录

Device File Browser可访问的文件夹有五种类型：应用沙箱目录、一般暂存区目录、日志目录、设备公共目录、媒体库目录。

应用沙箱目录

此目录用于存放应用自身相关的数据、资源文件等，有两种访问方式。

• 普通文件视图

  普通文件视图将按照设备的真实物理路径显示当前设备上的文件结构。

  

  应用沙箱在设备上的物理路径位于/data/app/{el1，el2}/100/{base，database}/{packageName}路径下。

  在普通文件视图下，el1目录下的文件仅具备查看文件目录结构的权限，无法执行新建、删除、上传或下载操作；与el1相比，el2目录下的文件允许下载，但其他操作仍无权限执行。

• 应用沙箱视图

  应用沙箱视图会展示所有debug类型的应用，按照应用的沙箱文件路径显示应用的沙箱文件结构。

  从DevEco Studio 6.1.0 Beta1版本开始，点击即可过滤出当前工程对应的沙箱目录。

  

  API 15以下的版本，当需要以沙箱视图查看应用的文件结构时，需在module.json5文件内配置ohos.permission.INTERNET开启网络权限，卸载并重新安装应用。

  

  对应于物理路径，沙箱路径为/data/storage/{el1，el2}/{base，database}。

  在应用沙箱视图下，el1和el2目录下的文件均支持新建、删除、上传、下载操作。

  从DevEco Studio 6.0.1 Release版本开始，新增云空间目录/data/storage/el2/cloud，具体使用方式请参考端云文件协同。

一般暂存区目录

一般暂存区目录位于/data/local/tmp/路径下，支持新建、删除、上传、下载操作，在DevEco Studio进行调试、测试等操作时，将在此目录下生成相关的文件。

日志目录

应用运行时的日志通过HiLog工具实时输出，此工具的输出缓存区一般为256K，超出大小的历史日志将会以压缩包的形式保存在/data/log/hilog/路径下。

当需要查看历史日志时，需要将此目录下的压缩包文件和数据字典压缩包文件hilog_dict.XXX.zip下载到本地计算机，然后使用hilogtool工具解析出对应的日志原文件。

公共目录

用户的桌面、文档、下载等公共目录位于/storage/media/100/local/files/Docs路径下，支持删除、上传、下载操作。

媒体库目录

从API 22开始，新增媒体库目录/mnt/data/100/media_fuse/Photo，原有的/storage/media/100/local/files/Photo目录变为一个链接，点击后跳转到/mnt/data/100/media_fuse/Photo，支持通过该目录上传、下载、删除图片、视频文件。

特殊目录

设备上存在两个特殊的目录：faultlog目录和图库目录，这两个目录有下载权限，但没有查看权限，Device File Browser中无法显示这两个目录，但其下的文件可以通过hdc命令查看并导出。

faultlog目录

图库目录

图库目录中保存了录屏工具、照相机等系统应用生成的图片、视频文件，可通过以下方式将文件下载到本地计算机。

1. 在图库中查看文件名及后缀，例如a.mp4。

   

2. 查询文件路径，记录为{FilePath}。

   hdc shell mediatool query a.mp4 -u

   • 如果查询的结果中包含uri字段，则返回值第三行对应的文件路径不允许直接下载。

     

     需要再执行如下命令，指定该uri，将文件复制到有下载权限的路径中（如/data/local/tmp）。

     hdc shell mediatool recv file://media/Photo/2/VID_1744944984_000/a.mp4 /data/local/tmp

     命令返回值第二行即为文件路径{FilePath}。

     

   • 如果查询结果不包含uri字段，则返回值第二行即为文件路径{FilePath}。

     

3. 指定上一个步骤中获取到的文件路径{FilePath}，下载文件到本地。

   hdc file recv {FilePath} .\

命令行方式访问应用沙箱

可以通过命令行的方式访问debug应用的沙箱目录。

• 从API 15开始，支持通过hdc工具访问debug应用的沙箱目录，推荐开发者使用此种方式。更多关于命令行工具hdc的说明请参见hdc工具使用指导。
  1. 在设备侧启动应用。

     $ hdc shell aa start -a {abilityName} -b {bundleName}
     start ability successfully.

     • abilityName：应用的ability名称。
     • bundleName：调试应用包名。
  2. 通过命令访问应用沙箱目录，创建目录文件，删除指定目录下的文件。

     $ hdc shell -b {bundleName} ls -lZ -A "./data/storage/el2/base"          // 查看应用沙箱下/el2/base目录文件（返回文件全部信息）
     $ hdc shell -b {bundleName} ls -A "./data/storage/el2/base"          // 查看应用沙箱下/el2/base目录文件（仅返回文件名）
     $ hdc shell -b {bundleName} mkdir -p "./data/storage/el2/base/test"     // 在应用沙箱下/el2/base目录下创建test目录
     $ hdc shell -b {bundleName} rm -r "./data/storage/el2/base/test.txt"  // 在应用沙箱下/el2/base目录下删除test.txt文件
     $ hdc shell -b {bundleName} rm -r "./data/storage/el2/base/test"      // 在应用沙箱下/el2/base目录下删除test目录

  3. 通过命令往应用沙箱目录中发送文件，从沙箱目录中下载文件到本地计算机。

     $ hdc file send -b {bundleName} "D:\test.txt" "./data/storage/el2/base"    // 发送文件到设备沙箱目录/el2/base
     $ hdc file recv -b {bundleName} "./data/storage/el2/base/test.txt" D:\  // 从设备沙箱目录/el2/base下载文件到本地计算机

• API 22及以下的版本，支持以下方式访问debug应用的沙箱目录。从API 23开始，此方式无法使用，请通过上文的hdc工具进行访问。
  1. 在工程主模块下的module.json5文件下增加网络权限。

     "requestPermissions": [
       {"name":  "ohos.permission.INTERNET"}
     ]

  2. 在设备侧(hdc shell)启动应用的bftpd服务，并查询端口号是否启动成功。

     $ aa process -b {bundleName} -a {abilityName} -p "/system/bin/bftpd -D -p {port}"  -S
     start native process successfully.
     $ ps -ef | grep bftpd
     20020143     12254   613 0 11:52:53 ?     00:00:00 bftpd -D -p 9021   // 对应端口号的bftpd服务启动成功
     shell        13035 11901 10 11:54:44 ?    00:00:00 grep bftpd

     • bundleName：调试应用包名。
     • abilityName：应用的ability名称。
     • port：可用端口号。
  3. 通过命令访问应用沙箱目录，创建目录文件，删除指定目录下的文件。

     $ ftpget -p {port} -P guest -u anonymous localhost -l /data/storage/el2/base           // 查看应用沙箱下/el2/base目录文件（返回文件全部信息）
     $ ftpget -p {port} -P guest -u anonymous localhost -L /data/storage/el2/base           // 查看应用沙箱下/el2/base目录文件（仅返回文件名）
     $ ftpget -p {port} -P guest -u anonymous localhost -M /data/storage/el2/base/test      // 在应用沙箱下/el2/base目录下创建test目录
     $ ftpget -p {port} -P guest -u anonymous localhost -d /data/storage/el2/base/test.txt  // 在应用沙箱下/el2/base目录下删除test.txt文件
     $ ftpget -p {port} -P guest -u anonymous localhost -D /data/storage/el2/base/test      // 在应用沙箱下/el2/base目录下删除test目录（仅支持删除空目录）

  4. 通过命令往应用沙箱目录中发送文件，从沙箱目录中下载文件到本地。(/data/local/tmp/作为中转目录)

     $ hdc file send test.txt /data/local/tmp/test.txt    // 先发送文件到设备data/local/tmp目录
     $ ftpget -p {port} -P guest -u anonymous localhost -s /data/local/tmp/test.txt /data/storage/el2/base/test.txt  // 再推送到应用沙箱目录
     $ ftpget -p {port} -P guest -u anonymous localhost -g /data/local/tmp/test.txt /data/storage/el2/base/test.txt  // 先下载到设备的data/local/tmp目录
     $ hdc file recv /data/local/tmp/test.txt test.txt  // 再从设备中获取

常见问题

沙箱视图下，打开沙箱文件夹时报错：[Fail][E003001] Invalid bundle name。

可能是以下原因：

1. 应用不是debug应用，无法查看沙箱文件。
2. 应用安装后，未运行过或重启了设备，导致应用沙箱暂未挂载。此场景下先手动运行一遍应用，然后在报错目录右键点击Synchronize即可打开目录。