Dev Container を使った
開発環境構築ガイド

このガイドについて

Dev Container（開発コンテナ）とは？

プログラムを動かすための「専用の箱」 をパソコンの中に作る仕組みです。

この「箱」の中に pyMEA を動かすために必要なものがすべて入っています。

なぜ Dev Container を使うの？

事前準備：必要なソフトウェア 4つ

ステップ 1：Git をインストールする

Git とは？ ファイルの変更履歴を管理するツールです。プロジェクトのダウンロードにも使います。

Windows: https://gitforwindows.org/ からダウンロード
→ インストーラーを起動して「Next」を押し続けるだけで OK

Mac: ターミナルで git --version を実行
→ インストールを促すダイアログが表示されたら指示に従う

git --version
# git version 2.x.x と表示されれば OK

ステップ 2：Docker Desktop をインストールする

Docker とは？ 「専用の箱（コンテナ）」を作るためのソフトウェアです。

1. https://www.docker.com/products/docker-desktop/ にアクセス
2. OS（Windows / Mac）向けのインストーラーをダウンロード
3. インストーラーを起動してインストール
4. Docker Desktop を起動（タスクバーにクジラのアイコンが表示されれば起動中）

Windows の注意: WSL 2 のインストールを求められたら画面の指示に従ってください。

docker --version
# Docker version 2x.x.x と表示されれば OK

ステップ 3 & 4：VS Code と拡張機能をインストールする

事前準備はこれで完了です！

セットアップの全体の流れ

Step 1：リポジトリをクローンする

クローンとは？ GitHub 上のプロジェクトを自分のパソコンにコピーすることです。

Mac はターミナル、Windows は Git Bash を開いて実行します。

Windows の注意: コマンドプロンプトや PowerShell ではなく Git Bash を使ってください。
スタートメニューで「Git Bash」と検索して起動してください。

mkdir -p ~/Workspace          # Workspace フォルダを作成
cd ~/Workspace                # 移動
git clone https://github.com/kkito0726/MEA_modules.git

実行後、~/Workspace/MEA_modules フォルダが作成されます。

Step 2：計測データの場所を登録する（Windows）

重要: Dev Container を開く 前 に必ず完了してください。

リポジトリフォルダ内の setup.bat をダブルクリックして実行します。

MEA_modules/
├── setup.bat   ← これをダブルクリック
├── pyMEA/
└── ...

データフォルダのパス: E:\MEA_data  ← 入力して Enter

設定完了！コンテナ内からは /data でアクセスできます。

「設定完了！」と表示されたら VS Code を再起動 してください。

Step 2：計測データの場所を登録する（Mac）

ターミナルを開いて以下のコマンドを実行します。

# パスを ~/.zshrc に追記
echo 'export MEA_DATA_PATH="/Volumes/MyHDD/MEA_data"' >> ~/.zshrc

# 設定を反映
source ~/.zshrc

/Volumes/MyHDD/MEA_data の部分はご自身のパスに変更してください。
Finder でフォルダを開いてアドレスバーからコピーできます。

設定後は VS Code を再起動 してください。

コンテナ起動後は外付けHDDのデータを /data からアクセスできます：

mea = read_MEA("/data/sample.hed", start=0, end=5, electrode_distance=450)

Step 3 & 4：VS Code でフォルダを開く

code ~/Workspace/MEA_modules

または VS Code のメニューから「ファイル」→「フォルダーを開く」で MEA_modules を選択。

フォルダを開くと 右下に通知 が表示されます：

┌──────────────────────────────────────────────────────┐
│  フォルダーにデブコンテナー構成ファイルが含まれています。  │
│                                                        │
│     [コンテナーで再度開く]             [後で]           │
└──────────────────────────────────────────────────────┘

「コンテナーで再度開く」 をクリックしてください。

通知が表示されない場合：VS Code 左下の 緑色の >< アイコン をクリック

Step 5：環境の自動セットアップを待つ

初回はライブラリのダウンロード・インストールが 自動で 行われます。

VS Code の左下が以下のように変われば成功です：

Dev Container: Python 3

動作確認

Dev Container が起動したら、VS Code の ターミナル を開きます。
（メニュー：「ターミナル」→「新しいターミナル」）

python --version
# Python 3.12.x と表示されれば OK

python -c "import pyMEA; print('pyMEA が使えます！')"
# pyMEA が使えます！ と表示されれば OK

よくあるトラブル（3 / 4）：クラウドストレージ

Q. OneDrive や Google Drive に計測データを保存している場合は？

推奨: MEA 計測データは1ファイルで数百MB〜数GBになることがあります。
外付けHDDへの保存を推奨します。 クラウドストレージはバックアップ用途にとどめてください。

アップデート方法

開発者から「アップデートしてください」と連絡が来たとき：

git pull
# Updating abc1234..def5678