- Rust游戲開發實戰
- (美)赫伯特·沃爾弗森
- 702字
- 2024-09-05 16:34:14
1.4.1 Cargo的元數據
打開在“Hello”項目中創建的Cargo.toml文件:
InstallingRust/HelloWorld/Cargo.toml
[package] name = "Hello" version = "0.1.0" authors = ["Your Name"] edition = "2018" # See more keys and their definitions at # https://doc.rust-lang.org/cargo/reference/manifest.html [dependencies]
這個文件描述了整個程序的基本信息,以及如何構建這個程序。它采用TOML(Tom's Obvious, Minimal Language)格式,可以把關于crate的各種信息以不同小節的形式進行組織和存儲。[package]小節描述當前crate——如果把當前crate公開發布,這些信息將用于向它的潛在用戶介紹自己。這個小節具有擴展性,從而能包含關于當前項目的很多信息。
Cargo已經創建好了運行“Hello, World”所需的一切,所以如果不想更改任何信息,則無須編輯Cargo.toml文件。其中的默認值如下。
(1)name:程序的名稱,在這個例子中是“Hello”。它的默認值來自調用cargo new命令時所提供的名稱。在編譯程序時,這個名稱將作為編譯后輸出文件的文件名。在Windows上,hello變為hello.exe。在類UNIX系統上,輸出文件被命名為hello。
(2)version:項目的版本號。Cargo將其初始值設定為0.1.0。只有當需要發布crate的一個新版本時才需要更新版本號。此外,當開發者認為取得了很大進展并需要明確指出這種進展時,也可以更新版本號。在1.8節中,我們將介紹Rust的語義版本控制。就現階段而言,保持版本號是0.x.y這種形式即可。每一位數字都可以超過10——0.10.0這種寫法是沒有問題的。
(3)authors:一個列表,可以用一對方括號來表示。它可以包含用逗號分隔的一系列作者的名字——每個名字都寫在一對雙引號中。如果用戶已經配置好了git,則姓名和郵件地址會自動從git中獲取。
(4)edition:該項目所使用的Rust的主版本號。它的默認值總是當前最新的版本,在編寫本書時,默認值是2018。不同的大版本之間允許引入巨大的語法變化,這可能會使得老舊的程序無法編譯。指定edition參數可以告訴Rust編譯器哪些語法規則是可以使用的。
現在,元數據準備就位,接下來我們可以進入主程序的源代碼了。