Cargo는 Rust로 작성된 프로젝트를 빌드하고, 패키지를 매니징하는 도구입니다. 간략히 사용법을 정리해보겠습니다!
프로젝트 생성
새로운 프로젝트 생성은 아래 명령어를 사용합니다.
cargo new project-name
해당 명령어를 통해 project-name이라는 폴더가 생성되고, 그 안에 Cargo.toml 파일과 src/main.rs 파일이 생성됩니다.
Cargo.toml
Cargo.toml 파일은 Rust 프로젝트의 정보(프로젝트명, 사용할 버전, 컴파일러 등), dependency가 있는 패키지를 관리합니다.
[package]
name = "project-name"
version = "0.1.0"
edition = "2021" #컴파일러
.
.
[dependencies]
.
.
빌드
간단한 명령으로 빌드를 실행할 수 있고, 결과물인 실행파일은 프로젝트 폴더의 target이라는 폴더 안에 생성됩니다.
~/project-name$ cargo build
~/project-name$ ./target/debug/project-name
Hello, world!
빌드와 동시에 실행까지 원할 경우에는 run 명령어를 사용합니다.
cargo run
프로그램에서 args를 사용할 경우에는 아래와 같이 사용합니다.
cargo run arg1 arg2
cargo 도구에도 자체에도 옵션을 사용할 수 있는데, 이럴 경우에는 '--'문자를 기준으로 구분하여 사용합니다.
cargo --release -- arg1 arg2
마지막 --를 기준으로 cargo 도구에 적용되는 옵션이 끝나는 것을 의미하고, 그 뒤로 기존 방법과 같이 프로그램의 args를 넣어서 사용합니다.
기타
실행 파일을 생성하지 않고, 컴파일만 확인할 경우
cargo check
패키지 버전을 최신으로 다운받을 경우
cargo update
프로젝트에 쓰인 함수들을 문서화하는 기능, 프로젝트에 있는 코드의 주석을 기반으로 HTML 문서를 생성해줍니다.
cargo doc
문서화와 동시에 실행을 원할 경우
cargo doc --open
