diff --git a/src/editions/creating-a-new-project.md b/src/editions/creating-a-new-project.md index 59a66a1..b2bde13 100644 --- a/src/editions/creating-a-new-project.md +++ b/src/editions/creating-a-new-project.md @@ -1,52 +1,89 @@ # 新しいプロジェクトを作成する -Cargoは新たなプロジェクトを作成する際に自動で最新のエディションをコンフィギュレーションに追加します。 +Cargo で新たなプロジェクトを作成すると、最新のエディションを使う設定が自動的に記述されます。 ```console -> cargo +nightly new foo - Created binary (application) `foo` project -> cat foo/Cargo.toml +$ cargo new foo + Creating binary (application) `foo` package +note: see more `Cargo.toml` keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html +$ cat foo/Cargo.toml [package] name = "foo" version = "0.1.0" -authors = ["your name "] -edition = "2021" +edition = "2024" [dependencies] ``` -この `edition = "2021"` によってあなたのパッケージが Rust 2021 を利用するように設定されます。 +`edition = "2024"` で、パッケージが Rust 2024 でビルドされるよう設定されます。 これ以外は必要ありません。 -もし、他の古いエディションを使いたい場合は、その設定の値を変更できます。例えば、 +`cargo new` のオプションとして `--edition ` を用いれば、 +新しいプロジェクトがそのエディションを使うようにできます。 +たとえば、Rust 2018 を使ったプロジェクトを作るには、以下のようにします。 -```toml +```console +$ cargo new --edition 2018 foo + Creating binary (application) `foo` package +note: see more `Cargo.toml` keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html +$ cat foo/Cargo.toml [package] name = "foo" version = "0.1.0" -authors = ["your name "] -edition = "2015" +edition = "2018" [dependencies] ``` + +うっかり存在しないエディションを指定しても大丈夫です。 +`cargo new` に存在しないエディションを指定しても弾かれます。 + +```console +$ cargo new --edition 2019 foo +error: invalid value '2019' for '--edition ' + [possible values: 2015, 2018, 2021, 2024] + + tip: a similar value exists: '2021' + +For more information, try '--help'. +``` + + -とすると、あなたのパッケージは Rust 2015 でビルドされます。 +`Cargo.toml` の `edition` の値を直接変更しても構いません。 +たとえば、パッケージが Rust 2015 でビルドされるようにするには、以下のように設定すればよいです。 + +```toml +[package] +name = "foo" +version = "0.1.0" +authors = ["your name "] +edition = "2015" + +[dependencies] +```