Menyertakan Dokumentasi XML yang Dihasilkan dalam Paket Layanan Azure Cloud

EDIT: Diperbarui untuk menentukan bahwa masalah hanya terjadi saat mengemas file CSPKG layanan cloud Azure.

Saya memiliki aplikasi ASP.NET Web API 2 yang bertindak sebagai peran web dalam solusi layanan cloud Azure. Saya ingin menggunakan Halaman Bantuan API Web dan memanfaatkan dokumen yang dihasilkan XML untuk mengisinya. Saya mengalami kesulitan mencari cara untuk memasukkan dokumentasi XML ke dalam kemasan cloud Azure dari proyek Web Api.

Dokumentasi XML dengan benar masuk ke direktori bin secara lokal dan ketika diterbitkan ke lokasi sistem file, namun hilang ketika Anda memeriksa arsip cspkg atau direktori approot peran web yang diterapkan.

Apakah ada cara untuk memaksa kemasan menyertakan XML?


azure tfs asp.net-web-api msbuild xml-documentation
person RMD    schedule 03.10.2014    source sumber
comment
Mengapa Anda memerlukan dokumentasi XML pada instans Azure?   -  person Peter Ritchie    schedule 04.10.2014
comment
Karena saya memanfaatkan halaman bantuan API web yang dibuat secara otomatis.   -  person RMD    schedule 04.10.2014

Jawaban (1)


arrow_upward
14
arrow_downward

Anda dapat mengatur ExcludeXmlAssemblyFiles ke false di PropertyGroup Proyek Anda untuk memaksa semua file xml disertakan dalam paket Azure:

<ExcludeXmlAssemblyFiles>false</ExcludeXmlAssemblyFiles>

person sm85    schedule 11.10.2014
comment
FYI - Saya harus menambahkan ini ke file proyek Web API. Menambahkannya ke proyek cloud tidak berpengaruh. Terima kasih! - person RMD; 13.10.2014
comment
Milik saya tidak berfungsi. Saya dapat melihat file xml di dalam folder bin, tetapi tidak ada di dalam folder approot. Saya menambahkan tag ini ke proyek web. Ada bantuan? - person Luís Deschamps Rudge; 10.04.2015
comment
Saya menambahkan ini ke profil publikasi untuk proyek Web.API saya (di Properties\PublishProfiles\xxx.pubxml. Berhasil, terima kasih atas bantuannya! - person Morgan Skinner; 03.02.2016
comment
Jawaban ini tidak berhasil untuk saya. File proyek sudah menetapkan ExcludeXmlAssemblyFiles ke false. Yang aneh adalah jika saya mengemas file dari mengklik proyek cloud dalam solusi xml disertakan, tetapi ketika saya mencoba melakukan ini melalui baris perintah dengan MSBuild.exe file xmlnya hilang. - person Jazaret; 18.03.2016
comment
Saya bingung mengapa ini tidak berhasil untuk saya juga, tapi kemudian saya ingat kami memiliki definisi build server build kami yang disesuaikan untuk meneruskan argumen /p:AllowedReferenceRelatedFileExtensions=none ke msbuild (sebagai solusi lama untuk this ), yang membuat file XML tetap dikecualikan. - person Mike Asdf; 03.06.2016
comment
Sedang mencari Satu Jam... Menambahkan ini ke profil terbitkan berhasil untuk saya! Terima kasih - person jmenzel; 28.10.2016