|
@@ -0,0 +1,119 @@
|
|
|
+using System;
|
|
|
+using System.Collections.Concurrent;
|
|
|
+using System.Collections.Generic;
|
|
|
+using System.Threading;
|
|
|
+using System.Threading.Tasks;
|
|
|
+using MediaBrowser.Common.Events;
|
|
|
+using MediaBrowser.Common.Plugins;
|
|
|
+using MediaBrowser.Model.Updates;
|
|
|
+
|
|
|
+namespace MediaBrowser.Common.Updates
|
|
|
+{
|
|
|
+ public interface IInstallationManager
|
|
|
+ {
|
|
|
+ /// <summary>
|
|
|
+ /// The current installations
|
|
|
+ /// </summary>
|
|
|
+ List<Tuple<InstallationInfo, CancellationTokenSource>> CurrentInstallations { get; set; }
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// The completed installations
|
|
|
+ /// </summary>
|
|
|
+ ConcurrentBag<InstallationInfo> CompletedInstallations { get; set; }
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Occurs when [plugin uninstalled].
|
|
|
+ /// </summary>
|
|
|
+ event EventHandler<GenericEventArgs<IPlugin>> PluginUninstalled;
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Occurs when [plugin updated].
|
|
|
+ /// </summary>
|
|
|
+ event EventHandler<GenericEventArgs<Tuple<IPlugin, PackageVersionInfo>>> PluginUpdated;
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Called when [plugin updated].
|
|
|
+ /// </summary>
|
|
|
+ /// <param name="plugin">The plugin.</param>
|
|
|
+ /// <param name="newVersion">The new version.</param>
|
|
|
+ void OnPluginUpdated(IPlugin plugin, PackageVersionInfo newVersion);
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Occurs when [plugin updated].
|
|
|
+ /// </summary>
|
|
|
+ event EventHandler<GenericEventArgs<PackageVersionInfo>> PluginInstalled;
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Called when [plugin installed].
|
|
|
+ /// </summary>
|
|
|
+ /// <param name="package">The package.</param>
|
|
|
+ void OnPluginInstalled(PackageVersionInfo package);
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Gets all available packages.
|
|
|
+ /// </summary>
|
|
|
+ /// <param name="cancellationToken">The cancellation token.</param>
|
|
|
+ /// <param name="packageType">Type of the package.</param>
|
|
|
+ /// <param name="applicationVersion">The application version.</param>
|
|
|
+ /// <returns>Task{List{PackageInfo}}.</returns>
|
|
|
+ Task<IEnumerable<PackageInfo>> GetAvailablePackages(CancellationToken cancellationToken,
|
|
|
+ PackageType? packageType = null,
|
|
|
+ Version applicationVersion = null);
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Gets the package.
|
|
|
+ /// </summary>
|
|
|
+ /// <param name="name">The name.</param>
|
|
|
+ /// <param name="classification">The classification.</param>
|
|
|
+ /// <param name="version">The version.</param>
|
|
|
+ /// <returns>Task{PackageVersionInfo}.</returns>
|
|
|
+ Task<PackageVersionInfo> GetPackage(string name, PackageVersionClass classification, Version version);
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Gets the latest compatible version.
|
|
|
+ /// </summary>
|
|
|
+ /// <param name="name">The name.</param>
|
|
|
+ /// <param name="classification">The classification.</param>
|
|
|
+ /// <returns>Task{PackageVersionInfo}.</returns>
|
|
|
+ Task<PackageVersionInfo> GetLatestCompatibleVersion(string name, PackageVersionClass classification = PackageVersionClass.Release);
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Gets the latest compatible version.
|
|
|
+ /// </summary>
|
|
|
+ /// <param name="availablePackages">The available packages.</param>
|
|
|
+ /// <param name="name">The name.</param>
|
|
|
+ /// <param name="classification">The classification.</param>
|
|
|
+ /// <returns>PackageVersionInfo.</returns>
|
|
|
+ PackageVersionInfo GetLatestCompatibleVersion(IEnumerable<PackageInfo> availablePackages, string name, PackageVersionClass classification = PackageVersionClass.Release);
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Gets the available plugin updates.
|
|
|
+ /// </summary>
|
|
|
+ /// <param name="withAutoUpdateEnabled">if set to <c>true</c> [with auto update enabled].</param>
|
|
|
+ /// <param name="cancellationToken">The cancellation token.</param>
|
|
|
+ /// <returns>Task{IEnumerable{PackageVersionInfo}}.</returns>
|
|
|
+ Task<IEnumerable<PackageVersionInfo>> GetAvailablePluginUpdates(bool withAutoUpdateEnabled, CancellationToken cancellationToken);
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Installs the package.
|
|
|
+ /// </summary>
|
|
|
+ /// <param name="package">The package.</param>
|
|
|
+ /// <param name="progress">The progress.</param>
|
|
|
+ /// <param name="cancellationToken">The cancellation token.</param>
|
|
|
+ /// <returns>Task.</returns>
|
|
|
+ /// <exception cref="System.ArgumentNullException">package</exception>
|
|
|
+ Task InstallPackage(PackageVersionInfo package, IProgress<double> progress, CancellationToken cancellationToken);
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Uninstalls a plugin
|
|
|
+ /// </summary>
|
|
|
+ /// <param name="plugin">The plugin.</param>
|
|
|
+ /// <exception cref="System.ArgumentException"></exception>
|
|
|
+ void UninstallPlugin(IPlugin plugin);
|
|
|
+
|
|
|
+ /// <summary>
|
|
|
+ /// Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
|
|
|
+ /// </summary>
|
|
|
+ void Dispose();
|
|
|
+ }
|
|
|
+}
|