Fork: 0
hasegawa / DeepTIAS
Transfer to URL with SHA Find file
Newer
Older
DeepTIAS / docs / 02_ENV / ENV_02_環境構築手順.md
@rintoHasegawa rintoHasegawa 13 days ago 4 KB [update] 開発環境を Build Tools と C++ ビルドツールの構成に変更
Raw Blame History

環境構築手順 (Environment Setup)

DeepTIAS をビルド・実行するための開発環境の構築手順．新しく参加したメンバーや，PC を入れ替えたときに上から順に行う．

前提 (Prerequisites)

  • Windows 10 / 11（x64），メモリ 8 GB 以上
  • GitHub のアカウントがあり，リポジトリ rintoHasegawa/DeepTIAS へのアクセス権を持っていること

手順 (Steps)

1. Visual Studio Build Tools 2022 を入れる

ワークロード「.NET デスクトップ ビルド ツール」と「C++ ビルド ツール」を入れる．PowerShell で以下を実行する（管理者権限の確認が出たら許可する）．

winget install --id Microsoft.VisualStudio.2022.BuildTools --exact --override "--add Microsoft.VisualStudio.Workload.ManagedDesktopBuildTools --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended --passive --norestart"

Build Tools が既に入っていて「C++ ビルド ツール」だけが無い場合は，以下で追加する．

& "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools" --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended --passive --norestart
  • ※ 「C++ ビルド ツール」は，rgb2lab\TongueAnalysis.exe（Image&Calib モードで使う）が必要とする VC++ のデバッグ用ランタイムを入れるために必要．入れると C:\Windows\System32 に MSVCP140D.dll・ucrtbased.dll 等が入る．
  • ※ 追加のコマンド（modify）は動作を確認済み．新規インストールのコマンド（winget install）は未検証．
  • ※ 画面（Form1.Designer.cs）を WinForms デザイナで編集したいときは，Visual Studio 2022 Community を追加で入れる（winget install --id Microsoft.VisualStudio.2022.Community --exact --override "--add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --passive --norestart"）．

2. Git・Git LFS・GitHub CLI・Python を入れる

winget install Git.Git GitHub.cli Python.Python.3.12
git lfs install
  • ※ Git for Windows には Git LFS が同梱されている．
  • ※ Python は Claude Code のフック実行に使う（アプリ自体は Python を使わない）．

3. リポジトリを取得する

git clone https://github.com/rintoHasegawa/DeepTIAS.git
cd DeepTIAS
git lfs pull
  • ※ モデル（*.pb，*.onnx）は Git LFS で管理している．git lfs pull 後に Tongue extraction\models\ の各ファイルが数十 MB あることを確認する（数百バイトしか無ければ LFS の取得に失敗している）．

4. ビルドする

ENV_04_開発コマンド のコマンドで，NuGet パッケージを復元してから構成 Release・プラットフォーム x64 でビルドする． Visual Studio 2022 Community を入れた場合は，Tongue extraction.sln を開いて同じ構成でビルドしてもよい（NuGet パッケージは初回ビルド時に自動で復元される）．

5. 入力データを置いて実行する

※ Image モード・Image&Calib モードとも動作確認済み（Image&Calib は手順 1 の「C++ ビルド ツール」が必要）

実行に必要な外部バイナリ・色補正データ・出力雛形は Tongue extraction\runtime\ にあり，ビルド時に出力フォルダへコピーされる．

アプリは作業ディレクトリを基準に ..\Input・..\Output を読み書きする．ビルド出力 Tongue extraction\bin\x64\Release\ から起動する場合，入力は以下に置く．

Tongue extraction\bin\x64\
├── Input\
│   ├── TongueImage\            # 舌画像（.bmp）
│   └── CalibrationColorChart\  # カラーチャート画像（Calib モードのみ．舌画像と同名）
├── Output\                     # 解析結果（実行時に作られる）
└── Release\
    └── DeepTIAS2.7.exe