添加 macOS 平台门禁属性导致无法打开应用的修复指引 (#130)

* Fix macOS Gatekeeper issue and provide instructions for running Teyvat Guide on macOS

* Update macOS Gatekeeper links in README.md

* Update macOS Gatekeeper links in README.md

* Improve English translation of README-EN in macos-gatekeeper

* Fix language-specific messages in one-click.sh

* Fix language-specific messages in one-click.sh

* Move the support file

* Fix link to macOS Gatekeeper fix guide in README.md

* Fix link to macOS Gatekeeper fix guide in README.md

* Improve English translation

* Update links to macOS Gatekeeper fix guide in README.md
This commit is contained in:
Lucas
2024-10-07 21:14:47 +08:00
committed by GitHub
parent 970a8a692b
commit c5980b99ca
10 changed files with 195 additions and 1 deletions

View File

@@ -0,0 +1,63 @@
[English Version](./README-EN.md)
# 针对 macOS 用户的特殊提示
由于 Teyvat Guide 没有经过苹果官方公证,故需要进行一些额外的操作来确保 Teyvat Guide 能在 macOS 平台正常运行。
> Teyvat Guide 是一个**基于 MIT 协议**的开源软件,所有源代码都托管在 GitHub 上,如果您对软件安全性抱有疑虑,可以自行审查源代码或者下载编译打包。
## Apple 关于任何来源及门禁(`Gatekeeper`)属性的相关链接
- [在 Mac 上安全地打开 App](https://support.apple.com/102445)
- [macOS 中的门禁和运行时保护](https://support.apple.com/guide/security/sec5599b66df/)
- [在 macOS 中防范恶意软件](https://support.apple.com/guide/security/sec469d47bd8/)
## 报错界面
![打开 Teyvat Guide 时的报错界面](./error.png)
下面的所有操作请**确保 Teyvat Guide 已经安装**,即 Teyvat Guide 已经被复制到 `/Applications` 目录下。
> 注:下面所述的“输入密码”过程不会在控制台上显示,仅会显示一个钥匙图标,请~~凭感觉~~输入后按回车键确认。
> ![输入密码时的显示状态](./password.png)
## Method 1 一键脚本
### Step 1 下载脚本
下载此文件夹中的 `one-click.sh`,打开终端,输入`bash /path/to/the/script`后回车,按照屏幕提示操作。
> `/path/to/the/script` 表示下载的脚本的位置。
### Step 2 启动 Teyvat Guide
在访达中找到 Teyvat Guide 的安装位置,**右键或按住键盘上的control⌃并点击选择打开**。
![启动 Teyvat Guide](./open.png)
## Method 2 手动操作
过程中可能会要求输入密码,此处的“密码”指的是管理员账户的密码:
1. 如果你的电脑只有一个账户,那么“密码”就是你登录解锁电脑的密码;
2. 如果你的电脑不止一个账号,那么你应该知道此处“密码”的含义。:-D
### Step 1 开启“任何来源”
打开终端,输入`sudo spctl --master-disable`开启“任何来源”,并在设置中的“安全与隐私”部分进行选择,**你可能需要向下滑动**。
![打开任何来源](./gatekeeper.png)
![设置界面二次确认](./gatekeeper-settings.png)
### Step 2 清除门禁属性
在终端输入`sudo xattr -c /Applications/TeyvatGuide.app`清除 Teyvat Guide 的 `Gatekeeper` 属性。
![清除门禁属性](./remove-gatekeeper.png)
### Step 3 启动 Teyvat Guide
在访达中找到 Teyvat Guide 的安装位置,**右键或按住键盘上的control⌃并点击选择打开**。
![启动 Teyvat Guide](./open.png)