|
|
|
|
@ -1,11 +1,11 @@
|
|
|
|
|
# 构建( Build )缓存
|
|
|
|
|
`cargo build` 的结果会被放入项目根目录下的 `target` 文件夹中，当然，这个位置可以三种方式更改：设置 `CARGO_TARGET_DIR` [环境变量](https://course.rs/cargo/reference/env.html)、[`build.target-dir`](https://course.rs/cargo/reference/configuration.html#buildtarget-dir) 配置项以及 `--target-dir` 命令行参数。
|
|
|
|
|
`cargo build` 的结果会被放入项目根目录下的 `target` 文件夹中，当然，这个位置可以三种方式更改：设置 `CARGO_TARGET_DIR` [环境变量](https://doc.rust-lang.org/stable/cargo/reference/environment-variables.html)、[`build.target-dir`](https://course.rs/cargo/reference/configuration.html#配置文件概览) 配置项以及 `--target-dir` 命令行参数。
|
|
|
|
|
|
|
|
|
|
## target 目录结构
|
|
|
|
|
`target` 目录的结构取决于是否使用 `--target` 标志为特定的平台构建。
|
|
|
|
|
|
|
|
|
|
#### 不使用 --target
|
|
|
|
|
若 `--target` 标志没有指定，`Cargo` 会根据宿主机架构进行构建，构建结果会放入项目根目录下的 `target` 目录中，`target` 下每个子目录中包含了相应的 [`发布配置profile`](cargo/reference/profiles.md) 的构建结果，例如 `release`、`debug` 是自带的`profile`，前者往往用于生产环境，因为会做大量的性能优化，而后者则用于开发环境，此时的编译效率和报错信息是最好的。
|
|
|
|
|
若 `--target` 标志没有指定，`Cargo` 会根据宿主机架构进行构建，构建结果会放入项目根目录下的 `target` 目录中，`target` 下每个子目录中包含了相应的 [`发布配置profile`](https://course.rs/cargo/reference/profiles.html) 的构建结果，例如 `release`、`debug` 是自带的`profile`，前者往往用于生产环境，因为会做大量的性能优化，而后者则用于开发环境，此时的编译效率和报错信息是最好的。
|
|
|
|
|
|
|
|
|
|
除此之外我们还可以定义自己想要的 `profile` ，例如用于测试环境的 `profile`： `test`，用于预发环境的 `profile` ：`pre-prod` 等。
|
|
|
|
|
|
|
|
|
|
@ -30,7 +30,7 @@
|
|
|
|
|
| `target/<triple>/release/` | `target/thumbv7em-none-eabihf/release/` |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
> **注意：**，当没有使用 `--target` 时，`Cargo` 会与构建脚本和过程宏一起共享你的依赖包，对于每个 `rustc` 命令调用而言，[`RUSTFLAGS`](https://course.rs/cargo/reference/configuration.md#buildrustflags) 也将被共享。
|
|
|
|
|
> **注意：**，当没有使用 `--target` 时，`Cargo` 会与构建脚本和过程宏一起共享你的依赖包，对于每个 `rustc` 命令调用而言，[`RUSTFLAGS`](https://course.rs/cargo/reference/configuration.html#配置文件概览) 也将被共享。
|
|
|
|
|
>
|
|
|
|
|
> 而使用 `--target` 后，构建脚本、过程宏会针对宿主机的CPU架构进行各自构建，且不会共享 `RUSTFLAGS`。
|
|
|
|
|
|
|
|
|
|
@ -39,8 +39,8 @@
|
|
|
|
|
|
|
|
|
|
| 目录 | 描述 |
|
|
|
|
|
| --- | --- |
|
|
|
|
|
| `target/debug/` | 包含编译后的输出，例如二进制可执行文件、[库对象( library target )](https://course.rs/cargo/reference/manifest/cargo-target.html#library) |
|
|
|
|
|
| `target/debug/examples/` | 包含[示例对象( example target )](cargo/reference/manifest/cargo-target.html#examples) |
|
|
|
|
|
| `target/debug/` | 包含编译后的输出，例如二进制可执行文件、[库对象( library target )](https://course.rs/cargo/reference/cargo-target.html#库对象library) |
|
|
|
|
|
| `target/debug/examples/` | 包含[示例对象( example target )](https://course.rs/cargo/reference/cargo-target.html#示例对象examples) |
|
|
|
|
|
|
|
|
|
|
还有一些命令会在 `target` 下生成自己的独立目录:
|
|
|
|
|
|
|
|
|
|
@ -54,7 +54,7 @@ Cargo 还会创建几个用于构建过程的其它类型目录，它们的目
|
|
|
|
|
| 目录 | 描述 |
|
|
|
|
|
| --- | --- |
|
|
|
|
|
| `target/debug/deps` | 依赖和其它输出成果 |
|
|
|
|
|
| `target/debug/incremental` | `rustc` [增量编译](https://course.rs/cargo/reference/profile.html#incremental)的输出，该缓存可以用于提升后续的编译速度 |
|
|
|
|
|
| `target/debug/incremental` | `rustc` [增量编译](https://course.rs/cargo/reference/profiles.html#incremental)的输出，该缓存可以用于提升后续的编译速度 |
|
|
|
|
|
| `target/debug/build/` | [构建脚本](https://course.rs/cargo/reference/build-script/intro.html)的输出 |
|
|
|
|
|
|
|
|
|
|
## 依赖信息文件
|
|
|
|
|
@ -62,7 +62,7 @@ Cargo 还会创建几个用于构建过程的其它类型目录，它们的目
|
|
|
|
|
|
|
|
|
|
该文件往往用于提供给外部的构建系统，这样它们就可以判断 `Cargo` 命令是否需要再次被执行。
|
|
|
|
|
|
|
|
|
|
文件中的路径默认是绝对路径，你可以通过 [`build.dep-info-basedir`](https://course.rs/cargo/reference/configuration.html#builddep-info-basedir) 配置项来修改为相对路径。
|
|
|
|
|
文件中的路径默认是绝对路径，你可以通过 [`build.dep-info-basedir`](https://course.rs/cargo/reference/configuration.html#配置文件概览) 配置项来修改为相对路径。
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
# 关于 `.d` 文件的一个示例 : target/debug/foo.d
|
|
|
|
|
@ -75,5 +75,5 @@ Cargo 还会创建几个用于构建过程的其它类型目录，它们的目
|
|
|
|
|
为了设置 `sccache`，首先需要使用 `cargo install sccache` 进行安装，然后在调用 `Cargo` 之前将 `RUSTC_WRAPPER` 环境变量设置为 `sccache`。
|
|
|
|
|
|
|
|
|
|
- 如果用的 `bash`，可以将 `export RUSTC_WRAPPER=sccache` 添加到 `.bashrc` 中
|
|
|
|
|
- 也可以使用 [`build.rustc-wrapper`](https://course.rs/cargo/reference/configuration.html#buildrustc-wrapper) 配置项
|
|
|
|
|
- 也可以使用 [`build.rustc-wrapper`](https://course.rs/cargo/reference/configuration.html#配置文件概览) 配置项
|
|
|
|
|
|
|
|
|
|
|
sunface
3 years ago