Wie Sie XML-Kommentardateien in Swagger in ASP.NET Core einbinden

Question

Ich brauche Swagger Generate API-Dokumentation einschließlich UI zum Testen von Operationen.

Bei Verwendung ASP.NET in meinem Projekt, XML-Dateien deps erzeugt werden, alles in Ordnung ist, das wie folgt aussehen: enter image description here

Aber wenn ich ASP.NET-Core in meinem Projekt verwenden, deps XML-Dateien nicht erzeugt. Es generiert nur meine Projektkommentars-XML-Datei, wie folgt aussehen:

Und wenn ich mein Projekt zu IIS bereitstellen, das Projekt XML nicht in der Bereitstellung von Dateien Liste.

Answer 1

Aktivieren Sie "XML-Dokumentationsdatei" Kontrollkästchen für jedes Projekt Sie hängen davon ab, ihre Dateien auf Build zu generieren. Dies könnte auf der Registerkarte Build des Projekts geschehen.

Um alle XML-Dateien auf deploy enthalten, hinzufügen, um dieses Ziel zu dem csproj Datei veröffentlichten Projektes:

<Target Name="PrepublishScript" BeforeTargets="PrepareForPublish"> 
    <ItemGroup> 
     <DocFile Include="bin\*\*\*.xml" /> 
    </ItemGroup> 
    <Copy SourceFiles="@(DocFile)" 
      DestinationFolder="$(PublishDir)" 
      SkipUnchangedFiles="false" /> 
</Target> 

Dadurch wird alle XML-Dateien aus bin Ordnern und verschachtelte Unterordner (wie bin\Release\netcoreapp1.1\) zu publish dir kopieren. Natürlich können Sie dieses Ziel anpassen.