Cargo を使ってローカルでコードを実行する

自分のシステムでコードを試してみたい場合は、まず Rust をインストールする必要があります。これを行うには、Rust Book の手順に従ってください。これにより、動作する rustccargo が手に入るはずです。本稿執筆時点では、最新の安定版 Rust リリースのバージョン番号は次のとおりです。

% rustc --version
rustc 1.69.0 (84c898d65 2023-04-16)
% cargo --version
cargo 1.69.0 (6e9a83356 2023-04-12)

Rust は後方互換性を維持しているため、これより新しいバージョンでも使用できます。

ここまで準備できたら、このトレーニングにある例の 1 つから Rust バイナリをビルドするために、次の手順に従ってください。

  1. コピーしたい例の「Copy to clipboard」ボタンをクリックします。

  2. cargo new exercise を使って、コード用の新しい exercise/ ディレクトリを作成します。

    $ cargo new exercise
         Created binary (application) `exercise` package
    
  3. exercise/ に移動し、cargo run を使ってバイナリをビルドして実行します。

    $ cd exercise
    $ cargo run
       Compiling exercise v0.1.0 (/home/mgeisler/tmp/exercise)
        Finished dev [unoptimized + debuginfo] target(s) in 0.75s
         Running `target/debug/exercise`
    Hello, world!
    
  4. src/main.rs にあるひな形コードを自分のコードに置き換えます。たとえば、前のページの例を使う場合は、src/main.rs を次のようにします。

    // Copyright 2022 Google LLC
    // SPDX-License-Identifier: Apache-2.0
    
    fn main() {
        println!("Edit me!");
    }
  5. cargo run を使って、更新したバイナリをビルドして実行します。

    $ cargo run
       Compiling exercise v0.1.0 (/home/mgeisler/tmp/exercise)
        Finished dev [unoptimized + debuginfo] target(s) in 0.24s
         Running `target/debug/exercise`
    Edit me!
    
  6. cargo check を使うと、プロジェクトのエラーをすばやく確認できます。cargo build を使うと、実行せずにコンパイルできます。通常のデバッグビルドでは、出力は target/debug/ にあります。最適化されたリリースビルドを生成するには、cargo build --release を使ってください。生成先は target/release/ です。

  7. Cargo.toml を編集することで、プロジェクトに依存関係を追加できます。cargo コマンドを実行すると、不足している依存関係は自動的にダウンロードおよびコンパイルされます。

授業の参加者には、Cargo をインストールしてローカルのエディタを使うよう勧めてみてください。 通常の開発環境が使えるようになるため、そのほうが作業しやすくなります。