Экран с настройками по умолчанию не доказывает, что файл удалён. После обновления приложение может вычислить другой user-data path из нового product name, bundle ID, sandbox-контейнера или окружения XDG. Сначала выведите фактический путь и версию схемы в локальный диагностический журнал обеих сборок, не записывая туда значения токенов и паролей.
Пользовательские настройки нельзя хранить рядом с executable или внутри app bundle: updater вправе заменить этот каталог целиком. На Electron используйте app.getPath с именем userData; на Linux нативное приложение следует правилам XDG, а на macOS получает Application Support через системный API.
Три каталога выполняют разные роли
| Данные | Подходящее место | Что происходит при update |
|---|---|---|
| бинарники и встроенные ресурсы | install/app bundle | заменяются новой версией |
| настройки и рабочее состояние | user config/data directory | должны сохраниться |
| кэш и пересоздаваемые индексы | cache directory | могут быть очищены |
| временный файл записи | тот же filesystem рядом с target | переименовывается атомарно |
| секреты | keychain/secret service | не переносятся как обычный JSON |
XDG Base Directory задаёт отдельные базы: config, data и state. На macOS Application Support предназначен для app-specific support data, а caches — для воспроизводимых файлов. Жёстко собранная строка домашнего каталога не учитывает sandbox; путь запрашивают у платформы или framework API.
Сравнение effective path находит смену identity
Сделайте диагностический экран «О приложении» с version, package channel, app ID и абсолютными путями config/data/log. После обновления сравните его со снимком старой версии. Если каталог изменился, изучите productName, bundle identifier, desktop package ID, sandbox entitlement и значения XDG в launch context.
version=4.8.0
schema_version=3
app_id=com.example.Editor
config_path=/home/user/.config/ExampleEditor/settings.json
data_path=/home/user/.local/share/ExampleEditor/
load_result=ok
# Значения настроек и секреты в такой отчёт не входят.Симлинк или ручное копирование может временно вернуть файл, но закрепляет ошибочную identity. Исправление должно выбрать один стабильный namespace. Если старые релизы уже писали в несколько мест, мигратор проверяет их в известном порядке и переносит данные один раз.
Миграция начинается с копии и версии схемы
Добавьте schema_version внутрь конфигурации и храните номер версии приложения отдельно. Новая сборка читает старый формат, валидирует его, создаёт backup и применяет последовательные шаги v1 → v2 → v3. Не перезаписывайте единственную копию до успешного открытия результата.
- Открыть старый файл только для чтения и проверить размер/формат.
- Сохранить резервную копию с понятной датой и версией схемы.
- Преобразовать данные в памяти, сохраняя неизвестные допустимые поля.
- Провести validation нового объекта и записать временный файл.
- Атомарно заменить target и отметить завершённую миграцию.
Если миграция падает, интерфейс не должен молча создавать пустой config поверх старого. Покажите пользователю восстановимый статус, оставьте исходник и запишите класс ошибки. Автоматический rollback возвращает предыдущую схему только если старая версия приложения ещё умеет её читать.
Обрыв питания не должен превращать JSON в пустой файл
Запись «открыть target с truncate и потом сериализовать» оставляет нулевой или частичный файл при аварии. Надёжнее записать новый файл рядом, выполнить flush по требованиям платформы, затем заменить target rename-операцией. Одновременные экземпляры приложения требуют lock или одного writer: последняя запись иначе стирает изменения первого окна.
- Не хранить config только в localStorage без явной модели sessionData/userData.
- Не считать parse error отсутствием файла.
- Не удалять backup в том же релизе, где появилась миграция.
- Не менять app ID между каналами stable/beta без плана переноса.
Update-тест проверяет больше одного счастливого пути
Матрица включает обновление через каждый поддерживаемый package format, запуск под тем же пользователем, переход через одну и несколько пропущенных версий, повреждённый старый config, нехватку места и второй запущенный экземпляр. Сравнивайте не только UI, но и путь, права, владельца, schema_version и checksum backup.
Релиз проходит проверку, когда настройки переживают update, новая схема читается после перезапуска, авария оставляет рабочую предыдущую копию, а downgrade либо поддержан, либо явно заблокирован без потери данных. Для воспроизведения приложите версии до/после, package type, app ID, effective paths и обезличенную ошибку парсера; сам файл с токенами передавать не нужно.