サーチ…


前書き

CargoはRustのパッケージマネージャーで、 (Rustのライブラリ/パッケージの用語)の管理に使用されます。 Cargoは主にcrates.ioのパッケージをフェッチし、特定のバージョン要件(セマンティックバージョニングを使用)で複雑な依存関係ツリーを管理できます。貨物はまた、 cargo buildcargo runcargo 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キーに注意してください。パスワードのように秘密にしておく必要があります。そうしないと、あなたの箱がハイジャックされる可能性があります。



Modified text is an extract of the original Stack Overflow Documentation
ライセンスを受けた CC BY-SA 3.0
所属していない Stack Overflow