文件系统-files

var data = files.readBytes("/sdcard/1.png");
var sb = new java.lang.StringBuilder();
for (var i = 0; i < data.length; i++) {
  sb.append(data[i].toString(16));
}
log(sb.toString());

files.write(path, text[, encoding = "utf-8"])

path {string} 路径
text {string} 要写入的文本内容
encoding {string} 字符编码

把 text 写入到文件 path 中。如果文件存在则覆盖，不存在则创建。

files.writeBytes(path, bytes)

path {string} 路径
bytes {byte[]} 字节数组，要写入的二进制数据

把 bytes 写入到文件 path 中。如果文件存在则覆盖，不存在则创建。

files.append(path, text[, encoding = 'utf-8'])

path {string} 路径
text {string} 要写入的文本内容
encoding {string} 字符编码

把 text 追加到文件 path 的末尾。如果文件不存在则创建。

files.appendBytes(path, bytes[, encoding = 'utf-8'])

path {string} 路径
bytes {byte[]} 字节数组，要写入的二进制数据
encoding {string} 字符编码

把 bytes 追加到文件 path 的末尾。如果文件不存在则创建。

files.copy(fromPath, toPath)

fromPath {string} 要复制的原文件路径
toPath {string} 复制到的文件路径
return {boolean}

复制文件，返回是否复制成功。

files.move(fromPath, toPath)

fromPath {string} 要移动的原文件路径
toPath {string} 移动到的文件路径
return {boolean}

移动文件，返回是否移动成功。

files.rename(path, newName)

path {string} 要重命名的原文件路径
newName {string} 要重命名的新文件名
return {boolean}

重命名文件，并返回是否重命名成功。例如files.rename("/sdcard/1.txt", "2.txt")。

files.renameWithoutExtension(path, newName)

path {string} 要重命名的原文件路径
newName {string} 要重命名的新文件名
return {boolean}

重命名文件，不包含拓展名，并返回是否重命名成功。例如files.rename("/sdcard/1.txt", "2")会把"1.txt"重命名为"2.txt"。

files.getName(path)

path {string} 路径
return {string}

返回文件的文件名。例如files.getName("/sdcard/1.txt")返回"1.txt"。

files.getNameWithoutExtension(path)

path {string} 路径
return {string}

返回不含拓展名的文件的文件名。例如files.getName("/sdcard/1.txt")返回"1"。

files.getExtension(path)

path {string} 路径
return {string}

返回文件的拓展名。例如files.getExtension("/sdcard/1.txt")返回"txt"。

files.remove(path)

path {string} 路径
return {boolean}

删除文件或空文件夹，返回是否删除成功。

files.removeDir(path)

path {string} 路径
return {boolean}

删除文件夹，如果文件夹不为空，则删除该文件夹的所有内容再删除该文件夹，返回是否全部删除成功。

files.getSdcardPath()

return {string}

返回 SD 卡路径。所谓 SD 卡，即外部存储器。

files.cwd()

return {string}

返回脚本的"当前工作文件夹路径"。该路径指的是，如果脚本本身为脚本文件，则返回这个脚本文件所在目录；否则返回null获取其他设定路径。

例如，对于脚本文件"/sdcard/脚本/1.js"运行files.cwd()返回"/sdcard/脚本/"。

files.path(relativePath)

relativePath {string} 相对路径
return {string}

返回相对路径对应的绝对路径。例如files.path("./1.png")，如果运行这个语句的脚本位于文件夹"/sdcard/脚本/"中，则返回"/sdcard/脚本/1.png"。

files.listDir(path[, filter])

path {string} 路径
filter {Function} 过滤函数，可选。接收一个string参数（文件名），返回一个boolean值。

列出文件夹 path 下的满足条件的文件和文件夹的名称的数组。如果不加 filter 参数，则返回所有文件和文件夹。

列出 sdcard 目录下所有文件和文件夹为:

var arr = files.listDir("/sdcard/");
log(arr);

列出脚本目录下所有 js 脚本文件为:

var dir = "/sdcard/脚本/";
var jsFiles = files.listDir(dir, function (name) {
  return name.endsWith(".js") && files.isFile(files.join(dir, name));
});
log(jsFiles);

open(path[, mode = "r", encoding = "utf-8", bufferSize = 8192])

path {string} 文件路径，例如"/sdcard/1.txt"。
mode {string} 文件打开模式，包括:
- r: 只读文本模式。该模式下只能对文件执行文本读取操作。
- w: 只写文本模式。该模式下只能对文件执行文本覆盖写入操作。
- a: 附加文本模式。该模式下将会把写入的文本附加到文件末尾。
- rw: 随机读写文本模式。该模式下将会把写入的文本附加到文件末尾。
  目前暂不支持二进制模式，随机读写模式。
encoding {string} 字符编码。
bufferSize {number} 文件读写的缓冲区大小。