using IPA.Loader.Features;
|
|
using IPA.Utilities;
|
|
using Mono.Cecil;
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.IO;
|
|
using System.Linq;
|
|
using System.Reflection;
|
|
using Version = SemVer.Version;
|
|
#if NET3
|
|
using Net3_Proxy;
|
|
using Path = Net3_Proxy.Path;
|
|
#endif
|
|
|
|
namespace IPA.Loader
|
|
{
|
|
/// <summary>
|
|
/// A class which describes a loaded plugin.
|
|
/// </summary>
|
|
public class PluginMetadata
|
|
{
|
|
/// <summary>
|
|
/// The assembly the plugin was loaded from.
|
|
/// </summary>
|
|
/// <value>the loaded Assembly that contains the plugin main type</value>
|
|
public Assembly Assembly { get; internal set; }
|
|
|
|
/// <summary>
|
|
/// The TypeDefinition for the main type of the plugin.
|
|
/// </summary>
|
|
/// <value>the Cecil definition for the plugin main type</value>
|
|
public TypeDefinition PluginType { get; internal set; }
|
|
|
|
/// <summary>
|
|
/// The human readable name of the plugin.
|
|
/// </summary>
|
|
/// <value>the name of the plugin</value>
|
|
public string Name { get; internal set; }
|
|
|
|
/// <summary>
|
|
/// The BeatMods ID of the plugin, or null if it doesn't have one.
|
|
/// </summary>
|
|
/// <value>the updater ID of the plugin</value>
|
|
public string Id { get; internal set; }
|
|
|
|
/// <summary>
|
|
/// The name of the author that wrote this plugin.
|
|
/// </summary>
|
|
/// <value>the name of the plugin's author</value>
|
|
public string Author { get; private set; }
|
|
|
|
/// <summary>
|
|
/// The description of this plugin.
|
|
/// </summary>
|
|
/// <value>the description of the plugin</value>
|
|
public string Description { get; private set; }
|
|
|
|
/// <summary>
|
|
/// The version of the plugin.
|
|
/// </summary>
|
|
/// <value>the version of the plugin</value>
|
|
public Version Version { get; internal set; }
|
|
|
|
/// <summary>
|
|
/// The file the plugin was loaded from.
|
|
/// </summary>
|
|
/// <value>the file the plugin was loaded from</value>
|
|
public FileInfo File { get; internal set; }
|
|
|
|
// ReSharper disable once UnusedAutoPropertyAccessor.Global
|
|
/// <summary>
|
|
/// The features this plugin requests.
|
|
/// </summary>
|
|
/// <value>the list of features requested by the plugin</value>
|
|
public IReadOnlyList<Feature> Features => InternalFeatures;
|
|
|
|
internal readonly List<Feature> InternalFeatures = new List<Feature>();
|
|
|
|
/// <summary>
|
|
/// A list of files (that aren't <see cref="File"/>) that are associated with this plugin.
|
|
/// </summary>
|
|
/// <value>a list of associated files</value>
|
|
public IReadOnlyList<FileInfo> AssociatedFiles { get; private set; } = new List<FileInfo>();
|
|
|
|
/// <summary>
|
|
/// The name of the resource in the plugin assembly containing the plugin's icon.
|
|
/// </summary>
|
|
/// <value>the name of the plugin's icon</value>
|
|
public string IconName { get; private set; }
|
|
|
|
/// <summary>
|
|
/// A link to this plugin's home page, if any.
|
|
/// </summary>
|
|
/// <value>the <see cref="Uri"/> of the plugin's home page</value>
|
|
public Uri PluginHomeLink { get; private set; }
|
|
|
|
/// <summary>
|
|
/// A link to this plugin's source code, if avaliable.
|
|
/// </summary>
|
|
/// <value>the <see cref="Uri"/> of the plugin's source code</value>
|
|
public Uri PluginSourceLink { get; private set; }
|
|
/// <summary>
|
|
/// A link to a donate page for the author of this plugin, if avaliable.
|
|
/// </summary>
|
|
/// <value>the <see cref="Uri"/> of the author's donate page</value>
|
|
public Uri DonateLink { get; private set; }
|
|
|
|
internal bool IsSelf;
|
|
|
|
/// <summary>
|
|
/// Whether or not this metadata object represents a bare manifest.
|
|
/// </summary>
|
|
/// <value><see langword="true"/> if it is bare, <see langword="false"/> otherwise</value>
|
|
public bool IsBare { get; internal set; }
|
|
|
|
private PluginManifest manifest;
|
|
|
|
internal HashSet<PluginMetadata> Dependencies { get; } = new HashSet<PluginMetadata>();
|
|
|
|
internal PluginManifest Manifest
|
|
{
|
|
get => manifest;
|
|
set
|
|
{
|
|
manifest = value;
|
|
Name = value.Name;
|
|
Version = value.Version;
|
|
Id = value.Id;
|
|
Description = value.Description;
|
|
Author = value.Author;
|
|
IconName = value.IconPath;
|
|
PluginHomeLink = value.Links.ProjectHome;
|
|
PluginSourceLink = value.Links.ProjectSource;
|
|
DonateLink = value.Links.Donate;
|
|
AssociatedFiles = value.Files
|
|
.Select(f => Path.Combine(UnityGame.InstallPath, f))
|
|
.Select(p => new FileInfo(p)).ToList();
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// The <see cref="IPA.RuntimeOptions"/> that the plugin specified in its <see cref="PluginAttribute"/>.
|
|
/// </summary>
|
|
public RuntimeOptions RuntimeOptions { get; internal set; }
|
|
|
|
/// <summary>
|
|
/// Gets all of the metadata as a readable string.
|
|
/// </summary>
|
|
/// <returns>the readable printable metadata string</returns>
|
|
public override string ToString() => $"{Name}({Id}@{Version})({PluginType?.FullName}) from '{Utils.GetRelativePath(File?.FullName, UnityGame.InstallPath)}'";
|
|
}
|
|
}
|