UbuntuにRustをインストールする

UbuntuにRustをインストールしたのでメモとして残しておきます。この記事ではUbuntu18.04にRust1.34.0を入れた記事になっています。Ubuntu22.04にRust1.62.0をインストールした記事は[こちら](https://higmasan.com/2022/07/04/ubuntu-22-04%e3%81%abrust-1-62-0%e3%82%92%e3%82%a4%e3%83%b3%e3%82%b9%e3%83%88%e3%83%bc%e3%83%ab%e3%81%99%e3%82%8b/)にあります。

# 環境

- Ubuntu 18.04
- rust 1.34.0

# インストール

`curl https://sh.rustup.rs -sSf | sh`を実行するだけで簡単にインストールできます。途中でインストールの方法を選択できますがここではデフォルトの1を選択しています。rustup.rsは中身はBashスクリプトになっていてrustupやrustc、cargoなどを`$HOME/.cargo/bin`にダウンロードしてくるようです。スクリプトの中身は[rustup.rsのGitHub](https://github.com/rust-lang/rustup.rs)のrustup-init.shです。

```
~$ curl https://sh.rustup.rs -sSf | sh
info: downloading installer

Welcome to Rust!

This will download and install the official compiler for the Rust programming 
language, and its package manager, Cargo.

It will add the cargo, rustc, rustup and other commands to Cargo's bin 
directory, located at:

  /home/yoshi/.cargo/bin

This path will then be added to your PATH environment variable by modifying the
profile file located at:

  /home/yoshi/.profile

You can uninstall at any time with rustup self uninstall and these changes will
be reverted.

Current installation options:

   default host triple: x86_64-unknown-linux-gnu
     default toolchain: stable
  modify PATH variable: yes

1) Proceed with installation (default)
2) Customize installation
3) Cancel installation
>1 <--ここで1を入力する

info: syncing channel updates for 'stable-x86_64-unknown-linux-gnu'
info: latest update on 2019-04-11, rust version 1.34.0 (91856ed52 2019-04-10)
info: downloading component 'rustc'
 85.3 MiB /  85.3 MiB (100 %)  15.9 MiB/s ETA:   0 s                
info: downloading component 'rust-std'
 56.2 MiB /  56.2 MiB (100 %)  16.3 MiB/s ETA:   0 s                
info: downloading component 'cargo'
info: downloading component 'rust-docs'
info: installing component 'rustc'
 85.3 MiB /  85.3 MiB (100 %)  12.5 MiB/s ETA:   0 s                
info: installing component 'rust-std'
 56.2 MiB /  56.2 MiB (100 %)  15.0 MiB/s ETA:   0 s                
info: installing component 'cargo'
info: installing component 'rust-docs'
 10.2 MiB /  10.2 MiB (100 %)   4.2 MiB/s ETA:   0 s                
info: default toolchain set to 'stable'

  stable installed - rustc 1.34.0 (91856ed52 2019-04-10)


Rust is installed now. Great!

To get started you need Cargo's bin directory ($HOME/.cargo/bin) in your PATH 
environment variable. Next time you log in this will be done automatically.

To configure your current shell run source $HOME/.cargo/env
```

## インストール先

インストールメッセージの最後の方にRustを使用するにはCargoのbinディレクトリ(`$HOME/.cargo/bin`)を環境変数PATHに追加してくださいとあります。lsコマンドでそのディレクトリを確認するとRustコンパイラの`rustc`以外に、コンパイルマネージャとパッケージマネージャを兼ねる`cargo`、ドキュメンテーションツールの`rustdoc`、これらツールチェーンのインストーラ`rustup`もインストールされています。rust-lldbとかrust-gdbとかデバッガらしきものもインストールされています。

```
~$ ls $HOME/.cargo/bin/
cargo  cargo-clippy  cargo-fmt  cargo-miri  clippy-driver  rls  rust-gdb  rust-lldb  rustc  rustdoc  rustfmt  rustup
```

## パスの設定

親切にもパスを通すスクリプト`$HOME/.cargo/env`を用意してくれています。中身はexportコマンドで＄HOME/.cargo/binをパスに追加しています。これをsourceコマンドで読み込みます。

```
~$ cat $HOME/.cargo/env
export PATH="$HOME/.cargo/bin:$PATH"
~$ source $HOME/.cargo/env
```

## 実行確認

`cargo`、`rustc`、`rustdoc`、`rustup`は無事インストールされています。

```
~$ cargo --version
cargo 1.34.0 (6789d8a0a 2019-04-01)
~$ rustc --version
rustc 1.34.0 (91856ed52 2019-04-10)
~$ rustdoc --version
rustdoc 1.34.0 (91856ed52 2019-04-10)
~$ rustup --version
rustup 1.17.0 (069c88ed6 2019-03-05)
```

rust-lldbでデバッグしたかったのですが、rust-lldbを実行するとlldbがないと怒られました。aptコマンドでlldbを入れると無事起動しました。

```
~$ rust-lldb 
/home/yoshi/.rustup/toolchains/stable-x86_64-unknown-linux-gnu/bin/rust-lldb: 34: exec: lldb: not found

~$ sudo apt install lldb

~$ lldb --version
lldb version 6.0.0

~$ rust-lldb 
(lldb) command script import "/home/yoshi/.rustup/toolchains/stable-x86_64-unknown-linux-gnu/lib/rustlib/etc/lldb_rust_formatters.py"
(lldb) type summary add --no-value --python-function lldb_rust_formatters.print_val -x ".*" --category Rust
(lldb) type category enable Rust
(lldb) 
```



# ビルド

さっそく簡単なプログラムを書いて動かしてみます。

- rustcで直接コンパイル

  ```
  ~$ vim hello.rs
  fn main() {
    println!("Hello, world!");
  }
  ~$ rustc hello.rs -o hello
  ~$ ./hello 
  Hello, world!
  ```

- cargoでコンパイル

  ```
  ~$ cargo new hello
    Created binary (application) `hello` package
  ~$ cd hello
  ~$ cargo build
    Compiling hello v0.1.0 (/home/yoshi/rust/hello)
    Finished dev [unoptimized + debuginfo] target(s) in 0.26s
  ~$ cargo run
    Finished dev [unoptimized + debuginfo] target(s) in 0.00s
    Running `target/debug/hello`
  Hello, world!
  ```

## cargoのオプション

その他のcargoのオプションです。そのうち細かいところも見ていこうと思います。

| オプション | 説明 |
|:--:|:--|
| build | プロジェクトのビルドをする |
| check | ビルドできるかのチェックをする |
| clean | プロジェクトのクリーンをする |
| doc | ドキュメントを作成する |
| new | プロジェクトの作成 |
| init | 既存のディレクトリでプロジェクトの作成 |
| run | 実行ファイルを実行する |
| test | テストを実行する |
| bench | ベンチマークを実行する |
| update | Cargo.lockに記述された依存をアップデートする |
| search | crate.ioからパッケージを探します |
| public | パッケージをcreate.ioに公開します |
| install | rust製のバイナリをインストールする |
| uninstall | rust製のバイナリアンインストールします |