Glossary

• 詞匯表

Artifact

• 工件

一個(gè)Artifact是由編譯過(guò)程創(chuàng)建的文件或文件集。這包括可鏈接庫(kù)和可執(zhí)行二進(jìn)制文件.

Crate

• 箱 (包/庫(kù)， 又一抽象名)

包中的每個(gè)目標(biāo)都是箱。Crates 是庫(kù)或可執(zhí)行二進(jìn)制文件。它可能松散地引用目標(biāo)的源代碼或目標(biāo)生成的編譯工件。一個(gè)箱也可以指從注冊(cè)表中提取的壓縮包.

Edition

• 版本

一個(gè)Rust Edition是 Rust 語(yǔ)言的開(kāi)發(fā)里程碑。該一個(gè)包的版本在Cargo.toml清單中指定，各個(gè)目標(biāo)可以指定它們使用的版本。見(jiàn)版本指南欲獲得更多信息.

Feature

• 特性/特征/功能

一個(gè)特征是一個(gè)允許條件編譯的命名標(biāo)志參數(shù)。一個(gè)特性可以引用可選的依賴(lài)項(xiàng)，或者在 一個(gè)Cargo.toml 中定義的任意名稱(chēng)，可以鍵入(使用到)源代碼中。

Cargo 有不穩(wěn)定的特征標(biāo)志，這可以用來(lái)實(shí)現(xiàn) Cargo 本身的實(shí)驗(yàn)行為。Rust 編譯器和 Rustdoc 也有自己的不穩(wěn)定特征標(biāo)志(參見(jiàn)不穩(wěn)定的書(shū)和Rustdoc 書(shū)).

Index

• 索引是注冊(cè)表中，可搜索的包的列表.

Lock file

• (鎖定/鎖) 文件

Cargo.lock，名:鎖定文件，是一個(gè)文件，用于捕獲工作空間或包中使用的每個(gè)依賴(lài)項(xiàng)的確切版本，它由 Cargo 自動(dòng)生成?？吹?a rel="external nofollow" target="_blank" >Cargo.toml 與 Cargo.lock.

Manifest

• 清單/元信息

一個(gè)清單是對(duì)包或工作空間的描述，名為Cargo.toml.

一個(gè)虛擬清單是一個(gè)Cargo.toml，僅描述工作空間的文件，不包含包。

Member

• 會(huì)員/成員

一個(gè)成員是屬于工作空間的一個(gè)包.

Package

• 包

一個(gè)包是源文件和描述包的清單Cargo.toml的集合。包具有名稱(chēng)和版本，用于指定包之間的依賴(lài)關(guān)系。包中包含多個(gè)目標(biāo)，這些目標(biāo)是庫(kù)或可執(zhí)行二進(jìn)制文件。

該包根是Cargo.toml清單位于的包的目錄。

該包 ID 規(guī)范， 要么SPEC，是一個(gè)字符串，用于辨識(shí)從特定源，引用特定版本的包唯一性。

Project

• 包/項(xiàng)目

package的另一個(gè)名字.

Registry

• 注冊(cè)表

一個(gè)注冊(cè)處是一種服務(wù)，包含可下載的包，可以安裝或用作包的依賴(lài)項(xiàng).默認(rèn)注冊(cè)表是crates.io。注冊(cè)表有一個(gè)索引，其中包含所有包裝箱的清單，并告訴 Cargo 如何下載所需的箱。

Source

• 源/資源

一個(gè)源是一個(gè)提供程序，包含箱子，這些箱子可當(dāng)依賴(lài)項(xiàng)的包。有幾種源:

• 注冊(cè)表來(lái)源- 見(jiàn)注冊(cè)表.
• 本地注冊(cè)表源- 在文件系統(tǒng)上存儲(chǔ)為壓縮文件的一組包。看到本地注冊(cè)表來(lái)源.
• 目錄來(lái)源- 在文件系統(tǒng)上存儲(chǔ)為未壓縮文件的一組包.看到目錄來(lái)源.
• 路徑來(lái)源- 位于文件系統(tǒng)上的單個(gè)包(例如路徑依賴(lài))或一組多個(gè)包(如路徑覆蓋).
• Git 來(lái)源- 位于 git 存儲(chǔ)庫(kù)中的包(例如git 依賴(lài)要么git 來(lái)源).

看到來(lái)源更換欲獲得更多信息.

Spec

• 看到包 ID 規(guī)范.

Target

• 目標(biāo)

Target這個(gè)詞的意思，取決于具體情況:

• Cargo 目標(biāo) - Cargo 項(xiàng)目會(huì)有target，其具有對(duì)應(yīng)將要生成的工件。項(xiàng)目可以包含庫(kù)，二進(jìn)制，示例，測(cè)試和基準(zhǔn)目標(biāo)。該目標(biāo)列表配置在Cargo.toml清單，通常由源文件的目錄布局自動(dòng)推斷的。
• 目標(biāo)架構(gòu)- 構(gòu)建工件的 OS 和機(jī)器體系結(jié)構(gòu)，通常稱(chēng)為一個(gè)目標(biāo)。
• 目標(biāo) 三元(Triple)- 三元組是用于指定目標(biāo)體系結(jié)構(gòu)的特定格式。見(jiàn)clang 文檔 了解詳情。三元組可以稱(chēng)為 一個(gè)目標(biāo)三元，此為產(chǎn)生的工件的架構(gòu)，以及主機(jī)三元，此為編譯器運(yùn)行的體系結(jié)構(gòu)?？梢允褂?code>--target命令行選項(xiàng)或build.target [配置選項(xiàng)]指定目標(biāo)三元組。
• 目標(biāo)目錄- Cargo 將所有構(gòu)建的工件和中間文件放入target目錄。默認(rèn)情況下，這是一個(gè)名為target的目錄會(huì)在工作區(qū)根目錄，或者包根(如果不使用工作空間)。目錄隨著--target-dir命令行選項(xiàng)，CARGO_TARGET_DIR 環(huán)境變量， 或者build.target-dir 配置選項(xiàng)改變而改變.

“target-triple (目標(biāo) 三元)" 是 編譯器的 專(zhuān)用術(shù)語(yǔ)，用 “ cpu- vendor- os" 來(lái)標(biāo)識(shí) 交叉編譯時(shí)的 系統(tǒng)類(lèi)型

Test Targets

Cargo測(cè)試目標(biāo)生成二進(jìn)制文件，幫助驗(yàn)證代碼的正確操作和正確性。有兩種類(lèi)型的測(cè)試工件:

• 單元測(cè)試- 一個(gè)單元測(cè)試是直接從庫(kù)或二進(jìn)制目標(biāo)編譯的可執(zhí)行二進(jìn)制文件。它包含庫(kù)或二進(jìn)制代碼的全部?jī)?nèi)容，并運(yùn)行#[test]注釋函數(shù)，用于驗(yàn)證各個(gè)代碼單元。
• 集成測(cè)試目標(biāo)- 一個(gè)集成測(cè)試目標(biāo)是一個(gè)來(lái)自測(cè)試目標(biāo)的可執(zhí)行的二進(jìn)制文件，這是一個(gè)獨(dú)特的箱子，其來(lái)源位于tests目錄或由在Cargo.toml清單里面的[[test]]表指定。它旨在僅測(cè)試庫(kù)的公共 API，或執(zhí)行二進(jìn)制文件以驗(yàn)證其操作。

Workspace

• 工作區(qū)

一個(gè)工作區(qū)是一個(gè)共享公共依賴(lài)項(xiàng)解析(具有共享Cargo.lock)，輸出目錄和各種設(shè)置，如配置文件，的一個(gè)或多個(gè)包的集合。

一個(gè)虛擬工作區(qū)是Cargo.toml清單根目錄的工作空間， 沒(méi)有定義包，只列出工作區(qū)成員。

該工作區(qū)根是工作區(qū)的Cargo.toml清單位于的目錄.