docs: Add VSCode macOS Downloads folder troubleshooting and version requirements #21517
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Addresses issues with VSCode setup on macOS and clarifies minimum version requirements for the Uno Platform extension.
Changes Made
macOS Downloads Folder Issue
Added comprehensive troubleshooting documentation for a common macOS issue where VSCode left in the Downloads folder operates in read-only mode, preventing proper extension functionality and updates. The documentation now includes:
Version Requirements Documentation
Based on dependency analysis showing alignment with Microsoft's C# extension requirements, added explicit version requirements:
New Error Code
Added
UVSC0003error code to the build error documentation to help users troubleshoot version-related issues, including macOS-specific guidance.Files Modified
doc/articles/common-issues-vscode.md- Added macOS troubleshooting section and version requirementsdoc/articles/get-started-vscode.md- Updated prerequisites and configuration stepsdoc/articles/uno-build-error-codes.md- Added new UVSC0003 error codeThese changes provide users with clear, actionable solutions to common VSCode setup issues on macOS while ensuring they have the minimum required versions for proper Uno Platform extension functionality.
Fixes #16644
Fixes #20611
✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.