NSwag狀況錯誤記錄

NSwag 筆記記錄(亂碼跟XML沒跑出)     

  1. NSwag 記錄的 AddOpenApiDocument 裡面  Description發生亂碼

=> 用VS 對此檔案使用   另存  Programs 或 StartUp 那邊使用這個並且改為 ,以編碼方式儲存,很有可能你的檔案是Big5,         

 

請改成以下

 

 

 

 

2. Swagger 畫面本機可以,一旦上到雲端之類的就顯示不出

=> 解決方式:這個順序性很重要,一旦 不對就顯示不出            

<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
    <OutputPath>bin\</OutputPath>
    <DocumentationFile>SwaggerModelXml\XXX.WebApi.xml</DocumentationFile>
  </PropertyGroup>

	<ItemGroup>
		<None Remove="SwaggerModelXml\XXX.WebApi.xml" />
	</ItemGroup>

	<PropertyGroup>
		<GenerateDocumentationFile>true</GenerateDocumentationFile>
		<NoWarn>$(NoWarn);1591</NoWarn>
	</PropertyGroup>

	<ItemGroup>
		<Content Include="SwaggerModelXml\XXX.WebApi.xml">
			<CopyToOutputDirectory>Always</CopyToOutputDirectory>
		</Content>
	</ItemGroup>

 

如果發生自己的 Request Enum 從body上消失或是自己的泛型物件 Response 消失,而且只有出現在本機狀況,請先測試看看無痕,看會不會出現,如果真出現,請F12清除快取並重新整理即完成