OS X に VS Code をインストールする

MacBook Pro (MacOS Catalina) に VS Code (Visual Studio Code) をインストールした作業メモ。正月休みのインストール大会。

<dl>
<dt>OS</dt> 
<dd>MacOS Catalina バージョン 10.15.2</dd>
<dt>Hardware</dt> 
<dd>MacBook Pro (Retina, 15-inch, Mid 2015)</dd>
</dl>

# 1. ダウンロード・ファイルの検証

## 1-1. Visual Studio Code (zip アーカイブ）のダウンロード

ダウンロード: [Download Visual Studio Code](https://code.visualstudio.com/download) から Mac 用を。
 ダウンロードしたファイル (Version 1.41)<pre>
$ cd ~/Downloads
$ ls -l VSCode-darwin-stable.zip
-rw-r--r--@ 1 takagi  staff  87218255  1  3 13:23 VSCode-darwin-stable.zip
</pre>

## 1-2. ダウンロードしたファイルをチェックサムで検証する

チェックサムは [Download Visual Studio Code](https://code.visualstudio.com/download) の最下部の文字列 "See SHA-256 Hashes" をクリックすると現れる。Mac のものは最下行にある。これをクリップボードにコピーしておく。
クリップボードにコピーしたチェックサムでダウンロードしたファイルを検証する。

```bash:チェックサムで検証する
$ pwd
/Users/takagi/Downloads
$ ls VSCode-darwin-stable.zip 
VSCode-darwin-stable.zip
$ echo "`pbpaste`  `ls VSCode*`" | shasum -a 256 -c -
VSCode-darwin-stable.zip: OK
```
**チェックサムとファイル名の間はスペースが二個**なのに注意！スペースが一個だと、以下のように怒られる。

```bash:スペースが一個だとチェックサム行だと認めてくれない
$ echo "`pbpaste` `ls VSCode*`" | shasum -a 256 -c -
shasum: standard input: no properly formatted SHA1 checksum lines found
```
スペースが三個以上だと以下のようにファイルを開けない・読めない、と怒られる。この仕様はなんとかならんか。

```bash:スペースが三個以上だとファイルを開けない・読めない
$ echo "`pbpaste`   `ls VSCode*`" | shasum -a 256 -c -
shasum:  VSCode-darwin-stable.zip: 
 VSCode-darwin-stable.zip: FAILED open or read
shasum: WARNING: 1 listed file could not be read
```

# 2. インストール

## 2-1. アーカイブを解凍する

「ダウンロード」アイコンをクリックして、**VSCode-darwin-stable.zip** をダブルクリックすれば、アーカイブユーティリティーが解凍してくれるが、あえて、コマンドラインでの解凍も以下に載せておく。

```bash:unzipでアーカイブを解凍する
$ cd ~/Downloads
$ unzip VSCode-darwin-stable.zip 
$ ls -d Visual\ Studio\ Code.app/
Visual Studio Code.app/
```

## 2-2. アプリケーションに登録する

1. 「ダウンロード」フォルダに解凍された、"Visual Studio Code.app" を Finder を使って「アプリケーション」フォルダにドラッグする。
2. Launchpad に **Visual Studio Code** アイコンができる。

## 2-3. 「このソフトウェアはアップデートが必要です」対策

[セキュリティとプライバシー] に Visual Studio Code の実行を止められたが、以下の手順で何とか。

1. Launchpad を開き、**Visual Studio Code** を開く。
 私の MacBookPro の場合は、ここでこんな警告ダイアログが出て開けなかった。<br>
<img width="418" alt="VSCode_inst_01.png" align="top" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/92889/8b697d23-b9e5-79ec-40af-464c227be7d8.png">
2. [システム環境設定]→[セキュリティとプライバシー]を開き、[一般]タブを開くと、
「"Visual Studio Code.app"は開発元を確認できないため、使用がブロックされました。」と表示されている。<br><img width="669" alt="VSCode_inst_02.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/92889/350ccc12-d57e-e4b0-531c-82288b4e49a4.png">
3. 「変更するにはカギをクリックします」をクリックし、パスワードを入力してカギをアンロックした状態で、[このまま開く]をクリックする。最初の警告ダイアログと同じような以下のダイアログが開くが、今度は増えている[開く]ボタンをクリックする。<br><img width="478" alt="VSCode_inst_03.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/92889/fe724cbe-926f-93bc-b479-4880a4fd881b.png">
4.  Visual Studio Code が開く。<img width="1026" alt="VSCode_inst_04.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/92889/8d4426bf-345f-81b0-18c0-2e519f420034.png">

## 2-4. コマンドラインからも起動できるようにする

この項は、[Visual Studio Code on macOS](https://code.visualstudio.com/docs/setup/mac) の *Launching from the command line#* をそのまま。

1. [View] → [Command Palette...] もしくは ⇧⌘P もしくは F1 で **Command Palette** を開く。
2. **Shell Command: Install 'code' command in PATH** を選ぶ。
3. 新しいターミナルを開く。コマンドラインから **code** で起動できる。

**Shell Command: Install 'code' command in PATH** という名前からして、$PATH に追加されるのかと思ったが、/usr/local/bin に code のシンボリックリンクができるようだ。

```bash:codeはどこに？
$ which code
/usr/local/bin/code
$ ls -l /usr/local/bin/code
lrwxr-xr-x  1 takagi  admin  68  1  4 22:42 /usr/local/bin/code -> /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code
```

# 3. 表示言語を日本語に

この項は、[Display Language (Visual Studio)](https://code.visualstudio.com/docs/getstarted/locales) の手順に沿っただけ。

1. [View] → [Command Palette...] もしくは ⇧⌘P もしくは F1 で **Command Palette** を開く。
2. "display" とタイプして、**Configure Display Language** をフィルタし、これを選ぶ。<br>
<img width="414" alt="VSCode_inst_05.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/92889/d58631d4-fa50-3340-d559-5334896943b6.png">
3. **Install additional languages...** を選ぶ。<br>
<img width="403" alt="VSCode_inst_06.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/92889/90141cd5-97df-9dee-e65e-fc7d9196634e.png">
4. 画面左の EXTENSIONS: MARKETPLACE にインストールできる言語パックがリスト表示される。<br><img width="302" alt="VSCode_inst_07.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/92889/417e963d-0f38-5389-5c65-9cc7c2f30541.png">
5. 検索用のフィールドに "@category:"language packs" と表示されている後ろに "japanese" と追加入力し、**Japanese Language Pack for Visual Studio Code** をフィルタし、[install] をクリックする。<br><img width="1214" alt="VSCode_inst_08.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/92889/e161221b-7b64-58f7-c6b9-7334c54a18e3.png">
6. インストールはすぐ終わり、右下に「日本語表示するにはVS Codeを再起動（てきとー翻訳）」と表示される。[Restart Now] をクリックする。<br><img width="460" alt="VSCode_inst_09.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/92889/8ed92c8e-2093-3d68-9b6d-3ac0c116a4d0.png">
7. VS Code が再起動され、表示が日本語になる。<br><img width="792" alt="VSCode_inst_10.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/92889/6b34a09f-9148-0864-be03-e8736e30ca24.png">

# Appendix 参照したリンク

* [Visual Studio Code](https://code.visualstudio.com)
* [Visual Studio Code on macOS](https://code.visualstudio.com/docs/setup/mac)
* [Display Language (Visual Studio)](https://code.visualstudio.com/docs/getstarted/locales)
* [MacOSでVisual Studio Codeをインストールする手順](https://qiita.com/watamura/items/51c70fbb848e5f956fd6)
* [Thread: [SOLVED] what should the filename be for a SHA1SUM ???](https://ubuntuforums.org/showthread.php?t=924345)