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 diff --git a/content/dev/build/windows/_index.en.md b/content/dev/build/windows/_index.en.md index 8251467..9aeef0c 100644 --- a/content/dev/build/windows/_index.en.md +++ b/content/dev/build/windows/_index.en.md @@ -3,4 +3,48 @@ title: Windows weight: 20 --- -***Underway*** \ No newline at end of file +## Dependencies + +### c++ build environment + +Download [msvc](https://visualstudio.microsoft.com/) and install. + +### Rust develop environment +Download [rustup-init.exe](https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe) and install. + +### vcpkg + +Use `git-bash` to run the following commands， download `vcpkg`, install `libvpx`, `libyuv`, `opus`. + +```shell + git clone https://github.com/microsoft/vcpkg + cd vcpkg + git checkout 2021.12.01 + cd .. + vcpkg/bootstrap-vcpkg.bat + export VCPKG_ROOT=$PWD/vcpkg + vcpkg/vcpkg install libvpx:x64-windows-static libyuv:x64-windows-static opus:x64-windows-static +``` + +Add environment variable `VCPKG_ROOT`=`vcpkg_dir`. + +### sciter + +Desktop versions use [sciter](https://sciter.com/) for GUI, please download [sciter.dll](https://raw.githubusercontent.com/c-smile/sciter-sdk/master/bin.win/x64/sciter.dll) + +### llvm + +rust-bindgen depends on clang, download [llvm](https://github.com/llvm/llvm-project/releases) and install，add environment variable `LIBCLANG_PATH`=`llvm_install_dir/bin`. + + + +## Build + +```sh +git clone https://github.com/rustdesk/rustdesk +cd rustdesk +mkdir -p target/debug +mv sciter.dll target/debug +cargo run +``` + diff --git a/content/dev/build/windows/_index.zh-cn.md b/content/dev/build/windows/_index.zh-cn.md index 4ca1848..d1834bb 100644 --- a/content/dev/build/windows/_index.zh-cn.md +++ b/content/dev/build/windows/_index.zh-cn.md @@ -3,4 +3,48 @@ title: Windows weight: 20 --- -[English](/docs/en/dev/build/windows) \ No newline at end of file +## 依赖 + +### c++编译环境 + +推荐下载[msvc](https://visualstudio.microsoft.com/)并安装 + +### Rust 开发环境 +下载[rustup-init.exe](https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe)并安装 + +### vcpkg + +使用`git-bash`运行下列命令, 下载`vcpkg`, 安装`libvpx`, `libyuv`, `opus` + +```shell + git clone https://github.com/microsoft/vcpkg + cd vcpkg + git checkout 2021.12.01 + cd .. + vcpkg/bootstrap-vcpkg.bat + export VCPKG_ROOT=$PWD/vcpkg + vcpkg/vcpkg install libvpx:x64-windows-static libyuv:x64-windows-static opus:x64-windows-static +``` + +添加环境变量`VCPKG_ROOT`=`vcpkg_dir` + +### sciter + +桌面版本使用[sciter](https://sciter.com/) , 下载动态库[sciter.dll](https://raw.githubusercontent.com/c-smile/sciter-sdk/master/bin.win/x64/sciter.dll) + +### llvm + +rust-bindgen依赖于clang, 下载[llvm](https://github.com/llvm/llvm-project/releases)并安装， 添加环境变量`LIBCLANG_PATH`，值为`llvm_install_dir/bin` + + + +## 构建 + +```sh +git clone https://github.com/rustdesk/rustdesk +cd rustdesk +mkdir -p target/debug +mv sciter.dll target/debug +cargo run +``` + diff --git a/content/dev/build/windows/_index.zh-tw.md b/content/dev/build/windows/_index.zh-tw.md index 4ca1848..9291a5f 100644 --- a/content/dev/build/windows/_index.zh-tw.md +++ b/content/dev/build/windows/_index.zh-tw.md @@ -3,4 +3,47 @@ title: Windows weight: 20 --- -[English](/docs/en/dev/build/windows) \ No newline at end of file +## 依賴 + +### c++編譯環境 + +推薦下載[msvc](https://visualstudio.microsoft.com/)並安裝 + +### Rust 開發環境 +下載[rustup-init.exe](https://static.rust-lang.org/rustup/dist/x86_64-pc-windows-msvc/rustup-init.exe)並安裝 + +### vcpkg + +使用`git-bash`運行下列命令, 下載`vcpkg`, 安裝`libvpx`, `libyuv`, `opus` + +```shell + git clone https://github.com/microsoft/vcpkg + cd vcpkg + git checkout 2021.12.01 + cd .. + vcpkg/bootstrap-vcpkg.bat + export VCPKG_ROOT=$PWD/vcpkg + vcpkg/vcpkg install libvpx:x64-windows-static libyuv:x64-windows-static opus:x64-windows-static +``` + +添加環境變量`VCPKG_ROOT`=`vcpkg_dir` + +### sciter + +桌面版本使用[sciter](https://sciter.com/) , 下載動態庫[sciter.dll](https://raw.githubusercontent.com/c-smile/sciter-sdk/master/bin.win/x64/sciter.dll) + +### llvm + +rust-bindgen依赖于clang, 下載[llvm](https://github.com/llvm/llvm-project/releases)並安裝， 添加環境變量`LIBCLANG_PATH`， 值為`llvm_install_dir/bin` + + + +## 構建 + +```sh +git clone https://github.com/rustdesk/rustdesk +cd rustdesk +mkdir -p target/debug +mv sciter.dll target/debug +cargo run +``` \ No newline at end of file