From 2dba7e8458bf6c72888fd98220df6cee76e69cd8 Mon Sep 17 00:00:00 2001
From: Leilei Chui <46757452+LeileiChui@users.noreply.github.com>
Date: Mon, 17 Jun 2024 11:01:54 +0800
Subject: [PATCH] WIP: feature/add_code_sign_doc (#2512)

* WIP: feature/add_code_sign_doc

* Add documentation on "how to resolve the issue of macOS blocking the VNote application from opening".

* WIP: add more information and format markdown
---
 ...70\350\247\201\351\227\256\351\242\230.md" | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git "a/zh_cn/docs/\347\224\250\346\210\267/\345\270\270\350\247\201\351\227\256\351\242\230.md" "b/zh_cn/docs/\347\224\250\346\210\267/\345\270\270\350\247\201\351\227\256\351\242\230.md"
index af89e215c9..37a103681c 100644
--- "a/zh_cn/docs/\347\224\250\346\210\267/\345\270\270\350\247\201\351\227\256\351\242\230.md"
+++ "b/zh_cn/docs/\347\224\250\346\210\267/\345\270\270\350\247\201\351\227\256\351\242\230.md"
@@ -28,3 +28,29 @@ this.mathJaxScript = 'file://c:/Users/foo/mathjax/tex-svg.js';
 ![](vx_images/3831753136437.png)
 
 每一步操作都需要重启VNote来验证是否有用。
+
+## macOS 下无法打开 App
+打开 App 时弹出对话框，提示
+> Apple 无法验证“VNote.app”是否包含可能危害 Mac 安全或泄漏隐私的恶意软件。
+
+macOS 中包含一项名为“[门禁](https://support.apple.com/zh-cn/102445)”的技术，旨在确保只有受信任的软件才能在 Mac 上运行。你可以尝试以下方案来解决问题。
+
+1. 首次打开 Vnote App，弹出对话框后点击“完成”按钮关闭对话框。打开“系统设置”，点按“隐私与安全性”，向下滚动，然后点按“仍要打开”按钮，即可启动 Vnote，且不再受阻止。
+
+2. 执行以下命令，对 Vnote 进行签名。
+
+    ```bash
+    # 移除指定应用的所有扩展属性，包括导致应用被隔离的属性
+    # xattr 是 macOS 系统中用于管理文件扩展属性的命令
+    # -c 选项表示清除所有的扩展属性
+    # -r 选项表示递归处理，即包括指定目录下的所有文件和子目录
+    xattr -cr '/Applications/VNote.app'
+
+    # 重新签名指定的应用
+    # codesign 是 macOS 系统中用于给应用程序签名的命令
+    # --force 选项表示强制重新签名，即使之前已经签过名
+    # --deep 选项表示递归签名应用内的所有可执行文件和框架
+    # --sign - 选项表示使用一个匿名的证书进行签名
+    # 这通常用于去除应用程序的现有签名，或者在没有有效开发者证书的情况下重新签名应用
+    codesign --force --deep --sign - '/Applications/VNote.app'
+    ```