I'm working on a C# DLL plugin for Unity3D. Actually, the MonoDevelop tooltips (or Visual Studio) show only the structure of my method:
But it doesn't show my summary like this:
Even if I documented my code:
Is there a way to include my documentation in DLL?
1 : Create XML documentation file on build in VisualStudio
2 : Import this XML in your Assets/Plugins folder in Unity3d
Plugins link their code to C# unity using [DllImport()] . __internal is a keyword used for static linking needed by specific platforms, such as XBox and iOS. Other platforms usually use dynamic linking, hence this is not needed.
DLLs are another way to get code into your Unity project. I'm talking about C# code that has been compiled and packaged as a . NET assembly. The simplest way of working is to store source code directly in your Unity project. However, using DLLs gives you an alternative that has its own benefits.
You need to include the XML documentation file. In order to create that, you need to right-click on the Project. Under the "Build" side tab, in the "Output" section at the bottom, check the "XML documentation file" and leave the path that it creates.
When you bring your DLL over, bring that .XML file along with it, and that will put the documentation into Intellisense. I'm not sure if you'll be able to use it Unity itself, but that is how you get the summary in Visual Studio. Per probitaille's comment, you can add the XML file into the "Plugins" folder in Unity to add your comments/summaries into Unity itself.
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