Skip to content

Dapplo.Addons makes it possible to extend your applications with addons in a simple way.

License

Notifications You must be signed in to change notification settings

dapplo/Dapplo.Addons

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dapplo.Addons

Work in progress

  • Documentation will be made availabe here when the automated build is ready.
  • Current build status: Build status
  • Coverage Status: Coverage Status
  • NuGet package: NuGet package

Goals of this project:

  • Simplify the startup of an .NET Framework application, this is done by a bootstapper which is configured via a builder.
  • Make the application extendable, it takes away the complexity of finding and loading assemblies for you.
  • Support dependency injection (IoC) for the extensions, this allows for composition, for this Autofac is used.
  • Make it possible to have "services" started in a defined order, taking care of prerequisites.
  • Have some standard application services, like error handling and prevent multiple instances running at the same time via a mutex.

To get an idea of how this can be used, here is a subset of the code how Greenshot starts:

// Configure your application
var applicationConfig = ApplicationConfigBuilder
    .Create()
	// Used for logging, configuration, and thread names
	.WithApplicationName("Greenshot")
	// Used to prevent multiple instances
	.WithMutex("<your GUID>")
	// Enable Dapplo.Ini & Dapplo.Language support, these packages need to be added via nuget.
	.WithConfigSupport()
	// Enable support for IniSection resolving, no need to register them manually
	.WithIniSectionResolving()
	// Enable support for ILanguage resolving, no need to register them manually
	.WithLanguageResolving()
	// Add directories to scan for dlls
	.WithScanDirectories("... directory ...")
	// Scan for all the assemblies, in the exe directory or specified scan directories, called Greenshot.Addon.*.dll
	.WithAssemblyPatterns("Greenshot.Addon.*")
	.BuildApplicationConfig();

// Bootstrap it
using (var bootstrapper = new ApplicationBootstrapper(applicationConfig))
{
	if (bootstrapper.IsAlreadyRunning) {
		// Exit as we are already running
	}
	// this starts all services you registered (implement IStartup or IStartupAsync, and registered as IService in the AddonModule)
	await bootstrapper.StartupAsync();
	
	// you can use the configured Autofac container, if needed:
	bootstrapper.Container.Resolve...
	
	// Wait, if needed
}
// Shutdown of your services is automatically called when dispose is called

Every addon needs to have at least one class extending AddonModule, which is practically the same as an Autofac Module.

Example Service:

[Service(nameof(SomeAddonService), nameof(DependsOn))]
public class SomeAddonService : IStartupAsync, IShutdownAsync
{
	public async Task ShutdownAsync(CancellationToken cancellationToken = default)
	{
		// Shutdown code
		await Task.Delay(100, cancellationToken);
	}

	public async Task StartupAsync(CancellationToken cancellationToken = default)
	{
		// Startup code
		await Task.Delay(100, cancellationToken);
	}
}

Example AddonModule, which is an extension of Autofac.Module:

public class ExampleAddonModule : AddonModule
{
	protected override void Load(ContainerBuilder builder)
	{
		builder
			.RegisterType<SomeAddonService>()
			.As<IService>()
			.SingleInstance();
	}
}

Also look here for an example Test-Case on how to use this.

Every addon should use Dapplo.Addons as a reference, only the application container should use Dapplo.Addons.Bootstrapper It is heavily based upon Autofac, and can use the Dapplo.Config framework for inserting translations & configurations in your classes. The Dapplo.CaliburnMicro project extends this functionality, to have a MVVM application with Composition.

Disclaimer: This project was mainly created for Greenshot, to remove the complexity from there and contain it in a separate project. It was written by one person, and still very new, documentation is horrible and the API is not clean yet. But I use it in a couple of other projects, this saves me a lot of time and issues!

About

Dapplo.Addons makes it possible to extend your applications with addons in a simple way.

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published

Languages