2017-01-11 12 views
0

私は、出力からのprojectname.xmlドキュメントを必要とするApiドキュメント用のSwashbuckleを使用していますが、私はASP.NET Coreプロジェクトをビルドするとそのファイルを取得しません。ASP.NETコアはXMLコメントファイルを作成しません

https://docs.microsoft.com/en-us/aspnet/core/tutorials/web-api-help-pages-using-swagger

Visual Studioは、XMLファイルを生成するオプションを持っていますが、どのように私は、コンソールからのことを行うことができますか?

.NET Command Line Tools (1.0.0-preview2-1-003177) 

答えて

1

Visual Studio 2017およびdotnet CLIの場合、.csprojファイルのDocumentationFileプロパティを設定すると、指定したパスにプロジェクトファイルを基準にXMLドキュメントが生成されます。たとえば、構築されたアセンブリと同じディレクトリにあるXMLドキュメントを生成するために、プロジェクトファイルに次のプロパティグループを追加することができます。

<PropertyGroup> 
    <DocumentationFile>bin\$(Configuration)\$(TargetFramework)\MyProject.xml</DocumentationFile> 
</PropertyGroup> 

あなただけそれが特定の構成またはプラットフォーム用に構築されたい場合は、確認してください適切なConditionをプロパティグループに設定します。

1

あなたがまだのVisual Studio 2015を使用している場合は、あなたがbuildOptions

"buildOptions": { 
    "xmlDoc": true, 
} 

xmlDocを追加することにより、project.jsonでそれを行うことができます:ここで

は私のASP.NETのCoreバージョンでありますVisual Studio 2017(* .csproj構造体)わかりません。しかし、Visual Studioで設定すると、csproj/project.jsonファイルに保持されます。

関連する問題