InnerCore/Модуль FileTools

Для создания, чтения и редактирования файлов Inner Core имеет модуль FileTools, который предоставляет удобные функции для работы с файлами, а также ряд переменных, используемых при работе с файлами.

Переменные для работы с файлами в Inner Core

• FileTools.mntdir - возвращает путь до хранилища смонтированных папок Android ("/mnt")
• FileTools.root - возвращает путь до внешнего хранилища файлов устройства (путь к домашней папке), заканчивается на "/"
• FileTools.workdir - возвращает относительный путь до папки Core Engine ("games/com.mojang/coreengine/")
• FileTools.moddir - возвращает относительный путь до папки с модами ("games/com.mojang/mods/")
• FileTools.modpedir - возвращает относительный путь до папки ModPE ("games/com.mojang/modpe/"). На данный момент в этой папке иногда пролетают перекатиполе, больше там ничего нету

Методы для работы с файлами в Inner Core

• FileTools.mkdir(path) - создает папку по указанному пути
• FileTools.mkworkdirs() - создает рабочие папки Core Engine (workdir, moddir, modpedir)
• FileTools.getFullPath(path) - возвращает абсолютный путь к файлу по его относительному к пути. Относительный путь не должен начинаться с "/". Если аргумент уже является полным путём к файлам внешнего хранилища или хранилища смонтированных папок Android, функция вернёт путь без изменений. Большинство других методов FileTools работают через него, поэтому в них можно передавать относительный путь
• FileTools.isExists(path) - проверяет, существует ли файл или папка по пути path. Параметр может быть как абсолютным путём, так и относительным
• FileTools.WriteText(path, value, add) - записывает строку value в файл по пути path, если add равен true, то добавляет value в конец файла, если false или не указан, то файл перезаписывается
• FileTools.ReadText(path) - считывает файл по пути path в строку
• FileTools.WriteImage(path, image) - записывает изображение, объект типа Bitmap, в файл по пути path
• FileTools.ReadImage(path) - считывает изображение по пути path в объект типа Bitmap
• FileTools.ReadTextAsset(path) - считывает файл из ресурспака по пути path в строку
• FileTools.ReadImageAsset(path) - считывает изображение из ресурспака по пути path в объект типа Bitmap
• FileTools.ReadBytesAsset(path) - считывает байты из ресурспака по пути path в Java-массив типа byte
• FileTools.GetListOfDirs(path) - возвращает список каталогов по данному пути в виде Javascript-массива объектов File
• FileTools.GetListOfFiles(path, extension) - возвращает список файлов по данному пути в виде Javascript-массива объектов File. Если задан второй аргумент, возвращает только файлы с заданным расширением
• FileTools.ReadKeyValueFile(path, separator) - возвращает объект, состоящих из пар ключ-значение, считанных из файла по пути path. Если не задан разделитель, по умолчанию используется разделитель ":". При этом ни ключ, ни значение не очищаются от пробелов, поэтому следует делать это вручную при необходимости. Пример файла:

key1:value1
key2:value2
key3:value3

• FileTools.WriteKeyValueFile(path, object, separator) - записывает объект, состоящий из пар ключ-значение, по пути path, используя separator в качестве разделителя. Если separator не задан, используется разделитель ":". Пример файла приведён в описании к методу ReadKeyValueFile
• FileTools.ReadJSON(path) - считывает файл с объектом JSON по заданому пути в Javascript-объект
• FileTools.WriteJSON(path, json, beautify) - записывает в JSON-файл по заданому пути Javascript-объект, если beautify равен true, то вывод будет красиво отформатирован