mirror of
https://jihulab.com/DGP-Studio/Snap.Hutao.Docs.git
synced 2025-11-19 21:16:31 +08:00
Version 1.9.0 warm up
This commit is contained in:
Masterain
BIN
docs/.vuepress/public/images/202312/1-8-5-installer.png
Normal file
BIN
docs/.vuepress/public/images/202312/1-8-5-installer.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 40 KiB |
@@ -30,5 +30,11 @@ export const enSidebar = sidebar({
|
||||
prefix: "statements/",
|
||||
children: "structure",
|
||||
},
|
||||
{
|
||||
icon: "iconfont icon-article",
|
||||
text: "Dev Logs",
|
||||
prefix: "blog/",
|
||||
children: "structure",
|
||||
}
|
||||
],
|
||||
});
|
||||
|
||||
@@ -30,5 +30,11 @@ export const zhSidebar = sidebar({
|
||||
prefix: "statements/",
|
||||
children: "structure",
|
||||
},
|
||||
{
|
||||
icon: "iconfont icon-article",
|
||||
text: "开发日志",
|
||||
prefix: "blog/",
|
||||
children: "structure",
|
||||
}
|
||||
],
|
||||
});
|
||||
|
||||
12
docs/en/blog/README.md
Normal file
12
docs/en/blog/README.md
Normal file
@@ -0,0 +1,12 @@
|
||||
---
|
||||
comment: false
|
||||
index: false
|
||||
icon: iconfont icon-article
|
||||
dir:
|
||||
text: Dev Logs
|
||||
order: 10
|
||||
---
|
||||
|
||||
# Dev Logs
|
||||
|
||||
<AutoCatalog />
|
||||
64
docs/en/blog/version-1-9-0-breaking-changes.md
Normal file
64
docs/en/blog/version-1-9-0-breaking-changes.md
Normal file
@@ -0,0 +1,64 @@
|
||||
---
|
||||
category: [Dev Logs]
|
||||
order: 1
|
||||
comment: false
|
||||
---
|
||||
|
||||
# Explanation of Breaking Changes in Version 1.9.0
|
||||
|
||||
This document is applicable to users upgrading from Snap Hutao versions **1.4.11 to 1.8.4** to version 1.9.0 and higher.
|
||||
|
||||
## Introduction
|
||||
|
||||
Snap Hutao is a Windows sandbox application in MSIX format, providing the convenience of installation and the security of AppX applications. Mandatory code signing in installation packages is a crucial factor in ensuring security. If the installation package is modified, Windows App Installer will raise an error due to the signature being compromised, preventing user installation. We can see this practice everywhere in today's mobile operating systems. On the Windows platform, due to strict identity verification procedure, the prices of code signing certificates have remained high.
|
||||
|
||||
Before version 1.4.11, Snap Hutao used a self-signed certificate. In this mode, users had to manually install DGP-Studio's certificate to allow the installation of applications signed by DGP-Studio's certificate on their computers. Starting from version 1.4.11, Snap Hutao was listed on the Microsoft Store, and Microsoft provided a GUID `35C8E923-85DF-49A7-9172-B39DC6312C52` for Hutao's developer account. This GUID was used as the publisher name of Snap Hutao, providing a special free signature (only used for Microsoft Store apps). If you are accustomed to updating the Snap Hutao with MSIX packages, you should always see this GUID in the publisher column.
|
||||
|
||||
Listing on the Microsoft Store eliminated the need for Snap Hutao users to manually install the signing certificate and supported the distribution of Snap Hutao installation packages, reducing a significant amount of costs for the development team. However, the cumbersome approval process often disrupted the development plans of the Snap Hutao. Therefore, over the past six months, the development team has been seeking a solution. SignPath is a company based in Vienna, Austria, that provides code signing integration software. In early December 2023, the Snap Hutao development team successfully obtained sponsorship from the SignPath Foundation, allowing us to use their code signing certificates for Snap Hutao free of charge. This greatly assisted the Snap Hutao project by not only allowing the Snap Hutao to get rid of constraints of the Microsoft Store but also avoiding the high annual certificate fees.
|
||||
|
||||
**Due to the migration to a new certificate causing package name conflicts, Snap Hutao provides the following detailed explanation to assist all users in updating to version 1.9.0 and future versions.**
|
||||
|
||||
## Upgrade to Version 1.9.0
|
||||
|
||||
### Version Release
|
||||
|
||||
Snap Hutao version 1.9.0 is scheduled to be released on the weekend before Christmas 2023. We will publish the download links for the installation package through GitHub, Jihu GitLab, this official website, and the community.
|
||||
|
||||
### Uninstall Old Versions
|
||||
|
||||
Directly installing this package will cause problems depending on your system version due to package name and signature conflicts.
|
||||
|
||||
| System Version | Expected Issues |
|
||||
| :------------: | :-----------------------------------------------------------------------------------------------------------------------: |
|
||||
| Windows 10 | Unable to install; signature and package name conflicts |
|
||||
| Windows 11 | Installation successful;<br/>Coexistence with old versions of Snap Hutao with the same name causes program runtime errors |
|
||||
|
||||
Due to the above issue, you need to uninstall the old version of Snap Hutao first and then install the 1.9.0 version package.
|
||||
|
||||
> **How to uninstall Snap Hutao**: Find Snap Hutao in the Start menu, right-click, and select uninstall; another quick method is to find it in Windows App Settings and choose uninstall.
|
||||
|
||||
**Your important data (including logged-in miHoYo accounts, wish records, achievement data, Spiral Abyss records, My Character cache data, and development plans) will not be lost, they are still stored in your local Hutao data directory on your computer.** However, the following data will be reset:
|
||||
|
||||
1. Snap Hutao runtime count
|
||||
2. Data folder path **(if you previously modified the data directory, remember your data directory path)**
|
||||
3. Hutao account (Hutao Passport) login status
|
||||
4. Closed Hutao announcement flags
|
||||
5. Development plan preset level information
|
||||
6. Dashboard card status on the homepage
|
||||
7. Auto-click function status
|
||||
|
||||
### Install the New Version
|
||||
|
||||
|
||||
|
||||
Run the 1.9.0 version installer you have already downloaded. In the installation interface, you should see the publisher as `SignPath Foundation`. Click install to install the all-new version of Snap Hutao!
|
||||
|
||||
**If you modified the data directory location in the old version, you need to select the data directory path again in the settings after starting to restore the data. If you have never set a data directory, your data will be loaded directly without additional setup.**
|
||||
|
||||
## Future Plans
|
||||
|
||||
> Microsoft Store, future releases, software security...
|
||||
|
||||
In the Microsoft Store, the application publisher name must be a GUID assigned by Microsoft, not a "custom" name like `SignPath Foundation`. We anticipate that we will not continue to release updates in the Microsoft Store in the future unless we have a better way to handle coexistence issues between different signature packages. Although Snap Hutao will no longer go through Microsoft's certification, under SignPath's restrictions, Snap Hutao will only be able to compile and build release packages directly from the GitHub code repository. This means that the code in the user's installation package is 100% sourced from our GitHub code repository, and anyone has the authority to review and participate in development.
|
||||
|
||||
Starting from version 1.9.0 of the client, we will integrate a software update module to adapt to the new release method. We will minimize the operations required for user updates as much as possible. As this feature is brand new, we are still in the deployment process. Please continue to pay attention to our in-app announcements and community for information!
|
||||
@@ -8,6 +8,49 @@ comment: false
|
||||
|
||||
# Update Logs
|
||||
|
||||
## 1.9.0 <Badge text="Upcoming" type="tip" />
|
||||
|
||||
::: important Break Changes
|
||||
|
||||
Snap Hutao recently obtained sponsorship from the SignPath Foundation for code signing certificates. Starting from version 1.9.0, we will use a brand-new certificate to sign Snap Hutao installation packages.
|
||||
|
||||
Programs with the new signature will be incompatible with old versions. Users updating from versions 1.8.4 and older to 1.9.0 and newer versions need to uninstall the old version first and then perform a fresh installation of the new version of the client. Due to the design of Snap Hutao's data directory, users will not lose any important data.
|
||||
|
||||
You can read the article [Explanation of Breaking Changes in Version 1.9.0](../blog/version-1-9-0-breaking-changes.md) for a deeper understanding of how the signature changes in this version update affect the Snap Hutao project.
|
||||
|
||||
:::
|
||||
|
||||
- **New Features ➕**
|
||||
|
||||
- The game launcher now supports multiple game paths [#525](https://github.com/DGP-Studio/Snap.Hutao/issues/526)
|
||||
- Added QR code login method for miHoYo in the user panel [#870](https://github.com/DGP-Studio/Snap.Hutao/issues/870)
|
||||
- The client now automatically detects network status and displays the results in the settings page [#1116](https://github.com/DGP-Studio/Snap.Hutao/pull/1161)
|
||||
- Added an option in the game launcher to start Genshin Impact in touch mode [#1173](https://github.com/DGP-Studio/Snap.Hutao/issues/1173)
|
||||
- Added an option in the settings to enable the console. Users can now get more error prompts when troubleshooting by enabling this option.
|
||||
- Introduced a completely new logic for software updates.
|
||||
|
||||
- **Bug Fixes 🔨**
|
||||
|
||||
- Fixed an issue with miHoYo API returning a `5003` error when fetching character information [#1060](https://github.com/DGP-Studio/Snap.Hutao/issues/1060)
|
||||
- Fixed an issue with incorrect countdown data for miHoYo announcements in specific situations.
|
||||
- Fixed incorrect PowerShell statements.
|
||||
|
||||
- **Optimizations ✨**
|
||||
|
||||
- Improved error prompt statements in development calculations, making error messages more explicit [#1163](https://github.com/DGP-Studio/Snap.Hutao/issues/1163)
|
||||
- Optimized the interface of development calculations, now showing specific goals for each item [#1016](https://github.com/DGP-Studio/Snap.Hutao/issues/1016)
|
||||
- Optimized the display of Hutao account information on the main interface, no longer displaying user email addresses [#1160](https://github.com/DGP-Studio/Snap.Hutao/issues/1160)
|
||||
- Updated error prompts for Hutao API.
|
||||
- Optimized the settings page interface; users can now view the size of data and cache directories generated by Snap Hutao in the settings.
|
||||
|
||||
- **Localization 🌏**
|
||||
- Added Indonesian language option in the client, thanks to [@NatsumeAoii](https://github.com/NatsumeAoii) for providing the translation [#1188](https://github.com/DGP-Studio/Snap.Hutao/issues/1188)
|
||||
- Updated translations for existing languages.
|
||||
|
||||
## 1.8.5 <Badge text="Beta Test" type="info" />
|
||||
|
||||
- Tested changes caused by certificate change
|
||||
|
||||
## 1.8.4 <Badge text="latest" type="tip" />
|
||||
|
||||
- Fix
|
||||
|
||||
12
docs/zh/blog/README.md
Normal file
12
docs/zh/blog/README.md
Normal file
@@ -0,0 +1,12 @@
|
||||
---
|
||||
comment: false
|
||||
index: false
|
||||
icon: iconfont icon-article
|
||||
dir:
|
||||
text: 开发日志
|
||||
order: 10
|
||||
---
|
||||
|
||||
# 开发日志
|
||||
|
||||
<AutoCatalog />
|
||||
64
docs/zh/blog/version-1-9-0-breaking-changes.md
Normal file
64
docs/zh/blog/version-1-9-0-breaking-changes.md
Normal file
@@ -0,0 +1,64 @@
|
||||
---
|
||||
category: [开发日志]
|
||||
order: 1
|
||||
comment: false
|
||||
---
|
||||
|
||||
# 1.9.0 版本重大改变详解
|
||||
|
||||
本文内容适用于Snap Hutao **1.4.11~1.8.4 版本**升级至 1.9.0 及更高版本
|
||||
|
||||
## 前言
|
||||
|
||||
Snap Hutao 是一个使用 MSIX 格式的 Windows 沙盒应用，它带来了安装的便利性和 AppX 应用的安全性。对安装包强制性的代码签名是保证安全性的重要因素之一：在安装包被篡改时，Windows App Installer 会因为签名被破坏而弹出错误，进而禁止用户安装，这在主流移动端操作系统中已经被普及。在 Windows 平台下，由于严格的身份审查制度，代码签名证书价格一直保持在很高的价格上。
|
||||
|
||||
Snap Hutao 在1.4.11版本前，使用了自签名证书的方法。在这种模式下，用户需要手动 安装 DGP-Studio 的证书，才能让操作系统允许 DGP-Studio 证书签名的应用安装于计算机上。自1.4.11版本起，Snap Hutao 上架微软商店，微软为胡桃的开发者账号提供了一个 GUID `35C8E923-85DF-49A7-9172-B39DC6312C52`并以此为用户名为胡桃工具箱提供了免费的签名。如果你习惯使用 msix 安装包更新胡桃工具箱，那么你应总是能在发布者一栏中看到这个 GUID。
|
||||
|
||||
在微软商店发布使得胡桃工具箱的用户不再需要手动安装签名证书，还为胡桃工具箱安装包的分发提供了支持，为开发团队降低了大量的成本。但是，繁琐冗长的审核流程经常打乱胡桃工具箱的开发计划，因此开发团队在过去的半年中一直在寻找解决方案。SignPath 是一家位于奥地利维也纳的提供代码签名集成软件的公司。在2023年12月初，Snap Hutao 的开发团队成功地获取到了 SignPath 基金会的支持，被允许免费使用其提供的代码签名证书为胡桃工具箱签名。这极大地帮助了 Snap Hutao 项目：不仅允许胡桃工具箱脱离微软商店的束缚，还避免了每年高昂的证书费用。
|
||||
|
||||
**由于迁移至新证书会带来包名冲突问题，Snap Hutao 提供以下详细解释帮助所有用户更新至 1.9.0 及未来的版本。**
|
||||
|
||||
## 升级至 1.9.0 版本
|
||||
|
||||
### 版本发布
|
||||
|
||||
Snap Hutao 1.9.0 版本将会于2023年圣诞节前的周末发布，我们会通过 GitHub，极狐GitLab，官方网站和社区发布安装包的下载地址。
|
||||
|
||||
### 卸载旧版本
|
||||
|
||||
由于包名和签名冲突，直接安装该安装包会根据你的系统版本出现问题。
|
||||
|
||||
| 系统版本 | 预计的问题 |
|
||||
| :--------: | :-------------------------------------------------------------: |
|
||||
| Windows 10 | 无法安装；签名和包名冲突 |
|
||||
| Windows 11 | 安装成功；<br/>与旧版本的 Snap Hutao 同名共存并造成程序运行错误 |
|
||||
|
||||
由于上述的问题，你需要首先卸载旧版本 Snap Hutao，随后再安装 1.9.0 版本安装包
|
||||
|
||||
> **卸载 Snap Hutao 的方法**：在开始菜单找到 Snap Hutao，右键点击卸载即可；在 Windows 应用设置中找到后选择卸载亦是快捷的方法。
|
||||
|
||||
**你的重要数据（包括已登录的米游社账号、祈愿记录、成就数据、深境螺旋挑战记录、我的角色缓存数据、养成计划）不会丢失，它们仍然储存于你的本地计算机胡桃数据目录中。** 但以下数据将被重置：
|
||||
|
||||
1. Snap Hutao 运行次数计数
|
||||
2. 数据文件夹路径 **（如果你之前修改了数据目录，请记住你的数据目录路径）**
|
||||
3. 胡桃账号登录状态
|
||||
4. 已关闭的胡桃公告标记
|
||||
5. 养成计划预设等级信息
|
||||
6. 主页仪表盘卡片的状态
|
||||
7. 自动连点功能的状态
|
||||
|
||||
### 安装新版本
|
||||
|
||||
|
||||
|
||||
运行你已经下载好的 1.9.0 版本安装包，在安装界面你应能看到发布者为 `SignPath Foundation`，点击安装你就可以安装全新版本的 Snap Hutao 了！
|
||||
|
||||
**如果你在旧版本修改了数据目录位置，需要在启动后重新在设置中选择数据目录路径以恢复数据。若从未设置过数据目录，你的数据将会直接加载，不需要进行额外设置。**
|
||||
|
||||
## 未来的计划
|
||||
|
||||
> 微软商店、未来的发布、软件的安全性...
|
||||
|
||||
微软商店中上架的应用发布者名称必须为微软赋予的 GUID，而不能是 `SignPath Foundation` 这样的“自定义”的名称。我们预计未来不会在微软商店中继续发布更新的版本，除非我们有更好的方法处理不同签名包之间的共存问题。虽然 Snap Hutao 不再经过微软的认证，但是在 SignPath 的限制下，Snap Hutao 将只能从 GitHub 代码库直接编译和构建发布包，这意味着用户的安装包中的代码是 100% 来源于我们的 GitHub 代码库，任何人都有权限审阅代码并参与开发。
|
||||
|
||||
自1.9.0版本起的客户端，我们将内置软件更新模块以适应新的发布方式，我们会尽可能减少用户更新时所需要的操作。由于该功能是全新的功能，我们仍在部署过程中，请继续关注我们的程序内公告和社区以获取信息！
|
||||
@@ -8,6 +8,43 @@ comment: false
|
||||
|
||||
# 更新日志
|
||||
|
||||
## 1.9.0 <Badge text="即将发布" type="tip" />
|
||||
|
||||
::: important 重大改变
|
||||
|
||||
Snap Hutao 在近期获得了 SignPath 基金会的赞助的代码签名证书。自1.9.0版本起，我们将使用全新的证书为 Snap Hutao 安装包签名。
|
||||
|
||||
拥有新签名的程序将与旧版本不兼容，用户在从1.8.4及更旧版本更新至1.9.0及更新版本时，需要首先卸载旧版本再全新安装新版本客户端。由于胡桃数据目录的设计，用户不会丢失任何重要数据。
|
||||
|
||||
你可以阅读[1.9.0 版本重大改变详解](../blog/version-1-9-0-breaking-changes.md)一文来更深入地了解这次版本更新中签名变化对 Snap Hutao 项目的改变。
|
||||
|
||||
:::
|
||||
|
||||
- 新增 ➕
|
||||
- 游戏启动器现在支持了多个游戏路径 [#525](https://github.com/DGP-Studio/Snap.Hutao/issues/526)
|
||||
- 在用户面板中增加了米游社的扫码登录方法 [#870](https://github.com/DGP-Studio/Snap.Hutao/issues/870)
|
||||
- 客户端新增了自动检测网络状态，并将结果显示在设置页面中 [#1116](https://github.com/DGP-Studio/Snap.Hutao/pull/1161)
|
||||
- 在游戏启动器中新增了以触屏模式启动原神的选项 [#1173](https://github.com/DGP-Studio/Snap.Hutao/issues/1173)
|
||||
- 在设置中新增了启用控制台的选项，用户现在可以通过启用该选项在排查问题时获得更多的错误提示
|
||||
- 添加了全新的软件更新处理逻辑
|
||||
- 修复 🔨
|
||||
- 修复了米游社接口获取角色信息产生`5003`错误的问题 [#1060](https://github.com/DGP-Studio/Snap.Hutao/issues/1060)
|
||||
- 修复了特定情况下米游社公告倒计时数据错误的问题
|
||||
- 修复了错误的 PowerShell 语句
|
||||
- 优化 ✨
|
||||
- 优化了养成计算中的错误提示语句，使得错误提示更加明确 [#1163](https://github.com/DGP-Studio/Snap.Hutao/issues/1163)
|
||||
- 优化了养成计算的界面，现在将会显示每项具体目标 [#1016](https://github.com/DGP-Studio/Snap.Hutao/issues/1016)
|
||||
- 优化了主界面中胡桃账号信息的显示，不再显示用户邮箱 [#1160](https://github.com/DGP-Studio/Snap.Hutao/issues/1160)
|
||||
- 更新了胡桃 API 的错误提示
|
||||
- 优化了设置页界面，用户现在可以在设置中查看 Snap Hutao 产生的数据和缓存目录大小
|
||||
- 本地化 🌏
|
||||
- 客户端增加了印尼语选项，感谢 [@NatsumeAoii](https://github.com/NatsumeAoii)提供的翻译 [#1188](https://github.com/DGP-Studio/Snap.Hutao/issues/1188)
|
||||
- 更新了现有语言的翻译
|
||||
|
||||
## 1.8.5 <Badge text="测试版" type="info" />
|
||||
|
||||
- 测试了签名替换带来的变化
|
||||
|
||||
## 1.8.4 <Badge text="最新版" type="tip" />
|
||||
|
||||
- 修复
|
||||
@@ -22,7 +59,7 @@ comment: false
|
||||
- 优化了启动游戏页面切换服务器时的性能，现在会使用多线程分片下载资源文件
|
||||
- 优化了启动游戏页面切换服务器时的逻辑，现在会提前检查对应目录是否拥有需要的文件权限
|
||||
|
||||
## 1.8.3 <Badge text="hotfix" type="tip" />
|
||||
## 1.8.3 <Badge text="hotfix" type="warning" />
|
||||
|
||||
- 修复
|
||||
- 修复了当 Discord 客户端未启动时，胡桃会闪退的问题 [#1134](https://github.com/DGP-Studio/Snap.Hutao/issues/1134)
|
||||
@@ -60,6 +97,10 @@ comment: false
|
||||
- 优化
|
||||
- 为元数据初始化添加了更详细的失败信息
|
||||
|
||||
## 1.7.18 <Badge text="测试版" type="info" />
|
||||
|
||||
- 测试了 .NET 8 在 WindowsApp 应用中的安装流程
|
||||
|
||||
## 1.7.17
|
||||
|
||||
- 修复
|
||||
@@ -109,7 +150,7 @@ comment: false
|
||||
- 优化
|
||||
- 优化了客户端中胡桃云账号修改密码和注销账号的操作逻辑
|
||||
|
||||
## 1.7.14 <Badge text="hotfix" type="tip" />
|
||||
## 1.7.14 <Badge text="hotfix" type="warning" />
|
||||
|
||||
- 修复了部分功能在打开对话框时会崩溃的问题 [#1052](https://github.com/DGP-Studio/Snap.Hutao/issues/1052) [#1054](https://github.com/DGP-Studio/Snap.Hutao/issues/1054)
|
||||
|
||||
@@ -132,7 +173,7 @@ comment: false
|
||||
- 重新设计了启动游戏页面的 UI
|
||||
- 用户现在可以在高级启动器中选择游戏启动参数
|
||||
|
||||
## 1.7.11 <Badge text="hotfix" type="tip" />
|
||||
## 1.7.11 <Badge text="hotfix" type="warning" />
|
||||
|
||||
- 修复了游戏启动器中窗口设置的错误 (hotfix)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user