Browse Source

update docs

ruki 3 năm trước cách đây
mục cha
commit
8e8a972378
5 tập tin đã thay đổi với 179 bổ sung112 xóa
  1. 28 5
      guide/faq.md
  2. 18 7
      mirror/guide/faq.html
  3. 12 0
      mirror/zh-cn/guide/faq.html
  4. 100 100
      sitemap.xml
  5. 21 0
      zh-cn/guide/faq.md

+ 28 - 5
guide/faq.md

@@ -213,7 +213,7 @@ $ git clone https://github.com/xmake-io/xmake-repo.git
 $ xmake l scripts/test.lua -vD --shallow zlib
 ```
 
-Using the test.lua script command above to debug packages, we can repeatedly install and test the specified package. `` --shallow` tells Xmake not to repeat the full installation of all its dependencies for each test, but only to test the current package.
+Using the test.lua script command above to debug packages, we can repeatedly install and test the specified package. `--shallow` tells Xmake not to repeat the full installation of all its dependencies for each test, but only to test the current package.
 
 We can also test specific platforms, architectures, build modes, vs_runtime and dynamic libraries, static libraries etc.
 
@@ -226,12 +226,35 @@ $ xmake l scripts/test.lua -vD --shallow -m debug zlib
 
 ### Debugging local package source code
 
-Sometimes, due to problems with the package source and build scripts, we need to modify some code in order to continue testing the installation, and it would be very tedious to go through the debugging changes in on_install by adding_patches/io.replace.
+Sometimes, due to problems with the package source and build scripts, we need to modify some code in order to continue testing the installation,
+and it would be very tedious to go through the debugging changes in on_install by adding_patches/io.replace.
 
-Therefore, we can specify `-d package_sourcedir` to allow the test script to go directly to our pre-downloaded package source directory and test the build installation without our code changes being reset each time.
+Therefore, we can specify `-d package_sourcedir` to allow the test script to go directly to
+our pre-downloaded package source directory and test the build installation without our code changes being reset each time.
 
-``bash
+```bash
 $ xmake l scripts/test.lua -vD --shallow -d /tmp/zlib-1.2.11 zlib
 ```
 
-Once the changes have been debugged, we then generate a patch file based on the changes via ``git diff > fix.patch`` and configure the patch package to be applied via ``add_patches`` to fix the package installation.
+Once the changes have been debugged, we then generate a patch file based on the changes via `git diff > fix.patch`
+and configure the patch package to be applied via `add_patches` to fix the package installation.
+
+## What should I do if the download package prompts for a certificate verification failure?
+
+```bash
+curl: (60) SSL certificate problem: unable to get local issuer certificate
+More details here: https://curl.se/docs/sslcerts.html
+
+curl failed to verify the legitimacy of the server and therefore could not
+To learn more about this situation and
+To learn more about this situation and how to fix it, please visit the web page mentioned above.
+```
+
+If you encounter the above certificate validation problem when using Xmake to install dependencies, you can try updating the curl certificate to fix it, or just disable certificate validation in the global configuration to bypass it.
+
+```bash
+$ xmake g --insecure-ssl=y
+```
+
+Of course, disabling certificate validation poses some security risks, but the good news is that packages in the xmake-repo repository have a strict sha256 checksum.
+Even if the download is hijacked, it will eventually be detected by xmake's sha256 checksum and treated as an invalid download.

+ 18 - 7
mirror/guide/faq.html

@@ -204,7 +204,7 @@ $ source scripts/srcenv.profile
 <pre><code class="lang-bash">$ git clone https://github.com/xmake-io/xmake-repo.git
 $ xmake l scripts/test.lua -vD --shallow zlib
 </code></pre>
-<p>Using the test.lua script command above to debug packages, we can repeatedly install and test the specified package. <code></code> --shallow` tells Xmake not to repeat the full installation of all its dependencies for each test, but only to test the current package.</p>
+<p>Using the test.lua script command above to debug packages, we can repeatedly install and test the specified package. <code>--shallow</code> tells Xmake not to repeat the full installation of all its dependencies for each test, but only to test the current package.</p>
 <p>We can also test specific platforms, architectures, build modes, vs_runtime and dynamic libraries, static libraries etc.</p>
 <pre><code class="lang-bash">$ xmake l scripts/test.lua -vD --shallow -p mingw --mingw=/xxx/sdk zlib
 $ xmake l scripts/test.lua -vD --shallow -p iphoneos -a arm64 zlib
@@ -212,12 +212,23 @@ $ xmake l scripts/test.lua -vD --shallow -k shared --vs_runtime=MD zlib
 $ xmake l scripts/test.lua -vD --shallow -m debug zlib
 </code></pre>
 <h3 id="debugginglocalpackagesourcecode">Debugging local package source code</h3>
-<p>Sometimes, due to problems with the package source and build scripts, we need to modify some code in order to continue testing the installation, and it would be very tedious to go through the debugging changes in on_install by adding_patches/io.replace.</p>
-<p>Therefore, we can specify <code>-d package_sourcedir</code> to allow the test script to go directly to our pre-downloaded package source directory and test the build installation without our code changes being reset each time.</p>
-<p><code>bash
-$ xmake l scripts/test.lua -vD --shallow -d /tmp/zlib-1.2.11 zlib
-`</code></p>
-<p>Once the changes have been debugged, we then generate a patch file based on the changes via <code>git diff > fix.patch</code> and configure the patch package to be applied via <code>add_patches</code> to fix the package installation.</p>
+<p>Sometimes, due to problems with the package source and build scripts, we need to modify some code in order to continue testing the installation,<br>and it would be very tedious to go through the debugging changes in on_install by adding_patches/io.replace.</p>
+<p>Therefore, we can specify <code>-d package_sourcedir</code> to allow the test script to go directly to<br>our pre-downloaded package source directory and test the build installation without our code changes being reset each time.</p>
+<pre><code class="lang-bash">$ xmake l scripts/test.lua -vD --shallow -d /tmp/zlib-1.2.11 zlib
+</code></pre>
+<p>Once the changes have been debugged, we then generate a patch file based on the changes via <code>git diff > fix.patch</code><br>and configure the patch package to be applied via <code>add_patches</code> to fix the package installation.</p>
+<h2 id="whatshouldidoifthedownloadpackagepromptsforacertificateverificationfailure">What should I do if the download package prompts for a certificate verification failure?</h2>
+<pre><code class="lang-bash">curl: (60) SSL certificate problem: unable to get local issuer certificate
+More details here: https://curl.se/docs/sslcerts.html
+
+curl failed to verify the legitimacy of the server and therefore could not
+To learn more about this situation and
+To learn more about this situation and how to fix it, please visit the web page mentioned above.
+</code></pre>
+<p>If you encounter the above certificate validation problem when using Xmake to install dependencies, you can try updating the curl certificate to fix it, or just disable certificate validation in the global configuration to bypass it.</p>
+<pre><code class="lang-bash">$ xmake g --insecure-ssl=y
+</code></pre>
+<p>Of course, disabling certificate validation poses some security risks, but the good news is that packages in the xmake-repo repository have a strict sha256 checksum.<br>Even if the download is hijacked, it will eventually be detected by xmake&#39;s sha256 checksum and treated as an invalid download.</p>
 </article>
 </body>
 </html>

+ 12 - 0
mirror/zh-cn/guide/faq.html

@@ -218,6 +218,18 @@ $ xmake l scripts/test.lua -vD --shallow -m debug zlib
 <pre><code class="lang-bash">$ xmake l scripts/test.lua -vD --shallow -d /tmp/zlib-1.2.11 zlib
 </code></pre>
 <p>等修改调试通过后,我们再根据改动,通过 <code>git diff > fix.patch</code> 生成补丁文件,通过 <code>add_patches</code> 配置应用补丁包,来修复包的安装。</p>
+<h2 id="">下载包提示证书校验失败怎么办?</h2>
+<pre><code class="lang-bash">curl: (60) SSL certificate problem: unable to get local issuer certificate
+More details here: https://curl.se/docs/sslcerts.html
+
+curl failed to verify the legitimacy of the server and therefore could not
+establish a secure connection to it. To learn more about this situation and
+how to fix it, please visit the web page mentioned above.
+</code></pre>
+<p>如果你在使用 Xmake 安装依赖包时候,遇到上面的证书验证问题,你可以尝试更新 curl 证书去修复它,或者直接全局配置禁用证书验证来绕过它。</p>
+<pre><code class="lang-bash">$ xmake g --insecure-ssl=y
+</code></pre>
+<p>当然,禁用证书验证会带来一定的安全性风险,不过好在 xmake-repo 仓库中的包,有严格的 sha256 校验,<br>即使下载被劫持,最终也会 xmake 的 sha256 校验检测到,作为无效下载。</p>
 </article>
 </body>
 </html>

+ 100 - 100
sitemap.xml

@@ -12,502 +12,502 @@
 
 <url>
   <loc>https://xmake.io/mirror/guide/project_examples.html</loc>
-  <lastmod>2022-11-07T16:29:33+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:36+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/guide/quickstart.html</loc>
-  <lastmod>2022-11-07T16:29:33+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:36+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/guide/faq.html</loc>
-  <lastmod>2022-11-07T16:29:33+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:37+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/guide/configuration.html</loc>
-  <lastmod>2022-11-07T16:29:33+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:37+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/guide/syntax_description.html</loc>
-  <lastmod>2022-11-07T16:29:34+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:37+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/guide/installation.html</loc>
-  <lastmod>2022-11-07T16:29:34+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:37+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/features/remote_build.html</loc>
-  <lastmod>2022-11-07T16:29:34+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:37+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/features/unity_build.html</loc>
-  <lastmod>2022-11-07T16:29:34+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:38+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/features/distcc_build.html</loc>
-  <lastmod>2022-11-07T16:29:34+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:38+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/features/trybuild.html</loc>
-  <lastmod>2022-11-07T16:29:35+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:38+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/features/autogen.html</loc>
-  <lastmod>2022-11-07T16:29:35+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:38+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/features/build_cache.html</loc>
-  <lastmod>2022-11-07T16:29:35+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:39+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/plugin/plugin_development.html</loc>
-  <lastmod>2022-11-07T16:29:35+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:39+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/plugin/more_plugins.html</loc>
-  <lastmod>2022-11-07T16:29:36+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:39+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/plugin/builtin_plugins.html</loc>
-  <lastmod>2022-11-07T16:29:36+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:39+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/about/awesome.html</loc>
-  <lastmod>2022-11-07T16:29:36+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:39+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/about/technical_support.html</loc>
-  <lastmod>2022-11-07T16:29:36+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:40+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/about/changelog.html</loc>
-  <lastmod>2022-11-07T16:29:36+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:40+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/about/contact.html</loc>
-  <lastmod>2022-11-07T16:29:37+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:40+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/about/introduction.html</loc>
-  <lastmod>2022-11-07T16:29:37+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:40+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/about/who_is_using_xmake.html</loc>
-  <lastmod>2022-11-07T16:29:37+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:41+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/about/sponsor.html</loc>
-  <lastmod>2022-11-07T16:29:37+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:41+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/index.html</loc>
-  <lastmod>2022-11-07T16:29:38+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:41+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/guide/project_examples.html</loc>
-  <lastmod>2022-11-07T16:29:38+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:41+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/guide/quickstart.html</loc>
-  <lastmod>2022-11-07T16:29:38+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:41+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/guide/faq.html</loc>
-  <lastmod>2022-11-07T16:29:38+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:42+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/guide/configuration.html</loc>
-  <lastmod>2022-11-07T16:29:38+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:42+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/guide/syntax_description.html</loc>
-  <lastmod>2022-11-07T16:29:41+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:42+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/guide/installation.html</loc>
-  <lastmod>2022-11-07T16:29:41+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:42+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/features/remote_build.html</loc>
-  <lastmod>2022-11-07T16:29:42+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:43+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/features/unity_build.html</loc>
-  <lastmod>2022-11-07T16:29:42+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:43+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/features/distcc_build.html</loc>
-  <lastmod>2022-11-07T16:29:42+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:43+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/features/trybuild.html</loc>
-  <lastmod>2022-11-07T16:29:42+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:43+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/features/autogen.html</loc>
-  <lastmod>2022-11-07T16:29:43+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:44+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/features/build_cache.html</loc>
-  <lastmod>2022-11-07T16:29:43+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:44+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/plugin/plugin_development.html</loc>
-  <lastmod>2022-11-07T16:29:43+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:44+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/plugin/more_plugins.html</loc>
-  <lastmod>2022-11-07T16:29:43+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:44+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/plugin/builtin_plugins.html</loc>
-  <lastmod>2022-11-07T16:29:44+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:45+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/about/awesome.html</loc>
-  <lastmod>2022-11-07T16:29:44+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:45+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/about/technical_support.html</loc>
-  <lastmod>2022-11-07T16:29:44+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:45+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/about/changelog.html</loc>
-  <lastmod>2022-11-07T16:29:44+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:45+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/about/contact.html</loc>
-  <lastmod>2022-11-07T16:29:44+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:45+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/about/peripheral_items.html</loc>
-  <lastmod>2022-11-07T16:29:45+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:46+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/about/introduction.html</loc>
-  <lastmod>2022-11-07T16:29:45+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:46+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/about/who_is_using_xmake.html</loc>
-  <lastmod>2022-11-07T16:29:45+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:46+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/about/sponsor.html</loc>
-  <lastmod>2022-11-07T16:29:45+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:46+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/about/course.html</loc>
-  <lastmod>2022-11-07T16:29:46+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:46+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/index.html</loc>
-  <lastmod>2022-11-07T16:29:46+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:47+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/getting_started.html</loc>
-  <lastmod>2022-11-07T16:29:46+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:47+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/specification.html</loc>
-  <lastmod>2022-11-07T16:29:46+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:47+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/builtin_variables.html</loc>
-  <lastmod>2022-11-07T16:29:47+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:47+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/conditions.html</loc>
-  <lastmod>2022-11-07T16:29:47+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:47+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/custom_rule.html</loc>
-  <lastmod>2022-11-07T16:29:47+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:48+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/target_instance.html</loc>
-  <lastmod>2022-11-07T16:29:47+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:48+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/project_target.html</loc>
-  <lastmod>2022-11-07T16:29:48+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:48+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/builtin_modules.html</loc>
-  <lastmod>2022-11-07T16:29:48+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:48+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/custom_toolchain.html</loc>
-  <lastmod>2022-11-07T16:29:48+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:49+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/plugin_task.html</loc>
-  <lastmod>2022-11-07T16:29:49+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:49+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/package_dependencies.html</loc>
-  <lastmod>2022-11-07T16:29:49+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:49+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/configuration_option.html</loc>
-  <lastmod>2022-11-07T16:29:49+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:49+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/extension_modules.html</loc>
-  <lastmod>2022-11-07T16:29:49+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:49+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/helper_interfaces.html</loc>
-  <lastmod>2022-11-07T16:29:50+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:50+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/global_interfaces.html</loc>
-  <lastmod>2022-11-07T16:29:50+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:50+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/package_instance.html</loc>
-  <lastmod>2022-11-07T16:29:50+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:50+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/manual/option_instance.html</loc>
-  <lastmod>2022-11-07T16:29:51+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:50+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/theme/builtin_themes.html</loc>
-  <lastmod>2022-11-07T16:29:51+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:50+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/theme/switch_theme.html</loc>
-  <lastmod>2022-11-07T16:29:51+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:51+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/package/local_3rd_source_library.html</loc>
-  <lastmod>2022-11-07T16:29:51+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:51+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/package/local_package_old.html</loc>
-  <lastmod>2022-11-07T16:29:52+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:51+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/package/local_package.html</loc>
-  <lastmod>2022-11-07T16:29:52+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:51+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/package/system_package.html</loc>
-  <lastmod>2022-11-07T16:29:52+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:51+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/package/remote_package.html</loc>
-  <lastmod>2022-11-07T16:29:52+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:52+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/toolchain/remote_toolchain.html</loc>
-  <lastmod>2022-11-07T16:29:53+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:52+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/zh-cn/toolchain/builtin_toolchains.html</loc>
-  <lastmod>2022-11-07T16:29:53+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:52+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/getting_started.html</loc>
-  <lastmod>2022-11-07T16:29:53+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:52+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/specification.html</loc>
-  <lastmod>2022-11-07T16:29:53+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:52+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/builtin_variables.html</loc>
-  <lastmod>2022-11-07T16:29:53+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:52+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/conditions.html</loc>
-  <lastmod>2022-11-07T16:29:54+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:53+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/custom_rule.html</loc>
-  <lastmod>2022-11-07T16:29:54+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:53+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/target_instance.html</loc>
-  <lastmod>2022-11-07T16:29:54+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:53+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/project_target.html</loc>
-  <lastmod>2022-11-07T16:29:55+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:53+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/builtin_modules.html</loc>
-  <lastmod>2022-11-07T16:29:55+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:54+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/custom_toolchain.html</loc>
-  <lastmod>2022-11-07T16:29:55+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:54+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/plugin_task.html</loc>
-  <lastmod>2022-11-07T16:29:55+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:54+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/package_dependencies.html</loc>
-  <lastmod>2022-11-07T16:29:56+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:54+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/configuration_option.html</loc>
-  <lastmod>2022-11-07T16:29:56+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:54+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/extension_modules.html</loc>
-  <lastmod>2022-11-07T16:29:56+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:55+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/helper_interfaces.html</loc>
-  <lastmod>2022-11-07T16:29:57+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:55+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/global_interfaces.html</loc>
-  <lastmod>2022-11-07T16:29:57+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:55+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/package_instance.html</loc>
-  <lastmod>2022-11-07T16:29:57+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:55+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/manual/option_instance.html</loc>
-  <lastmod>2022-11-07T16:29:57+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:55+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/theme/builtin_themes.html</loc>
-  <lastmod>2022-11-07T16:29:58+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:56+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/theme/switch_theme.html</loc>
-  <lastmod>2022-11-07T16:29:58+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:56+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/package/local_3rd_source_library.html</loc>
-  <lastmod>2022-11-07T16:29:58+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:56+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/package/local_package_old.html</loc>
-  <lastmod>2022-11-07T16:29:58+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:56+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/package/local_package.html</loc>
-  <lastmod>2022-11-07T16:29:59+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:56+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/package/system_package.html</loc>
-  <lastmod>2022-11-07T16:29:59+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:57+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/package/remote_package.html</loc>
-  <lastmod>2022-11-07T16:29:59+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:57+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/toolchain/remote_toolchain.html</loc>
-  <lastmod>2022-11-07T16:29:59+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:57+08:00</lastmod>
 </url>
 
 <url>
   <loc>https://xmake.io/mirror/toolchain/builtin_toolchains.html</loc>
-  <lastmod>2022-11-07T16:30:00+08:00</lastmod>
+  <lastmod>2022-11-07T16:48:57+08:00</lastmod>
 </url>
 
 </urlset>

+ 21 - 0
zh-cn/guide/faq.md

@@ -237,3 +237,24 @@ $ xmake l scripts/test.lua -vD --shallow -d /tmp/zlib-1.2.11 zlib
 ```
 
 等修改调试通过后,我们再根据改动,通过 `git diff > fix.patch` 生成补丁文件,通过 `add_patches` 配置应用补丁包,来修复包的安装。
+
+## 下载包提示证书校验失败怎么办?
+
+```bash
+curl: (60) SSL certificate problem: unable to get local issuer certificate
+More details here: https://curl.se/docs/sslcerts.html
+
+curl failed to verify the legitimacy of the server and therefore could not
+establish a secure connection to it. To learn more about this situation and
+how to fix it, please visit the web page mentioned above.
+```
+
+如果你在使用 Xmake 安装依赖包时候,遇到上面的证书验证问题,你可以尝试更新 curl 证书去修复它,或者直接全局配置禁用证书验证来绕过它。
+
+```bash
+$ xmake g --insecure-ssl=y
+```
+
+当然,禁用证书验证会带来一定的安全性风险,不过好在 xmake-repo 仓库中的包,有严格的 sha256 校验,
+即使下载被劫持,最终也会 xmake 的 sha256 校验检测到,作为无效下载。
+