WiX拡張機能のバージョン互換性問題を修正してインストーラービルドを修正する by Copilot · Pull Request #198 · Freeesia/VdLabel

Copilot · 2026-04-05T08:59:41Z

WixSharp がデフォルトで WiX 拡張機能の v7.0.0-rc.2 をインストールしようとするが、WiX v6 は wixext6 フォルダ構造を期待しており非互換のためビルドが失敗していた。また、VdLabel.Wix.csproj が net472（.NET Framework）をターゲットにしており、WixSharp_wix4 が現代の .NET を必要とするため実行時エラーが発生していた。

変更内容

VdLabel.Wix/VdLabel.Installer.wixproj（新規作成）: WiX 拡張機能のバージョンを PackageReference で管理する .wixproj ファイルを作成。WixToolset.Sdk/6.0.2 を使用し、拡張機能を宣言
VdLabel.Wix/VdLabel.Wix.csproj: TargetFramework を net472 から net8.0-windows に変更。WixSharp_wix4.bin が内部で System.Drawing.Common（画像検証等）を使用するため -windows サフィックスが必要。不要な System.Windows.Forms の明示的参照も削除
VdLabel.Wix/AssemblyInfo.cs（新規作成）: [assembly: InternalsVisibleTo("VdLabel.Wix.aot")] を追加。AfterInstall のラムダが生成する匿名型を WixSharp の AOT ハンドラー検証が通過できるようにする
VdLabel.Wix/Program.cs: PreferredVersion 設定を削除。Compiler.BuildWxs(project) でWXS生成のみを担当するように変更（プロジェクト名 "VdLabel" からデフォルトで VdLabel.wxs が生成される）
CI（dotnet-desktop.yml）: wix extension add コマンドを削除し、dotnet run --project VdLabel.Wix.csproj（WXS 生成）+ dotnet build VdLabel.Installer.wixproj（MSI ビルド）の 2 ステップに変更

これにより dotnet-tools.json（WiX 本体）+ VdLabel.Installer.wixproj（拡張機能）の構成になりました。VdLabel.wxs はビルド時に生成されるファイルのため、リポジトリには含まれません。

Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/95c2d3ad-f5f8-49c9-84e7-a1f686ef8a80 Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Freeesia · 2026-04-05T09:21:35Z

@copilot
バージョンをスクリプトで管理したくない。以下の資料を基に対応して。

WiX を dotnet tool で使うときの整理

結論

dotnet tool restore は、WiX を ローカルツール として使うなら必要
dotnet wix extension add ... は、WiX CLI を直接使う運用 では必要になりやすい
ただし、設定ファイルに寄せたいなら .wixproj に PackageReference で書くのが推奨

何をどこに書けるか

1. WiX 本体のバージョン

.config/dotnet-tools.json に書ける。

{
  "version": 1,
  "isRoot": true,
  "tools": {
    "wix": {
      "version": "6.0.2",
      "commands": ["wix"],
      "rollForward": false
    }
  }
}

2. WiX 拡張のバージョン

.wixproj に PackageReference として書ける。

<Project Sdk="WixToolset.Sdk/6.0.2">
  <ItemGroup>
    <PackageReference Include="WixToolset.Util.wixext" Version="6.0.2" />
    <PackageReference Include="WixToolset.UI.wixext" Version="6.0.2" />
  </ItemGroup>
</Project>

今の3行コマンドの位置づけ

dotnet tool restore
dotnet wix extension add -g WixToolset.Util.wixext/6.0.2
dotnet wix extension add -g WixToolset.UI.wixext/6.0.2

これは CLI 直叩き前提なら妥当。

ただし、毎回拡張追加を前提にするより、.wixproj に寄せた方が以下の点で扱いやすい。

バージョンがリポジトリに残る
開発者ごとの差分が減る
CI で再現しやすい
dotnet build に寄せられる

使い分け

A. `wix build` を直接使いたい

dotnet tool restore
必要な wix extension add を実行
必要に応じて -ext 指定でビルド

B. `.wixproj` で管理したい

dotnet tool restore
.wixproj に PackageReference
dotnet build でビルド

通常は B のほうが管理しやすい。

実務向けの判断

設定ファイルにまとめたい

→ .wixproj に寄せる

単発スクリプトで WiX CLI を直接使う

→ wix extension add を使う

VdLabel のように継続運用するプロジェクト

→ dotnet-tools.json + .wixproj の組み合わせが無難

最終結論

WiX 本体のバージョン は dotnet-tools.json に書ける
WiX 拡張のバージョン は .wixproj に書ける
wix extension add の内容をそのまま専用設定ファイルに固定するより、.wixproj に寄せるのが実用的

必要なら次に、VdLabel 向けの最小 .wixproj テンプレート と GitHub Actions 用の restore/build 手順 まで出せる。

Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/c743b634-a05f-4cd1-b68c-a0db83f7dd1d Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot · 2026-04-05T09:31:12Z

@copilot
バージョンをスクリプトで管理したくない。以下の資料を基に対応して。

...

2913b71 で .wixproj + PackageReference 方式に変更しました。

VdLabel.Installer.wixproj を新規作成し、拡張機能のバージョンを PackageReference で宣言
Program.cs から PreferredVersion 設定を削除し、Compiler.BuildWxs() で WXS 生成のみを担当するように変更
CI から wix extension add コマンドを削除し、dotnet run（WXS生成）+ dotnet build VdLabel.Installer.wixproj（MSIビルド）の 2 ステップに変更

これにより dotnet-tools.json（WiX 本体）+ VdLabel.Installer.wixproj（拡張機能）の構成になりました。

Freeesia · 2026-04-05T09:49:02Z

@copilot
dotnet run -c Releaseで以下のエラー。

VdLabel.Wix に複数のプロジェクト ファイルが含まれているため、使用するプロジェクト ファイルを指定してください。

dotnet build VdLabel.Installer.wixprojで以下のエラー

復元が完了しました (1.8 秒)
  VdLabel.Installer native 2 件のエラーで失敗しました (1.9 秒)
    wix.exe : error WIX0103: Cannot find the input file 'VdLabel.wxs'.
    wix.exe : error WIX0391: No source files specified.

8.9 秒後に 2 件のエラーで失敗しました をビルド

Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/f7fe7368-2bfb-4473-a230-c7d1a8eb2597 Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot · 2026-04-05T09:52:34Z

@copilot
dotnet run -c Releaseで以下のエラー。

...

b4632fa で修正しました。

dotnet run --project VdLabel.Wix.csproj -c Release に変更（.csproj と .wixproj の両方があることで起きた曖昧エラーを解消）
Compiler.BuildWxs(project, "VdLabel.wxs") で出力ファイル名を明示指定（.wixproj の Compile Include と一致）

Freeesia · 2026-04-05T10:09:03Z

@copilot
そもそも、VdLabel.wxsないけど問題ない？

Copilot · 2026-04-05T10:09:52Z

@copilot
そもそも、VdLabel.wxsないけど問題ない？

VdLabel.wxs はビルド時に dotnet run --project VdLabel.Wix.csproj -c Release（Compiler.BuildWxs() の呼び出し）で生成されるファイルです。リポジトリに存在しないのは意図通りで問題ありません。CI の実行順序（先に dotnet run、次に dotnet build VdLabel.Installer.wixproj）で正しく動作します。

Freeesia · 2026-04-05T10:45:14Z

@copilot
dotnet run --project VdLabel.Wix.csproj -c Releaseは以下のエラー。
既存のcsprojやコードも確認して。net472はまだ必要？

   Exception.ToString() が失敗したため、例外文字列を表示できません。

…s.Forms 参照を削除 Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/bc7d8969-4700-4345-820e-9506556f7d11 Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot · 2026-04-05T10:46:59Z

@copilot
dotnet run --project VdLabel.Wix.csproj -c Releaseは以下のエラー。
既存のcsprojやコードも確認して。net472はまだ必要？
...

d4464d4 で修正しました。

net472（.NET Framework）は不要です。WixSharp_wix4 は現代の .NET 向けのパッケージで、.NET Framework では正しく動作しません（"Exception.ToString() が失敗した" はその互換性エラーです）。

TargetFramework を net472 → net8.0-windows に変更
.NET Framework スタイルの System.Windows.Forms 明示参照を削除（WXS 生成だけなら不要）

Freeesia · 2026-04-05T10:55:09Z

@copilot
ターゲットに-windowsは必要？不要なら削除して、動作するか確認までやって。

手元では以下のエラーになっている。

VdLabel.Wix.csproj : warning NU1701: パッケージ 'WixSharp_wix4.bin 2.12.3' はプロジェクトのターゲット フレームワーク 'net8.0' ではなく '.NETFramework,Version=v4.6.1, .NETFramework,Version=v4.6.2, .NETFramework,Version=v4.7, .NETFramework,Version=v4.7.1, .NETFramework,Version=v4.7.2, .NETFramework,Version=v4.8, .NETFramework,Version=v4.8.1' を使用して復元されました。このパッケージは、使用しているプ ロジェクトとの完全な互換性がない可能性があります。
VdLabel.Wix.csproj : warning NU1701: パッケージ 'WixSharp_wix4.bin 2.12.3' はプロジェクトのターゲット フレームワーク 'net8.0' ではなく '.NETFramework,Version=v4.6.1, .NETFramework,Version=v4.6.2, .NETFramework,Version=v4.7, .NETFramework,Version=v4.7.1, .NETFramework,Version=v4.7.2, .NETFramework,Version=v4.8, .NETFramework,Version=v4.8.1' を使用して復元されました。このパッケージは、使用しているプ ロジェクトとの完全な互換性がない可能性があります。
Program.cs(63,28): error CS1503: 引数 2: は 'string' から 'WixSharp.Compiler.OutputType' へ変換することはできません

Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/b129b47b-3930-4302-9b0b-1b8e8c194134 Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot · 2026-04-05T10:58:32Z

@copilot
ターゲットに-windowsは必要？不要なら削除して、動作するか確認までやって。

...

c3ce1a6 で修正しました。

net8.0-windows → net8.0 に変更（WixSharp は WPF/WinForms API を使わないので -windows 不要）
Compiler.BuildWxs(project, $"{App}.wxs") → Compiler.BuildWxs(project) に修正（string を受け取るオーバーロードは存在せず、第 2 引数は Compiler.OutputType 型）。プロジェクト名 "VdLabel" から自動的に VdLabel.wxs が生成されます

NU1701 警告（WixSharp_wix4.bin が .NET Framework のみをターゲットにしている）は引き続き表示されますが、ビルドエラーはなく dotnet build は成功します。

Freeesia · 2026-04-05T12:59:42Z

@copilot
actionsのエラー直して。

…検証エラーを修正 Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/b4cc288b-a6ba-4ae5-918c-eb64f2bbda0d Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot · 2026-04-05T13:01:34Z

@copilot
actionsのエラー直して。

eb33251 で修正しました。

CI のエラーは AfterInstall に登録したラムダが匿名型 Program+<>c を生成し、WixSharp の AOT ハンドラー検証で「非公開」として拒否されていたものです。AssemblyInfo.cs に [assembly: InternalsVisibleTo("VdLabel.Wix.aot")] を追加することで解消します。

Freeesia · 2026-04-05T15:02:34Z

@copilot
CIエラーまだ出てる

Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/a24152a5-067b-4b53-b324-0cb926019c11 Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot · 2026-04-05T15:04:18Z

@copilot
CIエラーまだ出てる

6fc723f で修正しました。

WixSharp_wix4.bin は内部で System.Drawing.Common（画像検証等）を使用しており、net8.0-windows でのみ利用可能です。前回 -windows は不要と判断しましたが誤りで、TargetFramework を net8.0-windows に戻しました。

Freeesia · 2026-04-05T15:56:28Z

@copilot
CIエラーまだ出てる

Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/ffc37bcf-46e4-4a61-a9ea-96970089cd2a Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot · 2026-04-05T15:58:05Z

@copilot
CIエラーまだ出てる

adf6026 で修正しました。

.NET 6 以降、System.Drawing.Common は Windows でも自動的に含まれなくなっており、明示的な PackageReference が必要です。WixSharp_wix4.bin が内部で使用する System.Drawing.Common を VdLabel.Wix.csproj に追加しました。

Initial plan

f15fac6

Copilot AI assigned Copilot and Freeesia Apr 5, 2026

Copilot started work on behalf of Freeesia April 5, 2026 08:59 View session

Copilot AI linked an issue Apr 5, 2026 that may be closed by this pull request

リリース時にインストーラーが作成されない #197

Closed

WiX拡張機能のバージョン互換性問題を修正してインストーラービルドを修正する

63914d3

Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/95c2d3ad-f5f8-49c9-84e7-a1f686ef8a80 Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Fix installer creation issue during release~~ WiX拡張機能のバージョン互換性問題を修正してインストーラービルドを修正する Apr 5, 2026

Copilot finished work on behalf of Freeesia April 5, 2026 09:05

Copilot AI requested a review from Freeesia April 5, 2026 09:05

Freeesia marked this pull request as ready for review April 5, 2026 09:06

Copilot started work on behalf of Freeesia April 5, 2026 09:21 View session

WiX拡張を .wixproj の PackageReference で管理する方式に変更

2913b71

Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/c743b634-a05f-4cd1-b68c-a0db83f7dd1d Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot finished work on behalf of Freeesia April 5, 2026 09:31

Copilot started work on behalf of Freeesia April 5, 2026 09:49 View session

dotnet run に --project を明示指定し複数プロジェクトファイルの競合を解消

b4632fa

Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/f7fe7368-2bfb-4473-a230-c7d1a8eb2597 Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot finished work on behalf of Freeesia April 5, 2026 09:52

Copilot started work on behalf of Freeesia April 5, 2026 10:09 View session

Copilot finished work on behalf of Freeesia April 5, 2026 10:10

Copilot started work on behalf of Freeesia April 5, 2026 10:45 View session

fix: VdLabel.Wix.csproj を net472 から net8.0-windows に変更し System.Window…

d4464d4

…s.Forms 参照を削除 Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/bc7d8969-4700-4345-820e-9506556f7d11 Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot finished work on behalf of Freeesia April 5, 2026 10:47

Copilot started work on behalf of Freeesia April 5, 2026 10:55 View session

fix: TargetFramework を net8.0 に変更し Compiler.BuildWxs の引数を修正

c3ce1a6

Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/b129b47b-3930-4302-9b0b-1b8e8c194134 Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot finished work on behalf of Freeesia April 5, 2026 10:59

Freeesia added 2 commits April 5, 2026 21:16

いったんインストーラー作るようにしてみてる

3441c53

ライセンスもいったん有効にする

d9516e1

Copilot started work on behalf of Freeesia April 5, 2026 12:59 View session

Copilot finished work on behalf of Freeesia April 5, 2026 13:02

Copilot started work on behalf of Freeesia April 5, 2026 15:02 View session

fix: TargetFramework を net8.0-windows に戻す（System.Drawing.Common が必要）

6fc723f

Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/a24152a5-067b-4b53-b324-0cb926019c11 Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot finished work on behalf of Freeesia April 5, 2026 15:05

Copilot started work on behalf of Freeesia April 5, 2026 15:56 View session

fix: System.Drawing.Common を明示的に参照追加（.NET 8 では自動的に含まれない）

adf6026

Agent-Logs-Url: https://github.com/Freeesia/VdLabel/sessions/ffc37bcf-46e4-4a61-a9ea-96970089cd2a Co-authored-by: Freeesia <9002657+Freeesia@users.noreply.github.com>

Copilot finished work on behalf of Freeesia April 5, 2026 15:58

Freeesia added 4 commits April 10, 2026 00:44

いったんそれっぽくなる

a2bde8a

fix: WixToolset を 7.0.0 にアップグレードし、WXS ファイルの出力先を generated/ フォルダに設定

41f8cc9

fix: .wixpdb の出力を抑制する設定を追加

a063c22

コメントアウト戻す

dcc5fa8

Freeesia merged commit acf80db into master Apr 11, 2026
6 checks passed

Freeesia deleted the copilot/fix-installer-creation-issue branch April 11, 2026 14:56

Conversation

Copilot AI commented Apr 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

変更内容

Uh oh!

Freeesia commented Apr 5, 2026

WiX を dotnet tool で使うときの整理

結論

何をどこに書けるか

1. WiX 本体のバージョン

2. WiX 拡張のバージョン

おすすめ構成

ローカル開発・CI 共通

今の3行コマンドの位置づけ

使い分け

A. wix build を直接使いたい

B. .wixproj で管理したい

実務向けの判断

設定ファイルにまとめたい

単発スクリプトで WiX CLI を直接使う

VdLabel のように継続運用するプロジェクト

最終結論

Uh oh!

Copilot AI commented Apr 5, 2026

Uh oh!

Freeesia commented Apr 5, 2026

Uh oh!

Copilot AI commented Apr 5, 2026

Uh oh!

Freeesia commented Apr 5, 2026

Uh oh!

Copilot AI commented Apr 5, 2026

Uh oh!

Freeesia commented Apr 5, 2026

Uh oh!

Copilot AI commented Apr 5, 2026

Uh oh!

Freeesia commented Apr 5, 2026

Uh oh!

Copilot AI commented Apr 5, 2026

Uh oh!

Freeesia commented Apr 5, 2026

Uh oh!

Copilot AI commented Apr 5, 2026

Uh oh!

Freeesia commented Apr 5, 2026

Uh oh!

Copilot AI commented Apr 5, 2026

Uh oh!

Freeesia commented Apr 5, 2026

Uh oh!

Copilot AI commented Apr 5, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Apr 5, 2026 •

edited

Loading

A. `wix build` を直接使いたい

B. `.wixproj` で管理したい