mirror of
https://github.com/rustdesk/doc.rustdesk.com.git
synced 2025-02-05 04:49:47 +01:00
Merge pull request #4 from 21pages/master
and windows build and some build error solutions
This commit is contained in:
RustDesk
GitHub
commit
fbc097d685
6
content/dev/build/faq/_index.de.md
Normal file
6
content/dev/build/faq/_index.de.md
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
---
|
||||||
|
title: FAQ
|
||||||
|
weight: 20
|
||||||
|
---
|
||||||
|
|
||||||
|
[English](/docs/en/dev/build/faq)
|
||||||
75
content/dev/build/faq/_index.en.md
Normal file
75
content/dev/build/faq/_index.en.md
Normal file
@ -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`
|
||||||
6
content/dev/build/faq/_index.fr.md
Normal file
6
content/dev/build/faq/_index.fr.md
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
---
|
||||||
|
title: FAQ
|
||||||
|
weight: 20
|
||||||
|
---
|
||||||
|
|
||||||
|
[English](/docs/en/dev/build/faq)
|
||||||
6
content/dev/build/faq/_index.it.md
Normal file
6
content/dev/build/faq/_index.it.md
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
---
|
||||||
|
title: FAQ
|
||||||
|
weight: 20
|
||||||
|
---
|
||||||
|
|
||||||
|
[English](/docs/en/dev/build/faq)
|
||||||
6
content/dev/build/faq/_index.ja.md
Normal file
6
content/dev/build/faq/_index.ja.md
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
---
|
||||||
|
title: FAQ
|
||||||
|
weight: 20
|
||||||
|
---
|
||||||
|
|
||||||
|
[English](/docs/en/dev/build/faq)
|
||||||
6
content/dev/build/faq/_index.pt.md
Normal file
6
content/dev/build/faq/_index.pt.md
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
---
|
||||||
|
title: FAQ
|
||||||
|
weight: 20
|
||||||
|
---
|
||||||
|
|
||||||
|
[English](/docs/en/dev/build/faq)
|
||||||
6
content/dev/build/faq/_index.ru.md
Normal file
6
content/dev/build/faq/_index.ru.md
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
---
|
||||||
|
title: FAQ
|
||||||
|
weight: 20
|
||||||
|
---
|
||||||
|
|
||||||
|
[English](/docs/en/dev/build/faq)
|
||||||
58
content/dev/build/faq/_index.zh-cn.md
Normal file
58
content/dev/build/faq/_index.zh-cn.md
Normal file
@ -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`
|
||||||
75
content/dev/build/faq/_index.zh-tw.md
Normal file
75
content/dev/build/faq/_index.zh-tw.md
Normal file
@ -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`
|
||||||
@ -3,4 +3,48 @@ title: Windows
|
|||||||
weight: 20
|
weight: 20
|
||||||
---
|
---
|
||||||
|
|
||||||
***Underway***
|
## 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
|
||||||
|
```
|
||||||
|
|
||||||
|
|||||||
@ -3,4 +3,48 @@ title: Windows
|
|||||||
weight: 20
|
weight: 20
|
||||||
---
|
---
|
||||||
|
|
||||||
[English](/docs/en/dev/build/windows)
|
## 依赖
|
||||||
|
|
||||||
|
### 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
|
||||||
|
```
|
||||||
|
|
||||||
|
|||||||
@ -3,4 +3,47 @@ title: Windows
|
|||||||
weight: 20
|
weight: 20
|
||||||
---
|
---
|
||||||
|
|
||||||
[English](/docs/en/dev/build/windows)
|
## 依賴
|
||||||
|
|
||||||
|
### 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
|
||||||
|
```
|
||||||
Loading…
Reference in New Issue
Block a user