添加 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
2026-03-15 03:53:16 +08:00 · 2024-10-07 21:14:47 +08:00
parent 970a8a692b
commit c5980b99ca
10 changed files with 195 additions and 1 deletions
--- a/docs/macos-gatekeeper/README-EN.md
+++ b/docs/macos-gatekeeper/README-EN.md
@@ -0,0 +1,63 @@
+[中文版本](./README.md)
+
+# Special Tips for macOS Users
+
+Due to Teyvat Guide not being notarized by Apple, some additional steps are required to ensure that Teyvat Guide can run smoothly on the macOS platform.
+
+> Teyvat Guide is an open-source software based on the MIT license, and all source code is hosted on GitHub. If you have concerns about the security of the software, you can review the source code yourself or download and compile it.
+
+## Apple's Related Links on "Allowing Apps from Anywhere" and Gatekeeper
+
+- [Safely open apps on your Mac](https://support.apple.com/102445)
+- [Gatekeeper and runtime protections in macOS](https://support.apple.com/guide/security/sec5599b66df/)
+- [Preventing against malware in macOS](https://support.apple.com/guide/security/sec469d47bd8/)
+
+## Error Prompt
+
+![Error Prompt when Opening Teyvat Guide](./error.png)
+
+Please ensure that Teyvat Guide has been installed, meaning it has been copied to the `/Applications` directory.
+
+> Note: The "enter password" process described below will not display on the console; only a key icon will appear. Please enter the password based on your intuition and press Enter to confirm.
+> ![Display Status when Entering Password](./password.png)
+
+## Method 1: One-Click Script
+
+### Step 1: Download the Script
+
+Download the `one-click.sh` file in this folder, open the terminal, enter `bash /path/to/the/script`, and press Enter. Follow the on-screen instructions.
+
+> `/path/to/the/script` represents the location where the script is downloaded.
+
+### Step 2: Launch Teyvat Guide
+
+Locate the installation location of Teyvat Guide in Finder, **right-click (or hold down the control⌃ key and click)** to choose "Open."
+
+![Launch Teyvat Guide](./open.png)
+
+## Method 2: Manual Operations
+
+During the process, you may be asked to enter a password, where "password" refers to the administrator account password:
+
+1. If you have only one account on your computer, then the "password" is the one you use to log in and unlock your computer;
+2. If you have multiple accounts on your computer, you should know what "password" means here. :-D
+
+### Step 1: Enable "Allow Apps from Anywhere"
+
+Open the terminal, enter `sudo spctl --master-disable` to enable "Allow Apps from Anywhere", and make the selection "Allow applications from **anywhere**" in the "Privacy & Security" section in System Preferences， **you may need to scroll down**.
+
+  ![Enable Allow Apps from Anywhere](./gatekeeper.png)
+
+  ![Secondary Confirmation in System Preferences](./gatekeeper-settings.png)
+
+### Step 2: Clear Gatekeeper Attributes
+
+Enter `sudo xattr -c /Applications/TeyvatGuide.app` in the terminal to clear the Gatekeeper attributes of Teyvat Guide.
+
+![Clear Gatekeeper Attributes](./remove-gatekeeper.png)
+
+### Step 3: Launch Teyvat Guide
+
+Locate the installation location of Teyvat Guide in Finder, **right-click (or hold down the control⌃ key and click)** to choose "Open."
+
+![Launch Teyvat Guide](./open.png)