mirror of
https://github.com/rustdesk/doc.rustdesk.com.git
synced 2025-01-26 07:58:34 +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
|
||||
---
|
||||
|
||||
***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
|
||||
---
|
||||
|
||||
[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
|
||||
---
|
||||
|
||||
[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