Browse Source

Merge branch 'docs/provide_tips_for_Mac_users' into 'master'

docs: provide tips for Mac users

Closes DOC-3327

See merge request espressif/esp-idf!19245
Wang Zi Yan 3 years ago
parent
commit
8fca591407

+ 6 - 0
docs/en/get-started/linux-macos-setup.rst

@@ -163,6 +163,12 @@ or with Fish shell
     cd ~/esp/esp-idf
     ./install.fish all
 
+.. note::
+   For macOS users, if an error like this is shown during any step::
+
+     <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:xxx)
+
+   You may run ``Install Certificates.command`` in the Python folder of your computer to install certificates. For details, see `Download Error While Installing ESP-IDF Tools <https://github.com/espressif/esp-idf/issues/4775>`_.
 
 Alternative File Downloads
 ~~~~~~~~~~~~~~~~~~~~~~~~~~

+ 7 - 0
docs/zh_CN/get-started/linux-macos-setup.rst

@@ -163,6 +163,13 @@ ESP-IDF 将下载至 ``~/esp/esp-idf``。
     cd ~/esp/esp-idf
     ./install.fish all
 
+.. note::
+    对于 macOS 用户,如您在上述任何步骤中遇到以下错误::
+
+     <urlopen error [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:xxx)
+
+    可运行您电脑 Python 文件夹中的 ``Install Certificates.command`` 安装证书。了解更多信息,请参考 `安装 ESP-IDF 工具时出现的下载错误 <https://github.com/espressif/esp-idf/issues/4775>`_。
+
 
 下载工具备选方案
 ~~~~~~~~~~~~~~~~~~~~~~~~~~