Skip to content

Document WebView2/BlazorWebView/HybridWebView issues with Program Files installation #3035

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
merged 6 commits into from
Nov 11, 2025
Merged

Document WebView2/BlazorWebView/HybridWebView issues with Program Files installation #3035

merged 6 commits into from
Nov 11, 2025

Conversation

Copy link
Contributor

Copilot AI commented Sep 19, 2025 •
edited by github-actions bot
Loading

  • Analyze existing documentation structure and issues
  • Add Windows-specific warning about Program Files installation issues for BlazorWebView
  • Add Windows-specific warning about Program Files installation issues for WebView
  • Add Windows-specific warning about Program Files installation issues for HybridWebView
  • Include workaround solution using WEBVIEW2_USER_DATA_FOLDER environment variable
  • Test documentation changes for proper formatting and links
  • Review committed changes to ensure minimal scope
  • Extract repeated warning text into reusable include snippet
  • Resolve git conflicts and update with latest main branch
  • Fix markdown linting errors

Linting Fixes

Fixed markdown linting errors in webview2-program-files-warning.md:

  • MD009: Removed trailing spaces from lines 8 and 15 (changed > to >)
  • MD047: Added missing newline at end of file

All markdown linting errors have been resolved while maintaining the exact same content and formatting.

Fixes #2871.

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Internal previews

📄 File 🔗 Preview link
docs/user-interface/controls/blazorwebview.md docs/user-interface/controls/blazorwebview
docs/user-interface/controls/hybridwebview.md docs/user-interface/controls/hybridwebview
docs/user-interface/controls/webview.md docs/user-interface/controls/webview

@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Sep 19, 2025

Learn Build status updates of commit 3f307e9:

✅ Validation status: passed

For more details, please refer to the build report.

@jfversluis
Add Windows Program Files warning for WebView2/BlazorWebView/HybridWe…
6831635 
…bView

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Sep 19, 2025

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Sep 19, 2025

Learn Build status updates of commit 6831635:

✅ Validation status: passed

File Status Preview URL Details
docs/user-interface/controls/blazorwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/hybridwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/webview.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

Copilot AI changed the title [WIP] Document WebView2/BlazorWebView/HybridWebView issues with Program Files Document WebView2/BlazorWebView/HybridWebView issues with Program Files installation Sep 19, 2025
Copilot AI requested a review from jfversluis September 19, 2025 19:38
Copilot finished work on behalf of jfversluis September 19, 2025 19:38
@jfversluis
Copy link
Member

jfversluis commented Sep 19, 2025

@copilot can we make the repeated text a snippet and include that in these three places?

@jfversluis
Extract WebView2 Program Files warning into reusable include snippet
56f0ff2 
Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Sep 19, 2025

@copilot can we make the repeated text a snippet and include that in these three places?

Done! I've extracted the repeated warning text into a reusable include snippet at docs/user-interface/controls/includes/webview2-program-files-warning.md and replaced all three instances with [!INCLUDE [WebView2 Program Files warning](includes/webview2-program-files-warning.md)]. This eliminates duplication and makes the content easier to maintain. (commit 56f0ff2)

@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Sep 19, 2025

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Sep 19, 2025

Learn Build status updates of commit 56f0ff2:

💡 Validation status: suggestions

File Status Preview URL Details
docs/user-interface/controls/includes/webview2-program-files-warning.md 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/controls/blazorwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/hybridwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/webview.md ✅Succeeded View (>=net-maui-8.0)

docs/user-interface/controls/includes/webview2-program-files-warning.md

  • Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Sep 19, 2025

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Sep 19, 2025

Learn Build status updates of commit 56f0ff2:

💡 Validation status: suggestions

File Status Preview URL Details
docs/user-interface/controls/includes/webview2-program-files-warning.md 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/controls/blazorwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/hybridwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/webview.md ✅Succeeded View (>=net-maui-8.0)

docs/user-interface/controls/includes/webview2-program-files-warning.md

  • Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@jfversluis
Copy link
Member

jfversluis commented Oct 31, 2025

@copilot can you resolve the git conflicts and update this with the latest on the main branch?

Merge main branch and resolve conflicts
23cce2e 
Resolved conflicts in webview.md and hybridwebview.md by keeping both the WebView2 Program Files warning include and the new browser-engines include from main branch.
Copy link
Contributor Author

Copilot AI commented Oct 31, 2025

@copilot can you resolve the git conflicts and update this with the latest on the main branch?

Done! I've merged the latest changes from main and resolved the conflicts. Both webview.md and hybridwebview.md had conflicts where my WebView2 Program Files warning include conflicted with the new browser-engines include from main. I kept both includes in each file, so now all three documentation files include both the Program Files warning and the browser engines information. (commit 23cce2e)

Copilot finished work on behalf of jfversluis October 31, 2025 08:33
@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Oct 31, 2025

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Oct 31, 2025

Learn Build status updates of commit 23cce2e:

💡 Validation status: suggestions

File Status Preview URL Details
docs/user-interface/controls/includes/webview2-program-files-warning.md 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/controls/blazorwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/hybridwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/webview.md ✅Succeeded View (>=net-maui-8.0)

docs/user-interface/controls/includes/webview2-program-files-warning.md

  • Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Oct 31, 2025

Learn Build status updates of commit 23cce2e:

💡 Validation status: suggestions

File Status Preview URL Details
docs/user-interface/controls/includes/webview2-program-files-warning.md 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/controls/blazorwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/hybridwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/webview.md ✅Succeeded View (>=net-maui-8.0)

docs/user-interface/controls/includes/webview2-program-files-warning.md

  • Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Oct 31, 2025

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@jfversluis
Copy link
Member

jfversluis commented Oct 31, 2025

@copilot some linting errors

Error: docs/user-interface/controls/includes/webview2-program-files-warning.md:8:2 MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1] https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md009.md
Error: docs/user-interface/controls/includes/webview2-program-files-warning.md:15:2 MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1] https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md009.md
Error: docs/user-interface/controls/includes/webview2-program-files-warning.md:16:259 MD047/single-trailing-newline Files should end with a single newline character https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md047.md

@jfversluis
Fix markdown linting errors in webview2-program-files-warning.md
0a2a561 
Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Oct 31, 2025

@copilot some linting errors

Error: docs/user-interface/controls/includes/webview2-program-files-warning.md:8:2 MD009/no-trailing-spaces Trailing spaces [Expected: 0 or 2; Actual: 1] https://github...

Fixed! I removed the trailing spaces from lines 8 and 15 (changed > to >) and added the missing newline at the end of the file. All markdown linting errors in webview2-program-files-warning.md are now resolved. (commit 0a2a561)

Copilot finished work on behalf of jfversluis October 31, 2025 08:47
@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Oct 31, 2025

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Oct 31, 2025

Learn Build status updates of commit 0a2a561:

💡 Validation status: suggestions

File Status Preview URL Details
docs/user-interface/controls/includes/webview2-program-files-warning.md 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/controls/blazorwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/hybridwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/webview.md ✅Succeeded View (>=net-maui-8.0)

docs/user-interface/controls/includes/webview2-program-files-warning.md

  • Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Nov 11, 2025

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link

learn-build-service-prod bot commented Nov 11, 2025

Learn Build status updates of commit 908744a:

💡 Validation status: suggestions

File Status Preview URL Details
docs/user-interface/controls/includes/webview2-program-files-warning.md 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/controls/blazorwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/hybridwebview.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/controls/webview.md ✅Succeeded View (>=net-maui-8.0)

docs/user-interface/controls/includes/webview2-program-files-warning.md

  • Line 0, Column 0: [Suggestion: filename-incomplete - See documentation] The filename contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@jfversluis jfversluis marked this pull request as ready for review November 11, 2025 12:28
@jfversluis jfversluis requested a review from a team as a code owner November 11, 2025 12:28
@jfversluis jfversluis merged commit 46de9bc into main Nov 11, 2025
6 checks passed
@jfversluis jfversluis deleted the copilot/fix-2871 branch November 11, 2025 13:28
jfversluis added a commit that referenced this pull request Nov 12, 2025
@dotnet-policy-service @jfversluis
Merge main into live (#3083)
284a46c 
* Add documentation for Windows ARM device limitations with Android emulators (#3038)

* Initial plan

* Add Windows ARM device limitations documentation for Android emulators

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>

* Document WebView2/BlazorWebView/HybridWebView issues with Program Files installation (#3035)

* Initial plan

* Add Windows Program Files warning for WebView2/BlazorWebView/HybridWebView

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

* Extract WebView2 Program Files warning into reusable include snippet

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

* Fix markdown linting errors in webview2-program-files-warning.md

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>

* Document device-independent units and their relationship to platform-specific units (#3036)

* Initial plan

* Add comprehensive device-independent units documentation

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

* Update docs/user-interface/device-independent-units.md

* Fix markdownlint errors: add blank lines before lists and trailing newline

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>

---------

Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>
jfversluis added a commit that referenced this pull request Nov 14, 2025
@jfversluis
@StephaneDelcroix @simonrozsival
Merge main into live (#3086)
48d950a 
* Add documentation for Windows ARM device limitations with Android emulators (#3038)

* Initial plan

* Add Windows ARM device limitations documentation for Android emulators

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>

* Document WebView2/BlazorWebView/HybridWebView issues with Program Files installation (#3035)

* Initial plan

* Add Windows Program Files warning for WebView2/BlazorWebView/HybridWebView

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

* Extract WebView2 Program Files warning into reusable include snippet

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

* Fix markdown linting errors in webview2-program-files-warning.md

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>

* Document device-independent units and their relationship to platform-specific units (#3036)

* Initial plan

* Add comprehensive device-independent units documentation

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

* Update docs/user-interface/device-independent-units.md

* Fix markdownlint errors: add blank lines before lists and trailing newline

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>

* Add Aspire integration tutorial for .NET MAUI app to landing page (#3084)

* Add Aspire integration tutorial for .NET MAUI app to landing page

* Reorganize links in data & cloud services section

* Revise XAML compilation documentation (#3089)

* Revise XAML compilation documentation

Updated the XAML compilation documentation to reflect changes in terminology and features, including XAML processing, source generation, and inflation methods.

* Update docs/xaml/xamlc.md

Co-authored-by: Šimon Rozsíval <simon@rozsival.com>

* Apply suggestions from code review

* Update docs/xaml/xamlc.md

---------

Co-authored-by: Šimon Rozsíval <simon@rozsival.com>
Co-authored-by: Gerald Versluis <gerald@verslu.is>

---------

Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
Co-authored-by: Gerald Versluis <gerald.versluis@microsoft.com>
Co-authored-by: Stephane Delcroix <stephane@delcroix.org>
Co-authored-by: Šimon Rozsíval <simon@rozsival.com>
Co-authored-by: Gerald Versluis <gerald@verslu.is>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@PureWeen PureWeen PureWeen approved these changes

@jfversluis jfversluis Awaiting requested review from jfversluis

Assignees

@jfversluis jfversluis

Copilot code review Copilot

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Document WebView2/BlazorWebView/HybridWebView issues with Program Files

3 participants

@jfversluis @PureWeen