going raw documentation

Author: isc30

docs/Going-Raw.md

@@ -1 +1,7 @@
-To be written. This section will be about `IAssemblyDataLocator`, `IAssemblyLoader`, etc
+In this section, we will cover each of the tools in the package separately so you can customize everything.
+
+# Manually Loading DLLs
+It is possible to trigger DLL loads manually by injecting `IAssemblyLoader` and calling `LoadAssemblyByNameAsync`. This will automatically solve all the concurrency problems for you and fetch the DLLs if required using `IAssemblyDataProvider` internally.
+
+# Manually Handling Assembly Downloads
+In order to change how the DLL data gets retrieved, you can override the implementation of `IAssemblyDataProvider`. This will give you full control on how to fetch for assemblies. It uses `IAssemblyDataLocator` underneath in case you just want to customize the paths from where the assemblies get downloaded.

src/nuget/BlazorLazyLoading.Server/StartupExtensions.cs

@@ -34,7 +34,7 @@ public static IServiceCollection AddLazyLoading(
                 services.AddSingleton<IAssemblyLoadContext, DisposableAssemblyLoadContext>();
             }
 
-            services.AddSingleton<IAssemblyDataProvider, AssemblyDataProvider>();
+            services.AddSingleton(typeof(IAssemblyDataProvider), options.AssemblyDataProvider ?? typeof(AssemblyDataProvider));
             services.AddSingleton(typeof(IAssemblyDataLocator), options.AssemblyDataLocator ?? typeof(AssemblyDataLocator));
 
             services.AddSingleton<IContentFileReader>(
@@ -96,6 +96,11 @@ public sealed class LazyLoadingOptions
         /// </summary>
         public bool UseAssemblyIsolation { get; set; } = true;
 
+        /// <summary>
+        /// Configures a custom IAssemblyDataProvider. The type must implement BlazorLazyLoading.Abstractions.IAssemblyDataProvider
+        /// </summary>
+        public Type? AssemblyDataProvider { get; set; } = null;
+
         /// <summary>
         /// Configures a custom IAssemblyDataLocator. The type must implement BlazorLazyLoading.Abstractions.IAssemblyDataLocator
         /// </summary>

src/nuget/BlazorLazyLoading.Wasm/StartupExtensions.cs

@@ -22,8 +22,8 @@ public static IServiceCollection AddLazyLoading(
             services.AddSingleton<IAssemblyLoader>(CreateAssemblyLoader);
             services.AddSingleton<IAssemblyLoadContext, AppDomainAssemblyLoadContext>();
             services.AddSingleton(typeof(IAssemblyDataLocator), options.AssemblyDataLocator ?? typeof(AssemblyDataLocator));
+            services.AddSingleton(typeof(IAssemblyDataProvider), options.AssemblyDataProvider ?? typeof(AssemblyDataProvider));
             services.AddSingleton<IContentFileReader, NetworkContentFileReader>();
-            services.AddSingleton<IAssemblyDataProvider, AssemblyDataProvider>();
 
             services.AddSingleton(typeof(IManifestLocator), options.ManifestLocator ?? typeof(ManifestLocator));
             services.AddSingleton<IManifestRepository, ManifestRepository>();
@@ -53,6 +53,11 @@ public sealed class LazyLoadingOptions
         /// </summary>
         public IEnumerable<string> ModuleHints { get; set; } = Array.Empty<string>();
 
+        /// <summary>
+        /// Configures a custom IAssemblyDataProvider. The type must implement BlazorLazyLoading.Abstractions.IAssemblyDataProvider
+        /// </summary>
+        public Type? AssemblyDataProvider { get; set; } = null;
+
         /// <summary>
         /// Configures a custom IAssemblyDataLocator. The type must implement BlazorLazyLoading.Abstractions.IAssemblyDataLocator
         /// </summary>