Функции для работы с файлами надстройки

В состав архивного файла надстройки кроме обязательных файлов (см. раздел Состав и структура надстройки) могут входить и другие файлы.

При установке архив распаковывается в папку, которая зависит от используемой операционной системы:

 Linux: ~/.local/share/New Cloud Technologies Ltd./MyOffice/<Application>/Extensions/<Extension ID>
  Windows: %LOCALAPPDATA%\New Cloud Technologies Ltd\MyOffice\<Application>\Extensions\<Extension ID>
  macOS: ~/Library/Application Support/New Cloud Technologies Ltd./MyOffice/<Application>/Extensions/<Extension ID>

Данная папка является домашним каталогом надстройки. Файлы из него можно открыть в режиме просмотра (openBundledFile()) или скопировать в рабочий каталог (copyBundledDirectory(),copyBundledFile()). Рабочий каталог расположен по следующему пути:

 Linux: ~/.local/share/New Cloud Technologies Ltd./MyOffice/<Application>/Extensions/workspace/<Extension ID>
  Windows: %LOCALAPPDATA%\New Cloud Technologies Ltd\MyOffice\<Application>\Extensions\workspace\<Extension ID>
  macOS: ~/Library/Application Support/New Cloud Technologies Ltd./MyOffice/<Application>/workspace/Extensions/<Extension ID>

Рабочий каталог предназначен для работы с файлами надстройки, в нем надстройка может создавать, копировать и удалять любые файлы. Функция getWorkingDirectory() возвращает путь до рабочего каталога надстройки.

При обновлении надстройки содержимое домашнего каталога надстройки очищается и обновляется, а содержимое рабочего каталога – не меняется.