NuGetForUnity.PluginAPI.xml 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>NuGetForUnity.PluginAPI</name>
  5. </assembly>
  6. <members>
  7. <member name="T:NugetForUnity.PluginAPI.ExtensionPoints.IFoundInstalledPackageHandler">
  8. <summary>
  9. Implement this interface to add additional handling for each found installed package.
  10. </summary>
  11. </member>
  12. <member name="M:NugetForUnity.PluginAPI.ExtensionPoints.IFoundInstalledPackageHandler.ProcessInstalledPackage(NugetForUnity.PluginAPI.Models.INugetPackage)">
  13. <summary>
  14. This will be called for each found installed package in the project.
  15. </summary>
  16. <param name="installedPackage">The installedPackage created from found nuspec file.</param>
  17. </member>
  18. <member name="T:NugetForUnity.PluginAPI.ExtensionPoints.IPackageButtonsHandler">
  19. <summary>
  20. Implement this interface to add additional buttons for each package in NugetForUnity window.
  21. </summary>
  22. </member>
  23. <member name="M:NugetForUnity.PluginAPI.ExtensionPoints.IPackageButtonsHandler.DrawButtons(NugetForUnity.PluginAPI.Models.INugetPackage,NugetForUnity.PluginAPI.Models.INugetPackage,System.Boolean)">
  24. <summary>
  25. This method will be called for each package that is rendered in NugetForUnity window.
  26. </summary>
  27. <param name="package">Package being renderer, either online package or installed package.</param>
  28. <param name="installedPackage">If package is installed this represents the installed version, otherwise it is null.</param>
  29. <param name="existsInUnity">True if package installation should be disabled because it is already included in Unity.</param>
  30. </member>
  31. <member name="T:NugetForUnity.PluginAPI.ExtensionPoints.IPackageInstallFileHandler">
  32. <summary>
  33. Implement this interface to add additional handling of files being extracted from nupkg during installation.
  34. </summary>
  35. </member>
  36. <member name="M:NugetForUnity.PluginAPI.ExtensionPoints.IPackageInstallFileHandler.GetPackageFolderName(NugetForUnity.PluginAPI.Models.INugetPackageIdentifier,System.String)">
  37. <summary>
  38. This will be called when name of the folder where package will be installed should be determined.
  39. </summary>
  40. <param name="package">The package whose folder name is being determined.</param>
  41. <param name="startName">The starting default name that can be modified or replaced.</param>
  42. <returns>New package folder name.</returns>
  43. </member>
  44. <member name="M:NugetForUnity.PluginAPI.ExtensionPoints.IPackageInstallFileHandler.HandleFileExtraction(NugetForUnity.PluginAPI.Models.INugetPackage,System.IO.Compression.ZipArchiveEntry,System.String)">
  45. <summary>
  46. This will be called for each entry that is about to be processed from nupkg that is being installed.
  47. </summary>
  48. <param name="package">Package that is being installed.</param>
  49. <param name="entry">Zip entry that is about to be processed.</param>
  50. <param name="extractDirectory">The directory where the package is being installed.</param>
  51. <returns>True if this method handled the entry and doesn't want default handling to be executed, false otherwise.</returns>
  52. </member>
  53. <member name="T:NugetForUnity.PluginAPI.ExtensionPoints.IPackageUninstallHandler">
  54. <summary>
  55. Implement this interface to add additional handling when nupkg is being uninstalled.
  56. </summary>
  57. </member>
  58. <member name="M:NugetForUnity.PluginAPI.ExtensionPoints.IPackageUninstallHandler.HandleUninstall(NugetForUnity.PluginAPI.Models.INugetPackage,NugetForUnity.PluginAPI.PackageUninstallReason)">
  59. <summary>
  60. This method will be called for each package being uninstalled. Note that uninstall is also done for old version
  61. when package is being updated.
  62. </summary>
  63. <param name="package">The package being uninstalled.</param>
  64. <param name="uninstallReason">The reason uninstall is being called.</param>
  65. </member>
  66. <member name="M:NugetForUnity.PluginAPI.ExtensionPoints.IPackageUninstallHandler.HandleUninstalledAll">
  67. <summary>
  68. This method will be called when all packages have been uninstalled using uninstall all method.
  69. </summary>
  70. </member>
  71. <member name="T:NugetForUnity.PluginAPI.INugetPlugin">
  72. <summary>
  73. In order to register your plugin you need to implement this interface and then call
  74. methods on the provided registry object in order to provide additional functionalities
  75. for certain features.
  76. </summary>
  77. </member>
  78. <member name="M:NugetForUnity.PluginAPI.INugetPlugin.Register(NugetForUnity.PluginAPI.INugetPluginRegistry)">
  79. <summary>
  80. NugetForUnity will call this method automatically so you can tell it what custom
  81. functionalities your plugin is providing.
  82. </summary>
  83. <param name="registry">The registry where extension points can be registered to.</param>
  84. </member>
  85. <member name="T:NugetForUnity.PluginAPI.INugetPluginRegistry">
  86. <summary>
  87. NugetForUnity will pass an instance of this interface to INugetPlugin.Register method that plugins can use
  88. to register additional functionalities.
  89. </summary>
  90. </member>
  91. <member name="P:NugetForUnity.PluginAPI.INugetPluginRegistry.IsRunningInUnity">
  92. <summary>
  93. Gets a value indicating whether we are currently running in Unity or from CLI.
  94. </summary>
  95. </member>
  96. <member name="P:NugetForUnity.PluginAPI.INugetPluginRegistry.PluginService">
  97. <summary>
  98. Gets the methods that NugetForUnity provides to the plugin, like logging methods.
  99. </summary>
  100. </member>
  101. <member name="M:NugetForUnity.PluginAPI.INugetPluginRegistry.RegisterPackageButtonDrawer(NugetForUnity.PluginAPI.ExtensionPoints.IPackageButtonsHandler)">
  102. <summary>
  103. Register a class that will be used to draw additional buttons for each package in NugetForUnity editor window.
  104. </summary>
  105. <param name="packageButtonsHandler">The package buttons handler to register.</param>
  106. </member>
  107. <member name="M:NugetForUnity.PluginAPI.INugetPluginRegistry.RegisterPackageInstallFileHandler(NugetForUnity.PluginAPI.ExtensionPoints.IPackageInstallFileHandler)">
  108. <summary>
  109. Register a class that will be called for each file that is extracted from the nupkg that is being installed.
  110. </summary>
  111. <param name="packageInstallFileHandler">The file handler to register.</param>
  112. </member>
  113. <member name="M:NugetForUnity.PluginAPI.INugetPluginRegistry.RegisterPackageUninstallHandler(NugetForUnity.PluginAPI.ExtensionPoints.IPackageUninstallHandler)">
  114. <summary>
  115. Register a class that will be called when uninstalling some package.
  116. </summary>
  117. <param name="packageUninstallHandler">The package uninstall handler to register.</param>
  118. </member>
  119. <member name="M:NugetForUnity.PluginAPI.INugetPluginRegistry.RegisterFoundInstalledPackageHandler(NugetForUnity.PluginAPI.ExtensionPoints.IFoundInstalledPackageHandler)">
  120. <summary>
  121. Register a class that will be called when installed package is found.
  122. </summary>
  123. <param name="foundInstalledPackageHandler">The found installed package handler to register.</param>
  124. </member>
  125. <member name="T:NugetForUnity.PluginAPI.Models.INugetPackage">
  126. <summary>
  127. Represents a NuGet package.
  128. </summary>
  129. </member>
  130. <member name="P:NugetForUnity.PluginAPI.Models.INugetPackage.Title">
  131. <summary>
  132. Gets the title (not ID) of the package. This is the "friendly" name that only appears in GUIs and on web-pages.
  133. </summary>
  134. </member>
  135. <member name="P:NugetForUnity.PluginAPI.Models.INugetPackage.ProjectUrl">
  136. <summary>
  137. Gets the URL for the location of the package's source code.
  138. </summary>
  139. </member>
  140. <member name="P:NugetForUnity.PluginAPI.Models.INugetPackage.CurrentFrameworkDependencies">
  141. <summary>
  142. Gets the list of dependencies for the framework that best matches what is available in Unity.
  143. </summary>
  144. <returns>List of dependencies.</returns>
  145. </member>
  146. <member name="T:NugetForUnity.PluginAPI.Models.INugetPackageIdentifier">
  147. <summary>
  148. Interface for a versioned NuGet package.
  149. </summary>
  150. </member>
  151. <member name="P:NugetForUnity.PluginAPI.Models.INugetPackageIdentifier.Id">
  152. <summary>
  153. Gets the Id of the package.
  154. </summary>
  155. </member>
  156. <member name="P:NugetForUnity.PluginAPI.Models.INugetPackageIdentifier.Version">
  157. <summary>
  158. Gets or sets the normalized version number of the NuGet package.
  159. This is the normalized version number without build-metadata e.g. <b>1.0.0+b3a8</b> is normalized to <b>1.0.0</b>.
  160. </summary>
  161. </member>
  162. <member name="M:NugetForUnity.PluginAPI.Models.INugetPackageIdentifier.GetPackageInstallPath(System.String)">
  163. <summary>
  164. Returns the folder path where this package is or will be installed.
  165. </summary>
  166. <param name="prefix">
  167. In case you need to manipulate the folder to a bit different name you can provide
  168. the prefix you want to add to folder name here.
  169. </param>
  170. <returns>
  171. Folder path where this package is or will be installed with an optional prefix to
  172. final path segment.
  173. </returns>
  174. </member>
  175. <member name="T:NugetForUnity.PluginAPI.Models.INugetPluginService">
  176. <summary>
  177. Service methods that NugetForUnity provides to its plugins.
  178. </summary>
  179. </member>
  180. <member name="P:NugetForUnity.PluginAPI.Models.INugetPluginService.ProjectAssetsDir">
  181. <summary>
  182. Gets the absolute path to the projects Assets directory.
  183. </summary>
  184. </member>
  185. <member name="P:NugetForUnity.PluginAPI.Models.INugetPluginService.PackageInstallDir">
  186. <summary>
  187. Gets the absolute path to the directory where packages are installed.
  188. </summary>
  189. </member>
  190. <member name="M:NugetForUnity.PluginAPI.Models.INugetPluginService.RegisterNuspecCustomizer(System.Action{NugetForUnity.PluginAPI.Models.INuspecFile})">
  191. <summary>
  192. Allows plugin to register a function that will modify the contents of default new nuspec file.
  193. </summary>
  194. <param name="customizer">The function that will receive default nuspec file and modify it.</param>
  195. </member>
  196. <member name="M:NugetForUnity.PluginAPI.Models.INugetPluginService.CreateNuspecAndOpenEditor(System.String)">
  197. <summary>
  198. Allows plugin to create a new nuspec file on the given location.
  199. </summary>
  200. <param name="destinationDirectory">Either the absolute path within project to an existing directory or path relative to project's Asset folder.</param>
  201. </member>
  202. <member name="M:NugetForUnity.PluginAPI.Models.INugetPluginService.LogError(System.String)">
  203. <summary>
  204. Logs the given error message.
  205. </summary>
  206. <param name="message">Message to log.</param>
  207. </member>
  208. <member name="M:NugetForUnity.PluginAPI.Models.INugetPluginService.LogErrorFormat(System.String,System.Object[])">
  209. <summary>
  210. Logs a formatted error message.
  211. </summary>
  212. <param name="format">A composite format string.</param>
  213. <param name="args">Format arguments.</param>
  214. </member>
  215. <member name="M:NugetForUnity.PluginAPI.Models.INugetPluginService.LogVerbose(System.String,System.Object[])">
  216. <summary>
  217. Logs a formatted error message only if Verbose logging is enabled.
  218. </summary>
  219. <param name="format">A composite format string.</param>
  220. <param name="args">Format arguments.</param>
  221. </member>
  222. <member name="T:NugetForUnity.PluginAPI.Models.INuspecFile">
  223. <summary>
  224. Represents a .nuspec file used to store metadata for a NuGet package.
  225. </summary>
  226. </member>
  227. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.Id">
  228. <summary>
  229. Gets or sets the Id of the package.
  230. </summary>
  231. </member>
  232. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.RepositoryBranch">
  233. <summary>
  234. Gets or sets the source control branch the package is from.
  235. </summary>
  236. </member>
  237. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.RepositoryCommit">
  238. <summary>
  239. Gets or sets the source control commit the package is from.
  240. </summary>
  241. </member>
  242. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.RepositoryType">
  243. <summary>
  244. Gets or sets the type of source control software that the package's source code resides in.
  245. </summary>
  246. </member>
  247. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.RepositoryUrl">
  248. <summary>
  249. Gets or sets the url for the location of the package's source code.
  250. </summary>
  251. </member>
  252. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.Title">
  253. <summary>
  254. Gets or sets the title of the NuGet package.
  255. </summary>
  256. </member>
  257. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.Owners">
  258. <summary>
  259. Gets or sets the owners of the NuGet package.
  260. </summary>
  261. </member>
  262. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.LicenseUrl">
  263. <summary>
  264. Gets or sets the URL for the location of the license of the NuGet package.
  265. </summary>
  266. </member>
  267. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.ProjectUrl">
  268. <summary>
  269. Gets or sets the URL for the location of the project web-page of the NuGet package.
  270. </summary>
  271. </member>
  272. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.IconUrl">
  273. <summary>
  274. Gets or sets the URL for the location of the icon of the NuGet package.
  275. </summary>
  276. </member>
  277. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.Icon">
  278. <summary>
  279. Gets the path to a icon file. The path is relative to the root folder of the package. This is a alternative to using a URL <see cref="P:NugetForUnity.PluginAPI.Models.INuspecFile.IconUrl" />
  280. .
  281. </summary>
  282. </member>
  283. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.IconFilePath">
  284. <summary>
  285. Gets the full path to a icon file. This is only set if the .nuspec file contains a <see cref="P:NugetForUnity.PluginAPI.Models.INuspecFile.Icon" />. This is a alternative to using a URL
  286. <see cref="P:NugetForUnity.PluginAPI.Models.INuspecFile.IconUrl" />.
  287. </summary>
  288. </member>
  289. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.RequireLicenseAcceptance">
  290. <summary>
  291. Gets or sets a value indicating whether the license of the NuGet package needs to be accepted in order to use it.
  292. </summary>
  293. </member>
  294. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.ReleaseNotes">
  295. <summary>
  296. Gets or sets the release notes of the NuGet package.
  297. </summary>
  298. </member>
  299. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.Copyright">
  300. <summary>
  301. Gets or sets the copyright of the NuGet package.
  302. </summary>
  303. </member>
  304. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.Tags">
  305. <summary>
  306. Gets or sets the tags of the NuGet package.
  307. </summary>
  308. </member>
  309. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.Description">
  310. <summary>
  311. Gets or sets the description of the NuGet package.
  312. </summary>
  313. </member>
  314. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.Summary">
  315. <summary>
  316. Gets or sets the description of the NuGet package.
  317. </summary>
  318. </member>
  319. <member name="P:NugetForUnity.PluginAPI.Models.INuspecFile.Authors">
  320. <summary>
  321. Gets or sets the authors of the NuGet package.
  322. </summary>
  323. </member>
  324. <member name="T:NugetForUnity.PluginAPI.PackageUninstallReason">
  325. <summary>
  326. Tells the uninstall method what kind of request from the user initiated it.
  327. </summary>
  328. </member>
  329. <member name="F:NugetForUnity.PluginAPI.PackageUninstallReason.IndividualUninstall">
  330. <summary>
  331. User has requested individual packages to be uninstalled from the project.
  332. </summary>
  333. </member>
  334. <member name="F:NugetForUnity.PluginAPI.PackageUninstallReason.UninstallAll">
  335. <summary>
  336. User has requested all packages to be uninstalled from the project.
  337. </summary>
  338. </member>
  339. <member name="F:NugetForUnity.PluginAPI.PackageUninstallReason.IndividualUpdate">
  340. <summary>
  341. Use requested individual packages to be updated.
  342. </summary>
  343. </member>
  344. <member name="F:NugetForUnity.PluginAPI.PackageUninstallReason.UpdateAll">
  345. <summary>
  346. Use requested all packages to be updated.
  347. </summary>
  348. </member>
  349. </members>
  350. </doc>