Userdata Wiper API

Userdata Wiper служит для очистки пользовательских данных. Подробнее…

Шина:	сессионная
Служба:	ru.omp.userdata.wiper
Объект:	/ru/omp/userdata/wiper
Интерфейс:	ru.omp.userdata.wiper

Методы

• ProcessUserdata(bool force)

Подробное описание

Сервис очищает пользовательские данные из директорий, указанных в конфигурационном файле. Конфигурационный файл по умолчанию имеет следующий вид:

{
    "directories": {
        "Documents/" : -1,
        "Downloads/" : -1,
        "Music/" : -1,
        "Playlists/" : -1,
        "Pictures/" : -1,
        "Public/" : -1,
        "Videos/" : -1,
    }
}

Все названия директорий не должны иметь в начале никаких специальных символов. Например, запрещён символ /.

Все методы Userdata Wiper доступны при указании разрешения UserdataWiper.

При отсутствии внешнего конфигурационного файла /etc/userdata-wiper/override.json используется конфигурационный файл по умолчанию. При отсутствии конфигурационного файла по умолчанию и внешнего конфигурационного файла будет создан конфигурационный файл по умолчанию /etc/userdata-wiper/default.json.

Внешний конфигурационный файл по структуре ничем не отличается от конфигурационного файла по умолчанию. Для обоих файлов проверяется, что указанные директории являются дочерними для домашней директории пользователя.

Через каждый час системного времени срабатывает таймер, который запускает сервис для обработки директорий, указанных в конфигурационном файле.

При помощи D-Bus-метода ProcessUserdata() можно внепланово запустить сервис.

Настроить интервалы для директорий можно в системных настройках в пункте Администрирование. Данное меню доступно только администратору мобильного устройства, для остальных пользователей оно скрыто.

Значение интервала указывается в часах. Оно должно быть не меньше 4, не больше 168 и кратно 4.

Описание методов

ProcessUserdata(bool force)

Метод используется для запуска внеплановой проверки с флагом force равным false. Для экстренного удаления пользовательских данных без проверки времени жизни файлов следует использовать флаг force со значением true.

Если интервал очистки равен -1, директория не обрабатывается и считается отключённой.