feat: Add support for file:// URIs in iOS and macOS WebView

[Copilot]

Summary

This PR enables support for file:// URIs with relative paths in iOS and macOS WebView implementations by configuring WKWebView to allow file access from file URLs. This fixes the issue where local HTML files could not load additional resources (CSS, JavaScript, images) using relative paths.

Problem

By default, WKWebView blocks file URLs from accessing other file URLs for security reasons. This prevents legitimate use cases such as:

• Loading a PDF.js viewer with a local PDF file as a parameter
• Bundled web applications with CSS/JS/image assets referenced via relative paths
• HTML documentation viewers with relative resource links
• Any offline web content that needs to reference multiple local files

Solution

Following the approach from .NET MAUI #19486, this PR enables the allowFileAccessFromFileURLs preference on WKWebView configuration during initialization.

Changes Made

1. iOS/macOS Native WebView (UnoWKWebView.iOSmacOS.cs)

   Configuration.Preferences.SetValueForKey(NSObject.FromObject(true), (NSString)"allowFileAccessFromFileURLs");

2. macOS Skia Native WebView (UNOWebView.m)

   [config.preferences setValue:@YES forKey:@"allowFileAccessFromFileURLs"];

3. Runtime Test (Given_WebView.cs)

   • Added When_FileUri_With_Relative_Paths test that verifies file:// URIs can load relative resources
   • Test creates an HTML file that references a CSS file via relative path
   • Validates both the HTML and CSS load successfully, confirming allowFileAccessFromFileURLs works correctly

All changes are applied during WebView initialization, ensuring consistent behavior across iOS and macOS platforms.

Use Cases

This enables scenarios like:

// Load PDF.js viewer with a local PDF
webView.Source = new Uri($"file://{pdfViewerPath}?file=file://{pdfFilePath}");

// Load local HTML with relative CSS/JS
webView.Source = new Uri($"file://{htmlPath}");
// where the HTML contains: <link rel="stylesheet" href="./styles.css">

Testing

• ✅ Runtime test validates file:// URIs with relative paths work on iOS and macOS
• ✅ Test confirms CSS files are loaded via relative links
• ✅ Test verifies the configuration change achieves the intended functionality

Security Considerations

This change follows the same security model as .NET MAUI and only affects file:// URLs. HTTP/HTTPS content security remains unchanged.

References

• Related MAUI issue: .NET MAUI project using the PDF.js library - Issue loading the PDF from iOS resource dotnet/maui#19486 (comment)
• Additional context: Webview on iOS and Android does not allow local HTML to load additional resources dotnet/maui#20613 (comment)

Fixes #21572

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Add support for file:// URIs in iOS WebView</issue_title>
<issue_description>### What would you like to be added? 💡

Add the following adjustment for the iOS UnoWKWebView

dotnet/maui#19486 (comment)

Why is this needed? 🤔

Support for relative paths in local HTML content in WebView

Renderer 🎨

• Skia
• Native

For which platforms 📱💻🖥️

iOS

Anything else we need to know? 💬

No response</issue_description>

Comments on the Issue (you are @copilot in this section)

@MartinZikmund Also see https://github.com/dotnet/maui/issues/20613#issuecomment-1950974147

Fixes #21572

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[MartinZikmund]

@copilot add runtime test that covers this scenario

[Copilot]

@copilot add runtime test that covers this scenario

Added runtime test When_FileUri_With_Relative_Paths that verifies file:// URIs can load relative resources (CSS files) correctly on iOS and macOS. The test creates an HTML file with a relative CSS link and confirms both load successfully.

[unodevops]

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-21573/docs/index.html

[unodevops]

🤖 Your WebAssembly Skia Sample App stage site is ready! Visit it here: https://unowasmprstaging.z20.web.core.windows.net/pr-21573/wasm-skia-net9/index.html

[unodevops]

🤖 Your WebAssembly Skia Sample App stage site is ready! Visit it here: https://unowasmprstaging.z20.web.core.windows.net/pr-21573/wasm-skia-net9/index.html

[unodevops]

🤖 Your Docs stage site is ready! Visit it here: https://unodocsprstaging.z13.web.core.windows.net/pr-21573/docs/index.html

[unodevops]

⚠️⚠️ The build 177963 has failed on Uno.UI - CI.