EDIT: Updated to specify that the issue only occurs when packaging an Azure cloud service CSPKG file.
I have an ASP.NET Web API 2 application that acts as a web role in an Azure cloud service solution. I'd like to use the Web API Help Pages and leverage the XML generated docs to populate them. I'm having trouble figuring out how to get the XML documentation to be included in the Azure cloud packaging of the Web Api project.
The XML documentation correctly makes its way into the bin directory locally and when being published to a file system location, but it's missing when you inspect the cspkg archive or the deployed web roles approot directory.
Is there a way to force the packaging to include the XML?
Just about every browser can open an XML file. In Chrome, just open a new tab and drag the XML file over. Alternatively, right click on the XML file and hover over "Open with" then click "Chrome". When you do, the file will open in a new tab.
cspkg is a zip file that is generated from the ServiceDefinition. csdef and among other things, contains all the required binary-based dependencies. Azure creates a cloud service from both the ServicePackage. cspkg and the ServiceConfig.
cscfg. The configuration of the settings for your cloud service is determined by the values in the ServiceConfiguration. cscfg file. You specify the number of instances that you want to deploy for each role in this file.
You can set ExcludeXmlAssemblyFiles to false in your Project's PropertyGroup to force all xml files to be included in the Azure package:
<ExcludeXmlAssemblyFiles>false</ExcludeXmlAssemblyFiles>
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With