csproj

1. 新しいcspojの紹介
安井彰一
@Shaula0x0400

2. 自己紹介
Facebook:安井彰一
Twitter:@Shaula0x0400
Github:the9ball
株式会社オレンジキューブ所属

3. csprojの中身

4. 旧形式
なにがなんだかわからない！！！

5. 新形式
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>netcoreapp2.0</TargetFramework>
</PropertyGroup>
</Project>
たったこれだけ！！！

6. 新形式の利点
● 短く簡潔！
○ ソースコードを列挙しなくて良い
○ パッケージへの参照を自動で辿ってくれる
■ 参照先のプロジェクトに必要な参照を
参照元では管理する必要がない
○ コンフリクト地獄からの開放
● 旧形式からの移行が簡単

7. ソースコードを列挙しなくて良い とは
● 旧形式だと以下のような
ソースコードの列挙が必要だった
<ItemGroup>
<Compile Include="hogefuga.cs" />
...
<Compile Include="Program.cs" />
<Compile Include="Properties¥AssemblyInfo.cs" />
</ItemGroup>
コンフリクトの主な原因

8. Nuget等の参照を自動で辿ってくれる
● 旧形式だと以下のように参照先で必要なパッケージを
参照元からも参照する必要があった
ClassLibrary Application
Package
この参照が必要だった

9. 新形式への移行

10. 移行方法
● 参照パッケージをメモ
● シンボル定義をメモ
● 新形式の雛形をコピペ
● TargetFrameworkを書き換え
● 参照パッケージを追加(復元)
● シンボル定義を追加(復元)

11. 移行方法 - 参照パッケージをメモ
● csprojに記載がある場合
○ <ItemGroup><Reference Include=...
● package.json
○ “dependencies”: {...

12. 移行方法 - シンボル定義をメモ
● ビルド構成毎に設定されているので必要なものをメモ
<PropertyGroup Condition=...>
...
<DefineConstants>...</DefineConstants>
...

13. 移行方法 - 新形式の雛形をコピペ
● テキストエディタなどでcsprojを開く(以降省略)
○ VSの場合はUnload Project -> Edit *.csproj
● 雛形をコピペ
○ .NET Coreのプロジェクトテンプレートを流用
○ 他のプロジェクトの中身を流用
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>netcoreapp2.0</TargetFramework>

14. 移行方法 - TargetFrameworkを書き換え
● TargetFrameworkを書き換える
○ .NET Framework なら netXXX ( net35 net462 )
○ .NET Core なら netcoreappX.X / netstandardX.X
○ プロジェクトのプロパティからも変更可能だが
.NET Framework ⇔ .NET Coreの切り替えはできない模様

15. 移行方法 - 参照パッケージを追加(復元)
● パッケージを追加
○ VSの場合はDependenciesを右クリックしてGUI操作
<ItemGroup>
<!-- Nuget -->
<PackageReference Include="パッケージ名" Version="バージョン" />
<!-- Project -->
<ProjectReference Include="csprojまでの相対パス" />
<ItemGroup>

16. 移行方法 - シンボル定義を追加(復元)
● 元々あった定義をそのままコピペ
○ VSの場合はプロパティ - ビルドからGUIで設定可能
<PropertyGroup Condition=...>
<DefineConstants>...</DefineConstants>
</PropertyGroup>

17. 移行方法 - ビルドしてみる
● ビルドがうまくいかない場合
○ 改修前のもので特殊な設定があれば
そのままコピペしてきてみる
○ リファレンスを調べる
■ MSBuild プロジェクト ファイル スキーマ リファレンス
https://docs.microsoft.com/ja-jp/visualstudio/msbuild/msbuild-
project-file-schema-reference
■ MSBuild プロジェクトの共通プロパティ

18. Tips

19. 参照パッケージのバージョンを自動解決できない
以下のようなエラーが発生した場合
ファイルまたはアセンブリ 'XXXX, Version=X.X.X.X, Culture=neutral,
PublicKeyToken=XXXXXXXX、またはその依存関係の 1 つが読み込めませんでし
た。見つかったアセンブリのマニフェスト定義はアセンブリ参照に一致しません。
(HRESULT からの例外:0x80131040)
原因
参照しているパッケージのバージョン定義が不揃いである

20. 参照パッケージのバージョンを自動解決できない
参照しているパッケージのバージョン定義が不揃いである
ClassLibraryA
Application
PackageC v1
ClassLibraryB
PackageC v2
どちらのバージョンを
使用すべきかわからない

21. 参照パッケージのバージョンを自動解決できない
どのバージョンを使用するのかを指定する
● app.config ファイルを作成する
● bindingRedirect 属性を指定する
○ <bindingRedirect> Element
https://docs.microsoft.com/en-
us/dotnet/framework/configure-apps/file-
schema/runtime/bindingredirect-element

22. 複数フレームワークバージョン指定
● TargetFramework を TargetFrameworks に書き換え
● ;区切りでバージョンを列挙
<TargetFrameworks>net462;netcoreapp1.1</TargetFrameworks>
● VS上ではそれぞれの状態を切り替え可能

23. csprojの外側にあるファイルを参照する
● csprojと同じディレクトリから下にあるcsファイルは
自動的にプロジェクト参照に追加される
● csprojの外側にあるファイルを参照する場合は
以下のタグを追加する
<ItemGroup>
<Compile Include="csファイルへのパス" />
</ItemGroup>

24. csprojの外側にあるファイルを参照する
● ファイルをプロジェクトエクスプローラ上で表示したい場合
<Compile Include="csファイルへのパス" Link="ファイル名" />
● 特定ディレクトリ以下の
ファイルすべてを参照したい場合
<Compile Include="ディレクトリへのパス¥**¥*.cs"
Exclude="ディレクトリへのパス¥AssemblyInfo.cs;ディレクトリへのパス¥obj¥**¥*.cs"
/>

25. csprojの外側にあるファイルを参照する
● VS上ではそれぞれの状態を切り替え可能

26. ビルドイベント
● PreBuild/PostBuildイベント
○ 旧形式ではPreBuildEvent/PostBuildEventタグ
<Target Name="PreBuild" BeforeTargets="PreBuildEvent">
<Exec Command="コマンド" />
</Target>
<Target Name="PostBuild" AfterTargets="PostBuildEvent">
<Exec Command="コマンド" />
</Target>

27. 外部ファイルの参照
● 他のファイルに記載した内容をそのまま展開する
<Import Project="ファイルへのパス" />

28. NugetPackageの作成
● NugetPackage作成に必要だったnuspecファイルは
新形式だと不要になった
<GeneratePackageOnBuild>true</GeneratePackageOnBuild>
● Authorsなどの付加情報は<Authors>などのタグで追加する
● VSだとプロジェクトのプロパティで編集可能

29. 最後に

30. オレンジキューブでは、一緒に
ゲームを作ってくれる仲間を募集しています。
以下のどれか1つでも当てはまる場合はおすすめです。
是非一度お話をしましょう。
・C# が好き
・ワンソースマルチプラットフォームで海外展開しているクリユニに興味がある
・短時間で決着する対戦ゲームに興味がある
・リッチなドット絵のゲームに興味がある
・ローグライクゲームが好き
・さらなるストラテジーの進化に挑戦してみたい
・ゲーム作るのも好きだが、プレイするのも大好き
もしご興味があればお気軽にご連絡ください。
https://www.wantedly.com/projects/114864