Max Katz
3 years ago
23 changed files with 285 additions and 333 deletions
@ -1,244 +0,0 @@ |
|||
using System; |
|||
using System.Diagnostics.CodeAnalysis; |
|||
using System.Reflection; |
|||
using System.Linq; |
|||
using Avalonia.Controls.ApplicationLifetimes; |
|||
using Avalonia.Platform; |
|||
|
|||
namespace Avalonia.Controls |
|||
{ |
|||
/// <summary>
|
|||
/// Base class for initializing platform-specific services for an <see cref="Application"/>.
|
|||
/// </summary>
|
|||
/// <typeparam name="TAppBuilder">The type of the AppBuilder class itself.</typeparam>
|
|||
public abstract class AppBuilderBase<TAppBuilder> where TAppBuilder : AppBuilderBase<TAppBuilder>, new() |
|||
{ |
|||
private static bool s_setupWasAlreadyCalled; |
|||
private Action? _optionsInitializers; |
|||
private Func<Application>? _appFactory; |
|||
private IApplicationLifetime? _lifetime; |
|||
|
|||
/// <summary>
|
|||
/// Gets or sets the <see cref="IRuntimePlatform"/> instance.
|
|||
/// </summary>
|
|||
public IRuntimePlatform RuntimePlatform { get; set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets or sets a method to call the initialize the runtime platform services (e. g. AssetLoader)
|
|||
/// </summary>
|
|||
public Action RuntimePlatformServicesInitializer { get; private set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the <see cref="Application"/> instance being initialized.
|
|||
/// </summary>
|
|||
public Application? Instance { get; private set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the type of the Instance (even if it's not created yet)
|
|||
/// </summary>
|
|||
public Type? ApplicationType { get; private set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets or sets a method to call the initialize the windowing subsystem.
|
|||
/// </summary>
|
|||
public Action? WindowingSubsystemInitializer { get; private set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the name of the currently selected windowing subsystem.
|
|||
/// </summary>
|
|||
public string? WindowingSubsystemName { get; private set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets or sets a method to call the initialize the windowing subsystem.
|
|||
/// </summary>
|
|||
public Action? RenderingSubsystemInitializer { get; private set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the name of the currently selected rendering subsystem.
|
|||
/// </summary>
|
|||
public string? RenderingSubsystemName { get; private set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets or sets a method to call after the <see cref="Application"/> is setup.
|
|||
/// </summary>
|
|||
public Action<TAppBuilder> AfterSetupCallback { get; private set; } = builder => { }; |
|||
|
|||
|
|||
public Action<TAppBuilder> AfterPlatformServicesSetupCallback { get; private set; } = builder => { }; |
|||
|
|||
protected AppBuilderBase(IRuntimePlatform platform, Action<TAppBuilder> platformServices) |
|||
{ |
|||
RuntimePlatform = platform; |
|||
RuntimePlatformServicesInitializer = () => platformServices((TAppBuilder)this); |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Begin configuring an <see cref="Application"/>.
|
|||
/// </summary>
|
|||
/// <typeparam name="TApp">The subclass of <see cref="Application"/> to configure.</typeparam>
|
|||
/// <returns>An <typeparamref name="TAppBuilder"/> instance.</returns>
|
|||
public static TAppBuilder Configure<TApp>() |
|||
where TApp : Application, new() |
|||
{ |
|||
return new TAppBuilder() |
|||
{ |
|||
ApplicationType = typeof(TApp), |
|||
// Needed for CoreRT compatibility
|
|||
_appFactory = () => new TApp() |
|||
}; |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Begin configuring an <see cref="Application"/>.
|
|||
/// </summary>
|
|||
/// <param name="appFactory">Factory function for <typeparamref name="TApp"/>.</param>
|
|||
/// <typeparam name="TApp">The subclass of <see cref="Application"/> to configure.</typeparam>
|
|||
/// <remarks><paramref name="appFactory"/> is useful for passing of dependencies to <typeparamref name="TApp"/>.</remarks>
|
|||
/// <returns>An <typeparamref name="TAppBuilder"/> instance.</returns>
|
|||
public static TAppBuilder Configure<TApp>(Func<TApp> appFactory) |
|||
where TApp : Application |
|||
{ |
|||
return new TAppBuilder() |
|||
{ |
|||
ApplicationType = typeof(TApp), |
|||
_appFactory = appFactory |
|||
}; |
|||
} |
|||
|
|||
protected TAppBuilder Self => (TAppBuilder)this; |
|||
|
|||
public TAppBuilder AfterSetup(Action<TAppBuilder> callback) |
|||
{ |
|||
AfterSetupCallback = (Action<TAppBuilder>)Delegate.Combine(AfterSetupCallback, callback); |
|||
return Self; |
|||
} |
|||
|
|||
|
|||
public TAppBuilder AfterPlatformServicesSetup(Action<TAppBuilder> callback) |
|||
{ |
|||
AfterPlatformServicesSetupCallback = (Action<TAppBuilder>)Delegate.Combine(AfterPlatformServicesSetupCallback, callback); |
|||
return Self; |
|||
} |
|||
|
|||
public delegate void AppMainDelegate(Application app, string[] args); |
|||
|
|||
public void Start(AppMainDelegate main, string[] args) |
|||
{ |
|||
Setup(); |
|||
main(Instance!, args); |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Sets up the platform-specific services for the application, but does not run it.
|
|||
/// </summary>
|
|||
/// <returns></returns>
|
|||
public TAppBuilder SetupWithoutStarting() |
|||
{ |
|||
Setup(); |
|||
return Self; |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Sets up the platform-specific services for the application and initialized it with a particular lifetime, but does not run it.
|
|||
/// </summary>
|
|||
/// <param name="lifetime"></param>
|
|||
/// <returns></returns>
|
|||
public TAppBuilder SetupWithLifetime(IApplicationLifetime lifetime) |
|||
{ |
|||
_lifetime = lifetime; |
|||
Setup(); |
|||
return Self; |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Specifies a windowing subsystem to use.
|
|||
/// </summary>
|
|||
/// <param name="initializer">The method to call to initialize the windowing subsystem.</param>
|
|||
/// <param name="name">The name of the windowing subsystem.</param>
|
|||
/// <returns>An <typeparamref name="TAppBuilder"/> instance.</returns>
|
|||
public TAppBuilder UseWindowingSubsystem(Action initializer, string name = "") |
|||
{ |
|||
WindowingSubsystemInitializer = initializer; |
|||
WindowingSubsystemName = name; |
|||
return Self; |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Specifies a rendering subsystem to use.
|
|||
/// </summary>
|
|||
/// <param name="initializer">The method to call to initialize the rendering subsystem.</param>
|
|||
/// <param name="name">The name of the rendering subsystem.</param>
|
|||
/// <returns>An <typeparamref name="TAppBuilder"/> instance.</returns>
|
|||
public TAppBuilder UseRenderingSubsystem(Action initializer, string name = "") |
|||
{ |
|||
RenderingSubsystemInitializer = initializer; |
|||
RenderingSubsystemName = name; |
|||
return Self; |
|||
} |
|||
|
|||
protected virtual bool CheckSetup => true; |
|||
|
|||
/// <summary>
|
|||
/// Configures platform-specific options
|
|||
/// </summary>
|
|||
public TAppBuilder With<T>(T options) |
|||
{ |
|||
_optionsInitializers += () => { AvaloniaLocator.CurrentMutable.Bind<T>().ToConstant(options); }; |
|||
return Self; |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Configures platform-specific options
|
|||
/// </summary>
|
|||
public TAppBuilder With<T>(Func<T> options) |
|||
{ |
|||
_optionsInitializers += () => { AvaloniaLocator.CurrentMutable.Bind<T>().ToFunc(options); }; |
|||
return Self; |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Sets up the platform-specific services for the <see cref="Application"/>.
|
|||
/// </summary>
|
|||
private void Setup() |
|||
{ |
|||
if (RuntimePlatformServicesInitializer == null) |
|||
{ |
|||
throw new InvalidOperationException("No runtime platform services configured."); |
|||
} |
|||
|
|||
if (WindowingSubsystemInitializer == null) |
|||
{ |
|||
throw new InvalidOperationException("No windowing system configured."); |
|||
} |
|||
|
|||
if (RenderingSubsystemInitializer == null) |
|||
{ |
|||
throw new InvalidOperationException("No rendering system configured."); |
|||
} |
|||
|
|||
if (_appFactory == null) |
|||
{ |
|||
throw new InvalidOperationException("No Application factory configured."); |
|||
} |
|||
|
|||
if (s_setupWasAlreadyCalled && CheckSetup) |
|||
{ |
|||
throw new InvalidOperationException("Setup was already called on one of AppBuilder instances"); |
|||
} |
|||
|
|||
s_setupWasAlreadyCalled = true; |
|||
_optionsInitializers?.Invoke(); |
|||
RuntimePlatformServicesInitializer(); |
|||
RenderingSubsystemInitializer(); |
|||
WindowingSubsystemInitializer(); |
|||
AfterPlatformServicesSetupCallback(Self); |
|||
Instance = _appFactory(); |
|||
Instance.ApplicationLifetime = _lifetime; |
|||
AvaloniaLocator.CurrentMutable.BindToSelf(Instance); |
|||
Instance.RegisterServices(); |
|||
Instance.Initialize(); |
|||
AfterSetupCallback(Self); |
|||
Instance.OnFrameworkInitializationCompleted(); |
|||
} |
|||
} |
|||
} |
|||
Loading…
Reference in new issue