Экран с настройками по умолчанию не доказывает, что файл удалён. После обновления приложение может вычислить другой 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. Не перезаписывайте единственную копию до успешного открытия результата.

  1. Открыть старый файл только для чтения и проверить размер/формат.
  2. Сохранить резервную копию с понятной датой и версией схемы.
  3. Преобразовать данные в памяти, сохраняя неизвестные допустимые поля.
  4. Провести validation нового объекта и записать временный файл.
  5. Атомарно заменить 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 и обезличенную ошибку парсера; сам файл с токенами передавать не нужно.

Проверенные источники