Expose _framework/hybridwebview.js

Now that the _framework/hybridwebview.js file is embedded, we can
make it available for consumption by the app. It is not required
to use this URL, but it is now available.

This being embedded makes things easier to update and keep in sync
with the implementation of the HybridWebView.

Author: mattleibow

src/Controls/samples/Controls.Sample/Maui.Controls.Sample.csproj

@@ -77,7 +77,6 @@
   <ItemGroup>
     <EmbeddedResource Include="Resources\Embedded\*" />
     <MauiAsset Include="Resources\Raw\**" LogicalName="%(RecursiveDir)%(Filename)%(Extension)" />
-    <MauiAsset Include="..\..\..\Core\src\Handlers\HybridWebView\HybridWebView.js" LogicalName="HybridSamplePage\scripts\HybridWebView.js" />
     <MauiImage Include="Resources\Images\*" />
     <MauiImage Update="Resources\Images\*.gif" Resize="false" />
     <MauiIcon Include="Resources\AppIcons\appicon.svg" ForegroundFile="Resources\AppIcons\appicon_foreground.svg" />

src/Controls/samples/Controls.Sample/Resources/Raw/HybridSamplePage/index.html

@@ -6,7 +6,7 @@
     <title></title>
     <link rel="icon" href="data:,">
     <link rel="stylesheet" href="styles/app.css">
-    <script src="scripts/HybridWebView.js"></script>
+    <script src="_framework/hybridwebview.js"></script>
     <script>
         function LogMessage(msg) {
             var messageLog = document.getElementById("messageLog");

src/Controls/tests/DeviceTests/Controls.DeviceTests.csproj

@@ -34,7 +34,6 @@
     <!-- Raw Assets for HybridWebView tests (removes the "Resources\Raw" prefix, to mimic what project templates do) -->
     <None Remove="Resources\Raw\**" />
     <MauiAsset Include="Resources\Raw\**" LogicalName="%(RecursiveDir)%(Filename)%(Extension)" />
-    <MauiAsset Include="..\..\..\Core\src\Handlers\HybridWebView\HybridWebView.js" LogicalName="HybridTestRoot\scripts\HybridWebView.js" />
   </ItemGroup>
 
   <PropertyGroup>

src/Controls/tests/DeviceTests/Resources/Raw/HybridTestRoot/index.html

@@ -5,7 +5,7 @@
     <meta charset="utf-8" />
     <title></title>
     <link rel="icon" href="data:,">
-    <script src="scripts/HybridWebView.js"></script>
+    <script src="_framework/hybridwebview.js"></script>
 
     <!-- test helper functions-->
     <script>

src/Controls/tests/DeviceTests/Resources/Raw/HybridTestRoot/invokedotnettests.html

@@ -5,7 +5,7 @@
     <meta charset="utf-8" />
     <title></title>
     <link rel="icon" href="data:,">
-    <script src="scripts/HybridWebView.js"></script>
+    <script src="_framework/hybridwebview.js"></script>
     <script>
         window.addEventListener(
             "HybridWebViewMessageReceived",

src/Core/src/Handlers/HybridWebView/HybridWebViewHandler.Windows.cs

@@ -173,7 +173,19 @@ private async void OnWebResourceRequested(CoreWebView2 sender, CoreWebView2WebRe
 			{
 				var relativePath = AppOriginUri.MakeRelativeUri(uri).ToString().Replace('/', '\\');
 
-				// 1. Try special InvokeDotNet path
+				// 1.a. Try the special "_framework/hybridwebview.js" path
+				if (relativePath == HybridWebViewDotJsPath)
+				{
+					logger?.LogDebug("Request for {Url} will return the hybrid web view script.", url);
+					var jsStream = GetEmbeddedStream(HybridWebViewDotJsPath);
+					if (jsStream is not null)
+					{
+						var ras = await CopyContentToRandomAccessStreamAsync(jsStream);
+						return (Stream: ras, ContentType: "application/javascript", StatusCode: 200, Reason: "OK");
+					}
+				}
+
+				// 1.b. Try special InvokeDotNet path
 				if (relativePath == InvokeDotNetPath)
 				{
 					logger?.LogDebug("Request for {Url} will be handled by the .NET method invoker.", url);

src/Core/src/Handlers/HybridWebView/HybridWebViewHandler.cs

@@ -66,6 +66,7 @@ public partial class HybridWebViewHandler : IHybridWebViewHandler
 		internal static readonly Uri AppOriginUri = new(AppOrigin);
 
 		internal const string InvokeDotNetPath = "__hwvInvokeDotNet";
+		internal const string HybridWebViewDotJsPath = "_framework\\hybridwebview.js";
 
 		public static IPropertyMapper<IHybridWebView, IHybridWebViewHandler> Mapper = new PropertyMapper<IHybridWebView, IHybridWebViewHandler>(ViewHandler.ViewMapper)
 		{
@@ -493,6 +494,22 @@ await handler.InvokeAsync(nameof(IHybridWebView.EvaluateJavaScriptAsync),
 			return await FileSystem.OpenAppPackageFileAsync(assetPath);
 		}
 
+		internal static Stream? GetEmbeddedStream(string embeddedPath)
+		{
+			var assembly = typeof(HybridWebViewHandler).Assembly;
+
+			var resourceName = assembly
+				.GetManifestResourceNames()
+				.FirstOrDefault(name => name.Equals(embeddedPath.Replace('\\', '/'), StringComparison.OrdinalIgnoreCase));
+
+			if (resourceName is null)
+			{
+				return null;
+			}
+
+			return assembly.GetManifestResourceStream(resourceName);
+		}
+
 #if !NETSTANDARD
 		internal static readonly FileExtensionContentTypeProvider ContentTypeProvider = new();
 #endif

src/Core/src/Handlers/HybridWebView/HybridWebViewHandler.iOS.cs

@@ -203,7 +203,7 @@ public async void StartUrlSchemeTask(WKWebView webView, IWKUrlSchemeTask urlSche
 					// 2.c. Return the body
 					if (bytes?.Length > 0)
 					{
-						urlSchemeTask.DidReceiveData(NSData.FromArray(bytes));
+						urlSchemeTask.DidReceiveData(bytes);
 					}
 
 					// 2.d. Finish the task
@@ -217,7 +217,7 @@ public async void StartUrlSchemeTask(WKWebView webView, IWKUrlSchemeTask urlSche
 				logger?.LogDebug("Request for {Url} was not handled.", url);
 			}
 
-			private async Task<(byte[]? ResponseBytes, string? ContentType, int StatusCode)> GetResponseBytesAsync(string url, ILogger? logger)
+			private async Task<(NSData? ResponseBytes, string? ContentType, int StatusCode)> GetResponseBytesAsync(string url, ILogger? logger)
 			{
 				if (Handler is null)
 				{
@@ -233,7 +233,18 @@ public async void StartUrlSchemeTask(WKWebView webView, IWKUrlSchemeTask urlSche
 
 					var bundleRootDir = Path.Combine(NSBundle.MainBundle.ResourcePath, Handler.VirtualView.HybridRoot!);
 
-					// 1. Try special InvokeDotNet path
+					// 1.a. Try the special "_framework/hybridwebview.js" path
+					if (relativePath == HybridWebViewDotJsPath)
+					{
+						logger?.LogDebug("Request for {Url} will return the hybrid web view script.", url);
+						var jsStream = GetEmbeddedStream(HybridWebViewDotJsPath);
+						if (jsStream is not null)
+						{
+							return (NSData.FromStream(jsStream), ContentType: "application/javascript", StatusCode: 200);
+						}
+					}
+
+					// 1.b. Try special InvokeDotNet path
 					if (relativePath == InvokeDotNetPath)
 					{
 						logger?.LogDebug("Request for {Url} will be handled by the .NET method invoker.", url);
@@ -243,7 +254,7 @@ public async void StartUrlSchemeTask(WKWebView webView, IWKUrlSchemeTask urlSche
 						var contentBytes = await Handler.InvokeDotNetAsync(invokeQueryString);
 						if (contentBytes is not null)
 						{
-							return (contentBytes, "application/json", StatusCode: 200);
+							return (NSData.FromArray(contentBytes), "application/json", StatusCode: 200);
 						}
 					}
 
@@ -271,7 +282,7 @@ public async void StartUrlSchemeTask(WKWebView webView, IWKUrlSchemeTask urlSche
 						// 2.a. If something was found, return the content
 						logger?.LogDebug("Request for {Url} will return an app package file.", url);
 
-						return (File.ReadAllBytes(assetPath), contentType, StatusCode: 200);
+						return (NSData.FromFile(assetPath), contentType, StatusCode: 200);
 					}
 				}
 

src/Core/src/Platform/Android/MauiHybridWebViewClient.cs

@@ -101,7 +101,18 @@ public MauiHybridWebViewClient(HybridWebViewHandler handler)
 
 			var relativePath = HybridWebViewHandler.AppOriginUri.MakeRelativeUri(uri).ToString().Replace('/', '\\');
 
-			// 1. Try special InvokeDotNet path
+			// 1.a. Try the special "_framework/hybridwebview.js" path
+			if (relativePath == HybridWebViewHandler.HybridWebViewDotJsPath)
+			{
+				logger?.LogDebug("Request for {Url} will return the hybrid web view script.", fullUrl);
+				var jsStream = HybridWebViewHandler.GetEmbeddedStream(HybridWebViewHandler.HybridWebViewDotJsPath);
+				if (jsStream is not null)
+				{
+					return new WebResourceResponse("application/json", "UTF-8", 200, "OK", GetHeaders("application/json"), jsStream);
+				}
+			}
+
+			// 1.b. Try special InvokeDotNet path
 			if (relativePath == HybridWebViewHandler.InvokeDotNetPath)
 			{
 				logger?.LogDebug("Request for {Url} will be handled by the .NET method invoker.", fullUrl);