対象: root/programs（net48 版 / net10.0 版）
配置: root
本書は、どう実行し、どう合否を判定するかを扱う。
「何をビルドするか」の正はビルド バッチ（root/programs/*.bat）にあり、
root/*.ps1 はそれを呼んで結果を集約するだけである。
一次情報は本書ではない。 迷ったら次を見ること。
内容 一次情報 各プロジェクトの構成 各フォルダの ANALYSIS.md設定ファイルの扱い CONFIGURATION.mdテストの実行と判定 TESTING.mdbat / ps1 の書き方 CODING.md手順だけ知りたい CHEATSHEET.md
cd root
.\0_RunAll.ps1 # ビルド → テストの通し
.\1_BuildAll.ps1 # ビルドだけ
.\1_BuildAll.ps1 -List # 対象の一覧（**ここが一次情報**）
.\1_BuildAll.ps1 -Only net10.0 -SkipClean
.\1_BuildAll.ps1 -WarnDetail # 警告の内訳を出す
.\1_BuildAll.ps1 -Libs Force # OpenTouryo のアセンブリを取り直すビルドとは別に、DDL がミラーかを確かめるスクリプトがある（#206）。
.\CompareDdl.ps1 # 3 つの RDB の DDL を突き合わせるバッチを直接ダブル クリックしてもよい。その場合は root/programs の
0_ExecAllBat.bat（通し）または 10_MultiPurposeAuthSite*.bat（個別）を使う。
| 引数 | 意味 |
|---|---|
-Configuration |
Debug（既定）/ Release。BUILD_CONFIG としてバッチへ渡る |
-Only |
ステップ名またはバッチ名の部分一致で絞る |
-List |
-Only に指定できる名前を出して終わる |
-SkipClean |
クリーン処理を省略する |
-Libs |
OpenTouryo のアセンブリ。Auto（既定。無ければ取得）/ None（取得しない）/ Force（取り直す） |
-WarnDetail |
警告を種類ごとに集計して出す |
-IgnoreErrors |
既知のエラーとして合否から外す正規表現。除外分は別枠で必ず表示する |
-OutputDir |
ログの保存先。既定は programs\Tests\E2ETests\Result（.gitignore 済み） |
バッチをそのまま回しても、合否が取れない。
- 各バッチは MSBuild の終了コードを伝播しない。
%ERRORLEVEL%を見ていない - 末尾に
pauseがある。 対話入力を待って止まる -v:d（詳細）で出力が膨大。 目視で error を探すのは現実的でない
1_BuildAll.ps1 は、0_ExecAllBat.bat と同じ echo. | call 方式で stdin を与えて実行し、
出力を解析して判定する。
ASCII のコード部分だけで判定する。
: error CS1002:
: error MSB4226:
: error : ← コードを伴わない形式もある（NuGet の restore 失敗など）
[ERROR] ← z_Common.bat が MSBuild 未検出時に出す独自形式
日本語の文言では判定しない。 「ビルドに成功しました」はロケールで変わるうえ、 コード ページの食い違いで化けることがある。コード部分は ASCII なので、化けても合否は変わらない。
同じ指摘が複数プロジェクトから重複して出るため、行の重複を除いて数える。 このため件数は MSBuild が最後に出すサマリと一致しない（MSB3277 のように 1 件で何行も出る警告がある）。 増減を見る目安として使う。
| 表示 | 意味 |
|---|---|
OK |
除外後のエラーが 0 件 |
NG |
除外後のエラーが 1 件以上 |
見送り |
-SkipClean、または nuget.exe が無くてクリーンを飛ばした |
バッチ無し |
呼ぶバッチが存在しない |
見送り は失敗に数えない。 ただし黙って飛ばさず、必ず表に残す。
飛ばしたことが見えないと「通った」と読めてしまう。
終了コードは、NG が 0 件なら 0、1 件以上なら 1。
1 件も選ばれないまま進むと「全ステップ OK」と表示される。
打ち間違いが緑になるのが最も悪いので、一致 0 件は exit 1 にしてある。
root/programs にあるバッチ。
| バッチ | 役割 |
|---|---|
0_ExecAllBat.bat |
通し。クリーン → net48 → net10.0 |
1_DeleteDir.bat |
packages obj bin bld Temp Build PrecompiledWeb .vs を再帰的に削除 |
2_DeleteFile.bat |
*.suo *.user *.tmp *.log *.bak *.skrold を削除 |
3_BuildLibsAtOtherRepos.bat |
OpenTouryo を ZIP（タグ 03-20）で取得してビルドし、OpenTouryoAssemblies へ複写 |
3_BuildLibsAtOtherReposInTimeOfDev.bat |
同上（develop の ZIP）。1_BuildAll.ps1 が呼ぶのはこちら |
10_MultiPurposeAuthSite.bat |
net48 版（CommandLineTools ＋ MultiPurposeAuthSite） |
10_MultiPurposeAuthSiteCore.bat |
net10.0 版（CommandLineToolsCore ＋ MultiPurposeAuthSiteCore） |
z_Common.bat |
共通処理。すべてのビルド バッチが最初に呼ぶ |
z_Common2.bat |
z_Common.bat の devenv 版。未使用（バッチ内の注記を参照） |
3_は0_ExecAllBat.batからは呼ばれない（remで外してある）。 取得の制御は1_BuildAll.ps1 -Libsに寄せた。両方を有効にすると二重に取得する。
2_DeleteFile.batは OpenTouryo では1_DeleteFile.bat。0_ExecAllBat.batがその名前で呼んでいたため、削除ステップが空振りしていた。 現在は正しい名前を呼ぶ。
OpenTouryo の root/programs/CS/z_Common.bat の移植。足並みを揃えること。
| 解決するもの | 内容 |
|---|---|
BUILDFILEPATH |
MSBuild.exe。vswhere で解決するので、Community 以外（Professional / Enterprise / BuildTools）でも見つかる |
NUGET_MSBUILD |
nuget.exe restore に渡す -MSBuildPath。指定しないと SSMS 同梱の MSBuild を掴むことがある |
VisualStudioVersion |
vswhere から取得する。固定値だと、別の VS しか無い環境で MSB4226 になる |
COMMANDLINE |
/p:Configuration=... /p:DebugType=... -v:d |
見つからなければ exit /b 1 で止める。 空のまま進むと /p:Configuration=... 自体が
コマンドとして実行され、原因が分かりにくい。
BUILD_CONFIG と DEBUG_TYPE は if not defined で、呼び出し側が先に設定していればそれを尊重する。
1_BuildAll.ps1 -Configuration Release はこれを使っている。
Release を回すようになったのは新しい。 バッチは長く
Debug固定だったため、 Release でしか出ない不具合が埋もれていた（NetFxLibrary.csprojのDefineConstantsにNETFXが無く、net48 が通らなかった。修正済み）。 構成を変えたら、両方で建てて確かめること。
このファイルは純 ASCII にすること。 理由は
CODING.md4 節。
net48 版の Web アプリは packages.config を使う。
root/programs/MultiPurposeAuthSite/MultiPurposeAuthSite/packages.config
packages.config は MSBuild の -t:Restore では復元できない。 nuget.exe restore が要る。
このため root/programs/nuget.exe をリポジトリに置いてある（OpenTouryo と同じ）。
バッチは "%~dp0nuget.exe" と、自分の隣を直接呼ぶ。 カレント ディレクトリに依らない。
一方 CommonLibrary/NetFxLibrary.csproj は PackageReference なので、
そちらは MSBuild の Restore が要る。両方を回す。
"%~dp0nuget.exe" restore "...sln" %NUGET_MSBUILD% ← packages.config
%BUILDFILEPATH% %COMMANDLINE% /t:Restore "...sln" ← PackageReference
%BUILDFILEPATH% %COMMANDLINE% "...sln" ← ビルド
かつて、この最後の行が無かった。 ビルド行に
/t:Restoreが付いていたため、 net48 のソリューションは復元されるだけで一度もビルドされていなかった。
1_DeleteDir.bat は packages も消す。nuget.exe が無い状態でこれを回すと、
net48 版はそこから復元できなくなる。
1_BuildAll.ps1 は nuget.exe が見つからないとき、クリーンを見送る。
10_MultiPurposeAuthSite.bat は警告を出して続行する（packages が既にあれば通るため）。
root/programs/CommonLibrary/
NetFxLibrary.csproj ← net48 （旧形式、Compile Include を明記）
NetCoreLibrary.csproj ← net10.0 （SDK 形式、Compile Remove で除外）
obj/ ← **共有**
bin/netfx/, bin/netcore/ ← こちらは分かれている
obj/project.assets.json は 1 つしかない。後から復元した方が上書きする。
net10.0 を建てた直後に net48 を建てると、project.assets.json が net10.0 のものになっている。
そのため net48 側では必ず先に Restore を回す（6 節）。
1_BuildAll.ps1 は net48 → net10.0 の順で回すので、通しで使うぶんには意識しなくてよい。
-Only で片方だけ建てるときに踏む。
エラーは 0 でなければならないが、警告は残っている。
| ターゲット | 警告の行数 |
|---|---|
| net48 | 0 |
| net10.0 | 0 |
警告は 0 である。 #242 で 45 / 39 から落とした。増えたら、それは今回の変更が出したものである。
落とし方（#242）。同じことが再発したら、ここを見て同じ手を使う。
| コード | もとの件数 | 対処 |
|---|---|---|
MSB3277 |
40 / 33 | 版を揃えた。 net10.0 は Microsoft.Data.SqlClient を 7.0.2（Open棟梁 のアセンブリが 7.0.0.0 を参照）。net48 は Microsoft.Extensions.Logging.Abstractions / ...DependencyInjection.Abstractions を 10.0.1 で明示参照（低い版が primary に選ばれ、Microsoft.IdentityModel.Tokens が要求する版と食い違っていた） |
NU1901 |
6 | Microsoft.VisualStudio.Web.CodeGeneration.Design の参照を外した（スキャフォールディング専用の開発時ツールで、推移的に NuGet.Packaging / NuGet.Protocol 6.12.1 を引いていた） |
CS0618 |
2 | CustomPasswordHasher の V1 経路を #pragma warning disable 618 で囲んだ（旧いハッシュの照合に要るので、呼び出しは変えていない） |
CS0219 |
1 | BundleConfig の未使用の変数を削った |
CS1685 / CS1702 |
1 / 1 | メッセージに落とした（MultiPurposeAuthSite.csproj の MSBuildWarningsAsMessages）。ビューのプリコンパイル（ASPNETCOMPILER）が出すもので、netstandard のファサードと参照アセンブリの重複によるため、こちらの参照では消せない。プリコンパイル自体は従来どおり動いている（ログには ASPNETCOMPILER : message CS1685 として出る） |
MSBuildWarningsAsMessagesを増やすときは、理由を書くこと。 「うるさいから消した」と「消してよいと確かめた」を、後から読む人が区別できるように。
-WarnDetail で種類ごとの件数と代表例が出る。
同じ種類は、たいてい 1 か所の対処でまとめて消える。
クリーン ビルド（nuget.exe あり）。
構成 : Debug
=== Clean (dir) ===
OK エラー 0 / 警告 0 (6.5 秒)
=== Clean (file) ===
OK エラー 0 / 警告 0 (0.5 秒)
=== net48 ===
OK エラー 0 / 警告 45 (126.8 秒)
=== net10.0 ===
OK エラー 0 / 警告 39 (58.9 秒)
================ サマリ ================
ステップ 結果 エラー 既知 警告 秒
------------ ---- ------ ---- ---- -----
Clean (dir) OK 0 0 0 6.5
Clean (file) OK 0 0 0 0.5
net48 OK 0 0 45 126.8
net10.0 OK 0 0 39 58.9
所要時間 : 3.2 分
ログ : C:\MultiPurposeAuthSite\root\programs\Tests\E2ETests\Result
全ステップ OK
root/programs/OpenTouryoAssemblies/Build_net48 と Build_netcore100 を参照している。
.gitignore 済みなので、clone しただけでは無い。
1_BuildAll.ps1 は、無ければ取得してから建てる（-Libs Auto が既定。
develop の ZIP を取得してビルドし、OpenTouryoAssemblies へ複写する）。
OpenTouryo 側を更新したときは -Libs Force で取り直す。
手で用意することもできる。3_BuildLibsAtOtherRepos.bat（タグ 03-20）を実行するか、
OpenTouryo を別途 clone してビルドし、mpas_dev.bat で複写する。
取得ステップの合否は、出力ではなくフォルダの実在で判定している。
xcopyの失敗は: errorの形で出ないため、出力解析では拾えない。
-Libs Force でアセンブリを取り直しても、アプリの出力が古いままになることがある。
MSBuild は、参照の解決でプロジェクト配下の出力フォルダも候補にする。
したがって、ビルドが削除できずに名前を変えて残した出力（bin_locked_<日時> など）が
プロジェクト直下に在ると、HintPath より先に、そこが解決される。
解決されたファイル パスは "...\MultiPurposeAuthSiteCore\bin_locked_20260929_103249\Debug\net10.0\OpenTouryo.Public.Security.dll" です。
bin と obj を消しても直らない。 残骸は bin ではないので、Clean の対象にならない。
実測（2026/10/03。#129 の段階 3） : 上流の修正（OpenTouryo#595）を
取り込んだあと、net48 版だけ直り、net10.0 版は直らなかった。
net10.0 版のプロジェクト直下に 9 月 29 日の bin_locked_* が残っており、
そこの古い DLL が解決されていた。消して建て直したら直った。
見分け方。 参照しているアセンブリと、アプリの出力を突き合わせる。
# 参照元（新しいはず）
Get-Item root\programs\OpenTouryoAssemblies\Build_netcore100\net10.0\OpenTouryo.Public.Security.dll |
Select-Object Length, LastWriteTime
# アプリの出力（古ければ、別の場所から来ている）
Get-ChildItem root\programs\MultiPurposeAuthSiteCore\MultiPurposeAuthSiteCore\bin -Recurse `
-Filter OpenTouryo.Public.Security.dll | Select-Object FullName, Length, LastWriteTime
# 残骸を探す
Get-ChildItem root\programs -Recurse -Directory -Filter "bin_locked*"どこから来たかは MSBuild に聞ける。
dotnet build <sln> -c Debug -v:detailed | Select-String "解決されたファイル パス.*OpenTouryo.Public.Security"サイトを動かしたままビルドすると、この残骸ができる。 E2E は起動と停止を行うが、落ちたサイトが残ると
binを掴み続ける。 詳細 →TESTING.md5 節
OpenTouryo のビルド バッチは、兄弟のバッチを裸の名前で呼ぶ（call 2_Build_NuGet_net48.bat）。
NoDefaultCurrentDirectoryInExePath が定義されている環境では、カレント ディレクトリが
実行ファイルの探索から外れるため、これが is not recognized になり、
何も建たないまま xcopy まで進む。
'2_Build_NuGet_net48.bat' is not recognized as an internal or external command,
File not found - Build_net48
0 File(s) copied
dir や where では見つかるので、パスの間違いに見えて原因を取り違えやすい。
1_BuildAll.ps1 は取得ステップの間だけこの変数を外す。
空にするのでは足りない（定義されていて空でも外れる）ので、消している。
これはエージェント実行時だけの現象である。 計測すると、この変数は ユーザ / マシン環境にもレジストリにも無く、プロセスにだけ注入されている （親プロセスは
claude.exe）。 人が通常のコンソール / Visual Studio / ダブル クリックで回す分には起きない。 このため、バッチ側（裸の名前で兄弟バッチを呼ぶ箇所）は書き換えていない。
net48 版は旧形式の csproj と ASPNETCOMPILER を使うため、MSBuild でしか建たない。
dotnet build は net10.0 版と Tests/ 用。
ビルドは通るが、起動には appsettings.json / app.config が要る。
どちらも .gitignore 済み。雛形（_appsettings.json / _app.config）から作る。
詳細は CONFIGURATION.md。
2_DeleteFile.bat は root\programs 配下を再帰的に走査して
*.suo *.user *.tmp *.log *.bak *.skrold を削除する。
- 手元の控え（
*.bak）をリポジトリ内に置くと、クリーン時に消える - ログの保存先（
Tests\E2ETests\Result）の*.logも消える。 毎回きれいになるのは都合がよいが、 失敗したログを読む前に建て直すと、その内容を失う（.trxは残る）