/// <summary>
/// Creates a new <see cref="LoadContext"/> for individual mods/plugins.
/// </summary>
public static LoadContext BuildModLoadContext(string assemblyPath, bool isUnloadable, Type[] sharedTypes, AssemblyLoadContext defaultContext = null)
{
var builder = new AssemblyLoadContextBuilder()
.SetMainAssemblyPath(assemblyPath)
.IsLazyLoaded(true);
if (defaultContext != null)
{
builder.SetDefaultContext(defaultContext);
}
if (isUnloadable)
{
builder.EnableUnloading();
}
foreach (var type in sharedTypes)
{
builder.PreferDefaultLoadContextAssembly(type.Assembly.GetName());
}
var context = builder.Build();
return(new LoadContext(context, assemblyPath));
}
private static AssemblyLoadContext CreateLoadContext(
string baseDir,
PluginConfig config,
Type[] sharedTypes)
{
var depsJsonFile = Path.Combine(baseDir, config.MainAssembly.Name + ".deps.json");
var builder = new AssemblyLoadContextBuilder();
if (File.Exists(depsJsonFile))
{
builder.AddDependencyContext(depsJsonFile);
}
builder.SetBaseDirectory(baseDir);
foreach (var ext in config.PrivateAssemblies)
{
builder.PreferLoadContextAssembly(ext);
}
if (sharedTypes != null)
{
foreach (var type in sharedTypes)
{
builder.PreferDefaultLoadContextAssembly(type.Assembly.GetName());
}
}
var runtimeConfigFile = Path.Combine(baseDir, config.MainAssembly.Name + ".runtimeconfig.json");
builder.TryAddAdditionalProbingPathFromRuntimeConfig(runtimeConfigFile, includeDevConfig: true, out _);
return(builder.Build());
}
private static AssemblyLoadContext CreateLoadContext(PluginConfig config)
{
var builder = new AssemblyLoadContextBuilder();
builder.SetMainAssemblyPath(config.MainAssemblyPath);
foreach (var ext in config.PrivateAssemblies)
{
builder.PreferLoadContextAssembly(ext);
}
if (config.PreferSharedTypes)
{
builder.PreferDefaultLoadContext(true);
}
if (config.IsUnloadable)
{
builder.EnableUnloading();
}
foreach (var assemblyName in config.SharedAssemblies)
{
builder.PreferDefaultLoadContextAssembly(assemblyName);
}
builder.SetupSharedAssemblyPrefix(config.SharedAssemblyPrefixes);
return(builder.Build());
}
private static AssemblyLoadContextBuilder CreateLoadContextBuilder(PluginConfig config)
{
var builder = new AssemblyLoadContextBuilder();
builder.SetMainAssemblyPath(config.MainAssemblyPath);
foreach (var ext in config.PrivateAssemblies)
{
builder.PreferLoadContextAssembly(ext);
}
if (config.PreferSharedTypes)
{
builder.PreferDefaultLoadContext(true);
}
#if FEATURE_UNLOAD
if (config.IsUnloadable || config.EnableHotReload)
{
builder.EnableUnloading();
}
if (config.EnableHotReload)
{
builder.PreloadAssembliesIntoMemory();
}
#endif
foreach (var assemblyName in config.SharedAssemblies)
{
builder.PreferDefaultLoadContextAssembly(assemblyName);
}
#if !FEATURE_NATIVE_RESOLVER
// In .NET Core 3.0, this code is unnecessary because the API, AssemblyDependencyResolver, handles parsing these files.
var baseDir = Path.GetDirectoryName(config.MainAssemblyPath);
var assemblyFileName = Path.GetFileNameWithoutExtension(config.MainAssemblyPath);
var depsJsonFile = Path.Combine(baseDir, assemblyFileName + ".deps.json");
if (File.Exists(depsJsonFile))
{
builder.AddDependencyContext(depsJsonFile);
}
var pluginRuntimeConfigFile = Path.Combine(baseDir, assemblyFileName + ".runtimeconfig.json");
builder.TryAddAdditionalProbingPathFromRuntimeConfig(pluginRuntimeConfigFile, includeDevConfig: true, out _);
// Always include runtimeconfig.json from the host app.
// in some cases, like `dotnet test`, the entry assembly does not actually match with the
// runtime config file which is why we search for all files matching this extensions.
foreach (var runtimeconfig in Directory.GetFiles(AppContext.BaseDirectory, "*.runtimeconfig.json"))
{
builder.TryAddAdditionalProbingPathFromRuntimeConfig(runtimeconfig, includeDevConfig: true, out _);
}
#endif
return(builder);
}
private static AssemblyLoadContextBuilder CreateLoadContextBuilder(PluginConfig config)
{
var builder = new AssemblyLoadContextBuilder();
builder.SetMainAssemblyPath(config.MainAssemblyPath);
builder.SetDefaultContext(config.DefaultContext);
foreach (var ext in config.PrivateAssemblies)
{
builder.PreferLoadContextAssembly(ext);
}
if (config.PreferSharedTypes)
{
builder.PreferDefaultLoadContext(true);
}
if (config.IsUnloadable || config.EnableHotReload)
{
builder.EnableUnloading();
}
if (config.LoadInMemory)
{
builder.PreloadAssembliesIntoMemory();
builder.ShadowCopyNativeLibraries();
}
builder.IsLazyLoaded(config.IsLazyLoaded);
foreach (var assemblyName in config.SharedAssemblies)
{
builder.PreferDefaultLoadContextAssembly(assemblyName);
}
var baseDir = Path.GetDirectoryName(config.MainAssemblyPath);
var assemblyFileName = Path.GetFileNameWithoutExtension(config.MainAssemblyPath);
if (baseDir == null)
{
throw new InvalidOperationException("Could not determine which directory to watch. "
+ "Please set MainAssemblyPath to an absolute path so its parent directory can be discovered.");
}
var pluginRuntimeConfigFile = Path.Combine(baseDir, assemblyFileName + ".runtimeconfig.json");
builder.TryAddAdditionalProbingPathFromRuntimeConfig(pluginRuntimeConfigFile, includeDevConfig: true, out _);
// Always include runtimeconfig.json from the host app.
// in some cases, like `dotnet test`, the entry assembly does not actually match with the
// runtime config file which is why we search for all files matching this extensions.
foreach (var runtimeconfig in Directory.GetFiles(AppContext.BaseDirectory, "*.runtimeconfig.json"))
{
builder.TryAddAdditionalProbingPathFromRuntimeConfig(runtimeconfig, includeDevConfig: true, out _);
}
return(builder);
}
private static AssemblyLoadContext CreateLoadContext(
string baseDir,
PluginConfig config,
Type[] sharedTypes,
PluginLoaderOptions loaderOptions)
{
var depsJsonFile = Path.Combine(baseDir, config.MainAssembly.Name + ".deps.json");
var builder = new AssemblyLoadContextBuilder();
if (File.Exists(depsJsonFile))
{
builder.AddDependencyContext(depsJsonFile);
}
builder.SetBaseDirectory(baseDir);
foreach (var ext in config.PrivateAssemblies)
{
builder.PreferLoadContextAssembly(ext);
}
if (loaderOptions.HasFlag(PluginLoaderOptions.PreferSharedTypes))
{
builder.PreferDefaultLoadContext(true);
}
#if FEATURE_UNLOAD
if (loaderOptions.HasFlag(PluginLoaderOptions.IsUnloadable))
{
builder.EnableUnloading();
}
#endif
if (sharedTypes != null)
{
foreach (var type in sharedTypes)
{
builder.PreferDefaultLoadContextAssembly(type.Assembly.GetName());
}
}
var pluginRuntimeConfigFile = Path.Combine(baseDir, config.MainAssembly.Name + ".runtimeconfig.json");
builder.TryAddAdditionalProbingPathFromRuntimeConfig(pluginRuntimeConfigFile, includeDevConfig: true, out _);
// Always include runtimeconfig.json from the host app.
// in some cases, like `dotnet test`, the entry assembly does not actually match with the
// runtime config file which is why we search for all files matching this extensions.
foreach (var runtimeconfig in Directory.GetFiles(AppContext.BaseDirectory, "*.runtimeconfig.json"))
{
builder.TryAddAdditionalProbingPathFromRuntimeConfig(runtimeconfig, includeDevConfig: true, out _);
}
return(builder.Build());
}
/// <summary>
/// Based on https://github.com/natemcmaster/DotNetCorePlugins/blob/master/src/Plugins/PluginLoader.cs
/// </summary>
public static AssemblyLoadContext CreateLoadContext(string baseDir,
AssemblyName mainAssemblyName,
PluginLoaderOptions loaderOptions = PluginLoaderOptions.None,
IEnumerable <AssemblyName> preferDefaultLoadContextForAssemblies = null,
IEnumerable <AssemblyName> privateAssemblies = null)
{
var depsJsonFile = Path.Combine(baseDir, mainAssemblyName.Name + ".deps.json");
var builder = new AssemblyLoadContextBuilder();
if (File.Exists(depsJsonFile))
{
builder.AddDependencyContextWithCompileDeps(depsJsonFile);
}
builder.SetBaseDirectory(baseDir);
if (privateAssemblies != null)
{
foreach (var ext in privateAssemblies)
{
builder.PreferLoadContextAssembly(ext);
}
}
if (loaderOptions.HasFlag(PluginLoaderOptions.PreferSharedTypes))
{
builder.PreferDefaultLoadContext(true);
}
if (preferDefaultLoadContextForAssemblies != null)
{
foreach (var assemblyName in preferDefaultLoadContextForAssemblies)
{
builder.PreferDefaultLoadContextAssembly(assemblyName);
}
}
var pluginRuntimeConfigFile = Path.Combine(baseDir, mainAssemblyName.Name + ".runtimeconfig.json");
builder.TryAddAdditionalProbingPathFromRuntimeConfig(pluginRuntimeConfigFile, true, out _);
foreach (var runtimeconfig in Directory.GetFiles(AppContext.BaseDirectory, "*.runtimeconfig.json"))
{
builder.TryAddAdditionalProbingPathFromRuntimeConfig(runtimeconfig, true, out _);
}
return(builder.Build());
}