From edd08576713d80913de06ad7b7402992f0d3bcd2 Mon Sep 17 00:00:00 2001 From: 21pages Date: Mon, 9 May 2022 11:08:18 +0800 Subject: [PATCH] build FAQ Signed-off-by: 21pages --- content/dev/build/faq/_index.de.md | 6 +++ content/dev/build/faq/_index.en.md | 75 +++++++++++++++++++++++++++ content/dev/build/faq/_index.fr.md | 6 +++ content/dev/build/faq/_index.it.md | 6 +++ content/dev/build/faq/_index.ja.md | 6 +++ content/dev/build/faq/_index.pt.md | 6 +++ content/dev/build/faq/_index.ru.md | 6 +++ content/dev/build/faq/_index.zh-cn.md | 58 +++++++++++++++++++++ content/dev/build/faq/_index.zh-tw.md | 75 +++++++++++++++++++++++++++ 9 files changed, 244 insertions(+) create mode 100644 content/dev/build/faq/_index.de.md create mode 100644 content/dev/build/faq/_index.en.md create mode 100644 content/dev/build/faq/_index.fr.md create mode 100644 content/dev/build/faq/_index.it.md create mode 100644 content/dev/build/faq/_index.ja.md create mode 100644 content/dev/build/faq/_index.pt.md create mode 100644 content/dev/build/faq/_index.ru.md create mode 100644 content/dev/build/faq/_index.zh-cn.md create mode 100644 content/dev/build/faq/_index.zh-tw.md diff --git a/content/dev/build/faq/_index.de.md b/content/dev/build/faq/_index.de.md new file mode 100644 index 0000000..f682724 --- /dev/null +++ b/content/dev/build/faq/_index.de.md @@ -0,0 +1,6 @@ +--- +title: FAQ +weight: 20 +--- + +[English](/docs/en/dev/build/faq) \ No newline at end of file diff --git a/content/dev/build/faq/_index.en.md b/content/dev/build/faq/_index.en.md new file mode 100644 index 0000000..d43fe98 --- /dev/null +++ b/content/dev/build/faq/_index.en.md @@ -0,0 +1,75 @@ +--- +title: FAQ +weight: 20 +--- + +## vcpkg download package failed + +### error + +``` + -- Fetching https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b... + CMake Error at scripts/cmake/vcpkg_execute_required_process.cmake:127 (message): + Command failed: D:/program/Git/mingw64/bin/git.exe fetch https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b --depth 1 -n +``` + +### solution + +Use a browser to download `https://chromium.googlesource.com/libyuv/libyuv/+archive/287158925b0e03ea4499a18b4e08478c5781541b.tar.gz`, then move it into `vcpkg/downloads` and reinstall. + + + +## package in Cargo.lock not exist + +### error + +``` +$ cargo run + Updating git repository `https://github.com/open-trade/confy` + warning: spurious network error (2 tries remaining): failed to receive response: Operation Timeout + ; class=Os (2) + error: failed to get `confy` as a dependency of package `hbb_common v0.1.0 (D:\rustdesk\rustdesk\rustdesk\libs\hbb_common)` + + Caused by: + failed to load source for dependency `confy` + + Caused by: + Unable to update https://github.com/open-trade/confy#27fa1294 + + Caused by: + object not found - no match for id (27fa12941291b44ccd856aef4a5452c1eb646047); class=Odb (9); code=NotFound (-3) +``` + +Maybe the author used `git force push` and the previous commit was overwritten. + +### solution + +`cargo update`, force the package to be updated + + + +## VCPKG_ROOT not set + +### error + +``` +thread 'main' panicked at 'Failed to find package: VcpkgNotFound("No vcpkg installation found. Set the VCPKG_ROOT environment variable or run 'vcpkg integrate install'")', libs\scrap\build.rs:7:45 +``` + +### solution + +Add `VCPKG_ROOT` environment variable, or run with `VCPKG_ROOT=vcpkg_dir cargo run` + + + +## clang not installed, or LIBCLANG_PATH not set + +### error + +``` +thread 'main' panicked at 'Unable to find libclang: "couldn't find any valid shared libraries matching: ['clang.dll', 'libclang.dll'], set the `LIBCLANG_PATH` environment variable to a path where one of these files can be found (invalid: [])"', C:\Users\selfd\.cargo\registry\src\mirrors.ustc.edu.cn-61ef6e0cd06fb9b8\bindgen-0.59.2\src/lib.rs:2144:31 +``` + +### solution + +Install [llvm](https://releases.llvm.org/download.html), Add the `LIBCLANG_PATH` environment variable as `llvm_install_dir/bin` \ No newline at end of file diff --git a/content/dev/build/faq/_index.fr.md b/content/dev/build/faq/_index.fr.md new file mode 100644 index 0000000..f682724 --- /dev/null +++ b/content/dev/build/faq/_index.fr.md @@ -0,0 +1,6 @@ +--- +title: FAQ +weight: 20 +--- + +[English](/docs/en/dev/build/faq) \ No newline at end of file diff --git a/content/dev/build/faq/_index.it.md b/content/dev/build/faq/_index.it.md new file mode 100644 index 0000000..f682724 --- /dev/null +++ b/content/dev/build/faq/_index.it.md @@ -0,0 +1,6 @@ +--- +title: FAQ +weight: 20 +--- + +[English](/docs/en/dev/build/faq) \ No newline at end of file diff --git a/content/dev/build/faq/_index.ja.md b/content/dev/build/faq/_index.ja.md new file mode 100644 index 0000000..f682724 --- /dev/null +++ b/content/dev/build/faq/_index.ja.md @@ -0,0 +1,6 @@ +--- +title: FAQ +weight: 20 +--- + +[English](/docs/en/dev/build/faq) \ No newline at end of file diff --git a/content/dev/build/faq/_index.pt.md b/content/dev/build/faq/_index.pt.md new file mode 100644 index 0000000..f682724 --- /dev/null +++ b/content/dev/build/faq/_index.pt.md @@ -0,0 +1,6 @@ +--- +title: FAQ +weight: 20 +--- + +[English](/docs/en/dev/build/faq) \ No newline at end of file diff --git a/content/dev/build/faq/_index.ru.md b/content/dev/build/faq/_index.ru.md new file mode 100644 index 0000000..f682724 --- /dev/null +++ b/content/dev/build/faq/_index.ru.md @@ -0,0 +1,6 @@ +--- +title: FAQ +weight: 20 +--- + +[English](/docs/en/dev/build/faq) \ No newline at end of file diff --git a/content/dev/build/faq/_index.zh-cn.md b/content/dev/build/faq/_index.zh-cn.md new file mode 100644 index 0000000..9b2db50 --- /dev/null +++ b/content/dev/build/faq/_index.zh-cn.md @@ -0,0 +1,58 @@ +--- +title: 常见问题 +weight: 20 +--- + +## vcpkg下载包失败 +### 错误示例 +``` + -- Fetching https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b... + CMake Error at scripts/cmake/vcpkg_execute_required_process.cmake:127 (message): + Command failed: D:/program/Git/mingw64/bin/git.exe fetch https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b --depth 1 -n +``` +### 解决方法 +使用浏览器下载`https://chromium.googlesource.com/libyuv/libyuv/+archive/287158925b0e03ea4499a18b4e08478c5781541b.tar.gz`, 然后放到`vcpkg/downloads`下， 重新安装. + + + +## Cargo.lock里的版本不存在 +### 错误示例 +``` +$ cargo run + Updating git repository `https://github.com/open-trade/confy` + warning: spurious network error (2 tries remaining): failed to receive response: 操作超时 + ; class=Os (2) + error: failed to get `confy` as a dependency of package `hbb_common v0.1.0 (D:\rustdesk\rustdesk\rustdesk\libs\hbb_common)` + + Caused by: + failed to load source for dependency `confy` + + Caused by: + Unable to update https://github.com/open-trade/confy#27fa1294 + + Caused by: + object not found - no match for id (27fa12941291b44ccd856aef4a5452c1eb646047); class=Odb (9); code=NotFound (-3) +``` +可能作者使用`git force push`覆盖了之前的commit +### 解决方法 +`cargo update`强制更新包 + + + +## VCPKG_ROOT环境变量未设置 +### 错误示例 +``` +thread 'main' panicked at 'Failed to find package: VcpkgNotFound("No vcpkg installation found. Set the VCPKG_ROOT environment variable or run 'vcpkg integrate install'")', libs\scrap\build.rs:7:45 +``` +### 解决办法 +添加VCPKG_ROOT环境变量, 或者使用`VCPKG_ROOT=vcpkg_dir cargo run` + + + +## 未安装clang环境, 或未设置LIBCLANG_PATH环境变量 +### 错误示例 +``` +thread 'main' panicked at 'Unable to find libclang: "couldn't find any valid shared libraries matching: ['clang.dll', 'libclang.dll'], set the `LIBCLANG_PATH` environment variable to a path where one of these files can be found (invalid: [])"', C:\Users\selfd\.cargo\registry\src\mirrors.ustc.edu.cn-61ef6e0cd06fb9b8\bindgen-0.59.2\src/lib.rs:2144:31 +``` +### 解决办法 +安装[llvm](https://releases.llvm.org/download.html), 设置`LIBCLANG_PATH`环境变量为`llvm_install_dir/bin` \ No newline at end of file diff --git a/content/dev/build/faq/_index.zh-tw.md b/content/dev/build/faq/_index.zh-tw.md new file mode 100644 index 0000000..1d4b627 --- /dev/null +++ b/content/dev/build/faq/_index.zh-tw.md @@ -0,0 +1,75 @@ +--- +title: 常見問題 +weight: 20 +--- + +## vcpkg下載包失敗 + +### 錯誤示例 + +``` + -- Fetching https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b... + CMake Error at scripts/cmake/vcpkg_execute_required_process.cmake:127 (message): + Command failed: D:/program/Git/mingw64/bin/git.exe fetch https://chromium.googlesource.com/libyuv/libyuv 287158925b0e03ea4499a18b4e08478c5781541b --depth 1 -n +``` + +### 解決方法 + +使用瀏覽器下載`https://chromium.googlesource.com/libyuv/libyuv/+archive/287158925b0e03ea4499a18b4e08478c5781541b.tar.gz`, 然後放到`vcpkg/downloads`下， 重新安裝. + + + +## Cargo.lock裡的版本不存在 + +### 錯誤示例 + +``` +$ cargo run + Updating git repository `https://github.com/open-trade/confy` + warning: spurious network error (2 tries remaining): failed to receive response: 操作超時 + ; class=Os (2) + error: failed to get `confy` as a dependency of package `hbb_common v0.1.0 (D:\rustdesk\rustdesk\rustdesk\libs\hbb_common)` + + Caused by: + failed to load source for dependency `confy` + + Caused by: + Unable to update https://github.com/open-trade/confy#27fa1294 + + Caused by: + object not found - no match for id (27fa12941291b44ccd856aef4a5452c1eb646047); class=Odb (9); code=NotFound (-3) +``` + +可能作者使用`git force push`覆蓋了之前的commit + +### 解決方法 + +`cargo update`強制更新包 + + + +## VCPKG_ROOT環境變量未設置 + +### 錯誤示例 + +``` +thread 'main' panicked at 'Failed to find package: VcpkgNotFound("No vcpkg installation found. Set the VCPKG_ROOT environment variable or run 'vcpkg integrate install'")', libs\scrap\build.rs:7:45 +``` + +### 解決辦法 + +添加VCPKG_ROOT環境變量, 或者使用`VCPKG_ROOT=vcpkg_dir cargo run` + + + +## 未安裝clang環境, 或未設置LIBCLANG_PATH環境變量 + +### 錯誤示例 + +``` +thread 'main' panicked at 'Unable to find libclang: "couldn't find any valid shared libraries matching: ['clang.dll', 'libclang.dll'], set the `LIBCLANG_PATH` environment variable to a path where one of these files can be found (invalid: [])"', C:\Users\selfd\.cargo\registry\src\mirrors.ustc.edu.cn-61ef6e0cd06fb9b8\bindgen-0.59.2\src/lib.rs:2144:31 +``` + +### 解決辦法 + +安裝[llvm](https://releases.llvm.org/download.html), 設置`LIBCLANG_PATH`環境變量為`llvm_install_dir/bin` \ No newline at end of file