Данные пользователя

В зависимости от цели файлы должны устанавливаться в соответствии со спецификацией XDG Base Directory с добавлением директории {название_пакета} в каталог. Не следует жестко задавать пути домашней директории пользователя или $HOME/.config/ и т. д. Для определения путей следует использовать модули QStandardPaths, Silica.StandardPaths, методы GLib или библиотеку xdg‑helper. Это позволит убедиться, что приложение продолжит работать в изолированных вариантах использования, многопользовательских случаях использования, а также в многопрофильных однопользовательских случаях использования.

В приложениях для ОС Аврора данные должны быть организованы следующим образом:

  • $XDG_CACHE_HOME — директория кэша приложения ($XDG_CACHE_HOME/{название_пакета}) согласно спецификации XDG Base Directory, которая используется для хранения кэшированных данных (веб-кэширования, полученные и сгенерированные данные и т. д.). Очистка директории кэша не должна влиять на пользовательские данные или конфигурацию. Система может очищать кэш, когда заканчивается пространство, но приложение должно продолжать нормально функционировать, данные пользователя также не должны быть потеряны. Если переменная окружения $XDG_CACHE_HOME не задана или пуста, то следует использовать значение по умолчанию $HOME/.cache.

  • $XDG_CONFIG_HOME — директория конфигурации приложения ($XDG_CONFIG_HOME/{название_пакета}) согласно спецификации XDG Base Directory, которая используется для хранения пользовательских настроек (режим работы, необязательные функции переключения, настройки темы, конфигурация поведения и т. д.). Очистка директории конфигурации должна сбросить настройки приложения, но сохранить данные пользователя. Если переменная окружения $XDG_CONFIG_HOME не задана или пуста, то следует использовать значение по умолчанию $HOME/.config.

  • $XDG_DATA_HOME — директория данных приложения ($XDG_DATA_HOME/{название_пакета}) согласно спецификации XDG Base Directory, которая используется для хранения данных, генерируемых пользователем или приложением, и остальных данных, которые не относятся к конфигурации приложения. Очистка директории данных должна удалять пользовательские данные. Если переменная окружения $XDG_DATA_HOME не задана или пуста, то следует использовать значение по умолчанию $HOME/.local/share.