2026/10/11 10:04:26

从N64RecompLauncher到GithubLauncher:老用户迁移升级与配置兼容性完整指南

从N64RecompLauncher到GithubLauncher:老用户迁移升级与配置兼容性完整指南 【免费下载链接】GithubLauncherA Launcher that Downloads and Updates Applications from Github Releases项目地址https://gitcode.com/gh_mirrors/n6/GithubLauncher点击查看免费下载如果你还在使用旧版N64RecompLauncher这篇指南将带你快速完成向GithubLauncher的迁移升级。GithubLauncher 是一款从 GitHub Releases 自动下载、安装和更新应用的启动器Launcher它完整继承了旧版的settings.json设置文件老用户几乎可以零成本平滑过渡只需几分钟即可完成升级。为什么 N64RecompLauncher 要改名改名并非推倒重来而是项目定位的升级旧名由来项目最初名为 N64Recomp Launcher主要服务于 N64 重编译游戏场景改名原因应 N64Recomp 工具开发者的持续要求项目更名为GithubLauncher转型为通用的 GitHub 应用管理工具N64 用户怎么办如果你只想保留N64 专用版可继续使用v1.70这个过渡版本详见 README.md 顶部的迁移说明。 简单来说想留在 N64 老版本 → 停在 v1.70想体验通用版 → 升级到 GithubLauncher 新版本。相关项目标识定义在 Services/GithubLauncherProfile.cs 中DisplayName已从旧名更新为 Github Launcher。一键迁移老版本如何升级到新版本由于启动器自身没有内置跨版本自动更新通道官方推荐的升级方式是手动文件替换整个过程不到一分钟下载 GithubLauncher 的最新版本压缩包将新文件直接拖入你现有的启动器文件夹覆盖旧文件删除所有文件名中含 N64Recomp 字样的文件如旧的N64RecompLauncher可执行文件运行新的GithubLauncher可执行文件启动即可。⚠️前置要求新版基于 .NET 9请确保系统已安装 .NET 9 Runtime并联网以保证下载与更新检查正常工作。配置兼容性哪些设置不用重做这是老用户最关心的部分——你的设置会保持兼容Your settings will remain compatible官方文档已明确承诺。逐项拆解如下1️⃣ settings.json 设置自动继承主设置文件settings.json存放在启动器根目录由 Services/AppSettings.cs 负责读写包含这些常用配置设置项说明IconSize/IconFill图标尺寸与填充方式PrimaryColor/SecondaryColor主题配色AppsPath应用安装目录GitHubApiTokenGitHub API Token避免触发限流StartFullscreen/CloseAfterLaunch全屏启动 / 启动后关闭只要settings.json留在原文件夹中升级后打开就是原来的样子主题、图标、排序方式全部保留。若文件损坏或丢失程序会静默回退到默认设置见 AppSettings.cs 的 Load 方法不会导致崩溃。2️⃣ games.json 自动迁移为 apps.json旧版用games.json管理应用列表新版改用apps.json。好消息是这个迁移完全自动化无需手动编辑。Services/GameManager.cs 中的逻辑是启动时发现没有apps.json但存在旧的games.json会自动读取旧文件并生成新的apps.json。更贴心的是它还兼容旧文件的三种分类结构——standard、experimental、custom这些分区里的应用会被自动合并去重后写入统一列表见 ParseAppsRoot 方法。新版不再有内置分类所有条目统一由用户在apps.json中自行管理。每个应用条目需要 4 个属性name— 启动器中显示的名称repository— 仓库地址格式username/repositoryfolderName— 应用下载安装到的文件夹名appIconUrl— 图标图片地址可为null显示默认图标3️⃣ 已下载的应用不受影响你的应用仍安装在AppsPath指定的目录默认为启动器目录下的Apps/文件夹见 GameManager.cs 初始化逻辑迁移不会删除或移动任何已下载内容。如何禁用自更新把 LastCheckTime 改成 9999 年升级到新版后启动器会在每次启动时检查是否有新版本。如果你是v1.70 N64 老用户不想被自更新拉走可以这样冻结版本打开启动器目录下的update_check.json找到LastCheckTime字段把年份改成9999例如LastCheckTime:9999-01-01T00:00:00Z保存文件即可。原理在于 App.axaml.cs 的 ShouldSkipUpdateCheck 方法当当前时间 − LastCheckTime小于检查间隔时跳过更新检查。把时间推到 9999 年差值恒为负数检查逻辑就永远被跳过了。命令行侧的版本读取与更新提示逻辑位于 Services/CLIHandler.cs。迁移后建议做的 3 件事✅填一个 GitHub API Token在设置页粘贴一个无任何权限的 Personal Access Token避免触发 API 限流导致应用列表加载缓慢切勿外泄 Token✅检查 apps.json确认自动迁移后的应用条目正确可按需增删✅清理旧文件确认删除所有含 N64Recomp 的文件保持文件夹整洁。常见问题 FAQQ迁移会丢应用吗不会。Apps目录及其下的应用原样保留配置层只是从games.json自动升级到apps.json。QN64 重编译游戏还能用吗可以。停在 v1.70 并禁用自更新即可继续使用旧版新版则按通用应用管理把 N64 相关仓库加入apps.json同样能运行。Q升级后设置全乱了检查启动器目录下的settings.json是否还在、是否为合法 JSON若缺失程序会重建默认设置你需要重新配置一次。按以上步骤操作从 N64RecompLauncher 到 GithubLauncher 的迁移全程无需重写任何配置。更多功能细节Token 创建步骤、apps.json完整示例可参考 README.md 中的 Configuration 章节。赞分享【免费下载链接】GithubLauncherA Launcher that Downloads and Updates Applications from Github Releases项目地址https://gitcode.com/gh_mirrors/n6/GithubLauncher点击查看免费下载相关推荐终极指南FOSRestBundle与Symfony 7.0兼容性升级迁移完整方案终极指南FOSRestBundle与Symfony 7.0兼容性升级迁移完整方案 FOSRestBundle是Symfony生态中用于快速开发RESTful后端GENRE模型训练全攻略从数据集准备到性能优化的关键技巧GENRE模型训练全攻略从数据集准备到性能优化的关键技巧 GENREAutoregressive Entity Retrieval是一种强大的自回归实体检人工智能深度学习NLP从UITableView迁移到IGListKit老列表安全升级的完整迁移指南从UITableView迁移到IGListKit老列表安全升级的完整迁移指南 IGListKit 是由 Instagram 工程师打造的数据驱动 UIColl移动开发UI组件创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考