Windows-Auto-Night-Mode配置迁移：从旧版本升级到新版本的方法

Windows-Auto-Night-Mode配置迁移：从旧版本升级到新版本的方法

你是否在升级Windows-Auto-Night-Mode时遇到过配置丢失的问题？本文将详细介绍如何安全地将旧版本配置迁移到新版本，确保你的个性化设置不会丢失。完成迁移后，你将获得新版本的全部功能，同时保留熟悉的操作习惯。

配置文件位置与备份

Windows-Auto-Night-Mode的配置文件存储在用户应用数据目录中。在进行任何升级操作前，建议先备份现有配置。

配置文件的默认路径为：

• 主配置文件：%APPDATA%\AutoDarkMode\config.yaml（对应代码中的AdmConfigBuilder.cs）
• 位置数据：%APPDATA%\AutoDarkMode\location_data.yaml(AdmConfigBuilder.cs)
• 更新数据：%APPDATA%\AutoDarkMode\update.yaml(AdmConfigBuilder.cs)

手动备份配置文件的步骤：

1. 按下Win + R，输入%APPDATA%\AutoDarkMode并回车
2. 将以下文件复制到安全位置：
   • config.yaml
   • location_data.yaml
   • update.yaml
   • scripts.yaml
   • postpone_data.yaml

系统也会自动创建备份，代码中已实现自动备份功能，如AdmConfigBuilder.cs所示：

public static void MakeConfigBackup() { string backupPath = Path.Combine(ConfigDir, "config_backup.yaml"); File.Copy(ConfigFilePath, backupPath, true); }

自动迁移流程

新版本的Windows-Auto-Night-Mode已内置配置迁移功能，通常情况下，升级后首次启动应用会自动完成配置迁移。

自动迁移的工作原理：

1. 应用启动时检查配置文件版本
2. 如检测到旧版本配置，自动执行转换
3. 创建备份文件（config_backup.yaml）
4. 应用新的配置格式并保存

相关实现代码可参考AdmConfigBuilder.cs中的加载逻辑：

public void Load(bool createIfNotExists = true) { Loading = true; AdmConfig deser = Deserialize<AdmConfig>(ConfigFilePath, Config, createIfNotExists); Config = deser ?? Config; Loading = false; }

手动迁移步骤

如果自动迁移失败，或者你需要从非常旧的版本升级，可以按照以下步骤手动迁移配置：

1. 导出旧版本配置

从旧版本中导出配置：

1. 打开旧版本的Windows-Auto-Night-Mode
2. 导航到设置页面（SettingsPage.xaml）
3. 找到"导出配置"选项并保存配置文件

2. 安装新版本

从官方仓库克隆并安装新版本：

git clone https://gitcode.com/gh_mirrors/wi/Windows-Auto-Night-Mode cd Windows-Auto-Night-Mode # 按照README中的安装说明进行编译和安装

3. 导入配置文件

导入配置文件到新版本：

1. 启动新版本应用
2. 进入设置页面
3. 选择"导入配置"并选择之前保存的文件
4. 重启应用使配置生效

常见问题解决

配置文件加载失败

如果遇到配置文件加载失败的问题，可参考Service.cs中的错误处理逻辑：

try { // 尝试加载配置 } catch (Exception ex) { Logger.Error(ex, "could not save config: "); // 处理错误，可能需要手动修复或重新创建配置文件 }

解决方法：

1. 删除损坏的配置文件：%APPDATA%\AutoDarkMode\config.yaml
2. 重启应用，将生成默认配置
3. 手动重新配置或从备份导入

部分设置不生效

某些旧版本设置可能与新版本不兼容，特别是涉及系统主题和壁纸的设置。

检查相关设置页面确保配置正确：

• 主题设置：ThemePickerPage.xaml
• 壁纸设置：WallpaperPickerPage.xaml
• 时间设置：TimePage.xaml

例如，壁纸切换设置在WallpaperPickerPage.xaml.cs中处理：

await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-settings:personalization-background"));

迁移后界面显示异常

如果迁移后界面显示异常，可能是主题或颜色设置不兼容导致。可以通过以下步骤重置UI设置：

1. 打开设置页面
2. 导航到"个性化"选项卡（PersonalizationPage.xaml）
3. 点击"恢复默认设置"
4. 重启应用

验证迁移结果

迁移完成后，建议验证以下关键设置是否正常工作：

1. 主题切换时间是否正确
2. 暗色/亮色主题是否按预期切换
3. 壁纸切换功能是否正常
4. 快捷键设置是否保留（HotkeysPage.xaml）
5. 脚本执行是否正常（ScriptsPage.xaml）

可以通过查看日志文件来确认迁移是否成功，日志会记录配置加载和应用过程中的关键事件。

总结与注意事项

配置迁移是升级Windows-Auto-Night-Mode时的重要步骤，遵循以下最佳实践可确保迁移顺利：

1. 始终在升级前备份配置文件
2. 优先使用自动迁移功能
3. 如遇问题，检查日志文件获取详细错误信息
4. 部分旧设置可能需要手动重新配置
5. 迁移后验证所有关键功能是否正常工作

通过本文介绍的方法，你可以安全地将Windows-Auto-Night-Mode从旧版本升级到新版本，享受新功能的同时保留个人化设置。如有其他问题，请参考项目的官方文档或提交issue获取帮助。