サーチ…
前書き
cargo build 、 cargo run 、 cargo test （他の有用なコマンドの中で）のRustプロジェクトの構築、実行、管理に役立ちます。
構文
- cargo new crate_name [--bin]
- カーゴ初期化[--bin]
- カーゴビルド[ - リリース]
- 貨物運行[ - 解放]
- 貨物チェック
- 貨物検査
- 貨物ベンチ
- 貨物の更新
- 貨物パッケージ
- 貨物を発行する
- cargo [un] install binary_crate_name
- 貨物検索crate_name
- 貨物版
- 貨物ログインapi_key
備考
- 現時点では、
cargo benchサブコマンドは、夜間バージョンのコンパイラが効果的に動作することを要求します。
新しいプロジェクトを作成する
としょうかん
cargo new my-library
これにより、cargo設定ファイルと単一のRustソースファイルを含むソースディレクトリを含むmy-libraryという新しいディレクトリが作成されます。
my-library/Cargo.toml
my-library/src/lib.rs
これらの2つのファイルには、すでにライブラリの基本的なスケルトンが含まれているので、すべての機能が動作しているかどうかを確認するために、すぐにmy-libraryディレクトリからcargo test行うことができます。
バイナリ
cargo new my-binary --bin
これは、ライブラリと同様の構造を持つmy-binaryという新しいディレクトリを作成します。
my-binary/Cargo.toml
my-binary/src/main.rs
今回は、 cargoはすぐに実行できる簡単なHello Worldバイナリを設定しcargo run 。
initサブコマンドを使用して、現在のディレクトリに新しいプロジェクトを作成することもできます。
cargo init --bin
上記のように、-- --binフラグを削除して新しいライブラリプロジェクトを作成します。現在のフォルダの名前は自動的にクレート名として使用されます。
プロジェクトを構築する
デバッグ
cargo build
リリース
--releaseフラグを付けてビルドすると、デバッグビルドをビルドするときに行われない特定のコンパイラの最適化が可能になります。これにより、コードの実行速度は向上しますが、コンパイル時間も少し長くなります。最適なパフォーマンスを得るには、リリースビルドの準備が整ったらこのコマンドを使用する必要があります。
cargo build --release
テストの実行
基本的な使用法
cargo test
プログラムの出力を表示する
cargo test -- --nocapture
具体例の実行
cargo test test_name
ハローワールドプログラム
これは、 "Hello world"プログラムを作成してCargoで実行する方法を示すシェルセッションです。
$ cargo new hello --bin
$ cd hello
$ cargo run
Compiling hello v0.1.0 (file:///home/rust/hello)
Running `target/debug/hello`
Hello, world!
この後、テキストエディタでsrc/main.rsを開いてプログラムを編集することができます。
クレートを公開する
crates.ioにクレートを公開するには、貨物でログインする必要があります（「 Crates.ioアカウントへの貨物の接続 」を参照）。
次のコマンドを使用してあなたのクレートをパッケージ化し公開することができます：
cargo package
cargo publish
このプロセス中にCargo.tomlファイルのエラーがハイライト表示されます。 バージョンを更新し、 .gitignoreまたはCargo.tomlファイルに不要なファイルが含まれないようにする必要があります。
Crates.ioアカウントへの貨物の接続
crates.ioのアカウントはGitHubでログインすると作成されます。他の方法でサインアップすることはできません。
GitHubアカウントをcrates.ioに接続するには、上部メニューバーの[ GitHubでログイン ]ボタンをクリックし、crates.ioがアカウントにアクセスする権限を与えます。これで、すべてがうまくいったと仮定して、crates.ioにログインします。
APIキーを見つけなければなりません。APIキーは 、あなたのアバターをクリックし、「 アカウント設定 」に行き、次のような行をコピーすることで見つけられます：
cargo login abcdefghijklmnopqrstuvwxyz1234567890rust
これはあなたのターミナル/コマンドラインに貼り付けられ、あなたのローカルcargoインストールであなたを認証する必要があります。
APIキーに注意してください。パスワードのように秘密にしておく必要があります。そうしないと、あなたの箱がハイジャックされる可能性があります。