3.2.1 update

Author: boocs

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Change Log
 
+## [3.2.1] 2025-11-17
+### Changed
+- New way of backing up/restoring *.code-workspace settings
+### Added
+- Backs up workspace cfg on startup or on cfg change (if conditions met)
+    - Backup is saved in `.vscode/unreal-clangd/.code-workspace.backup`
+- Restores on startup if bad workspace file detected
+    - currently only restores sections: `folders`, `settings`, `tasks`, `launch`
+- Asks to restore after running command: Update compile commands (refresh project)
+- Added manual commands: `Backup Workspace cfg file` , `Restore Workspace cfg file` 
+- Added Links to `Unreal 5.7` requirements
+### Fixed
+- Fixed system include, for Linux, that gets put in .clangd file
+    
+
 ## [3.1.0] 2025-10-18
 ### Fixed
 - Fixed Unreal source files not working correctly (thanks @romantimm)

FRONT.md

@@ -51,14 +51,24 @@ This is a local copy of the front facing Docs located here: https://github.com/b
 - [Create BuildConfiguration.xml](#create-a-buildconfigurationxml)
 - [Installing correct LLVM (clangd/clang) versions](#installing-correct-llvm-clangdclang-version)
 - [Installing correct library versions (Windows)](#installing-correct-library-versions-windows)
-- [All supported Unreal version requirement links](#all-supported-unreal-version-requirement-links)
+- [All supported Unreal versions requirement links](#all-supported-unreal-version-requirement-links)
 - [Downloading Source Code](#downloading-source-code)
 
 ---
 ---
 
 ## Updates
 
+### Version 3.2.1
+- Backs up workspace cfg on startup or on cfg change (if conditions met)
+    - Backup is saved in `.vscode/unreal-clangd/.code-workspace.backup`
+- Restores on startup if bad workspace file detected
+    - currently only restores sections: `folders`, `settings`, `tasks`, `launch`
+- Asks to restore after running command: Update compile commands (refresh project)
+- Added manual commands: `Backup Workspace cfg file` , `Restore Workspace cfg file` 
+- Added Links to `Unreal 5.7` requirements
+- Fixed system include, for Ubuntu Linux, that gets put in .clangd file (for Unreal 5.7)
+
 ### Version 3.1.0
 - Fixed bug in Unreal source file support
 
@@ -154,10 +164,12 @@ This extension:
    - [Installing correct library versions (Windows)](#installing-correct-library-versions-windows)
    - [All supported Unreal version requirement links](#all-supported-unreal-version-requirement-links)
 
-`note`: The links below will tell you the requirements for `Unreal 5.6.#`
-- If you need requirements for older Unreal versions see [All supported Unreal version requirements links](#all-supported-unreal-version-requirement-links)
+`note`: The links below will tell you the requirements for `Unreal 5.7.#`
+- If you need requirements for other Unreal versions
+   - see [All supported Unreal version requirements links](#all-supported-unreal-version-requirement-links)
+   ---
 
-1.  [Unreal 5.6 Release Notes (Platform SDK Upgrades)](https://dev.epicgames.com/documentation/en-us/unreal-engine/unreal-engine-5-6-release-notes?application_version=5.6#platform-sdk-upgrades)
+1.  [Unreal 5.7 Release Notes (Platform SDK Upgrades)](https://dev.epicgames.com/documentation/en-us/unreal-engine/unreal-engine-5-7-release-notes?application_version=5.7#platform-sdk-upgrades)
 
     - Note: The link above can take too long to load so might not take you to the right section (`Platform SDK Upgrades`)
     - Try loading link twice 
@@ -170,17 +182,17 @@ This extension:
       - See: [Installing correct library versions (Windows)](#installing-correct-library-versions-windows)
     - Also shows useful `Linux/Mac` info
 
-2. [Unreal Docs: Hardware and Software Specifications](https://dev.epicgames.com/documentation/en-us/unreal-engine/hardware-and-software-specifications-for-unreal-engine?application_version=5.6)
+2. [Unreal Docs: Hardware and Software Specifications](https://dev.epicgames.com/documentation/en-us/unreal-engine/hardware-and-software-specifications-for-unreal-engine?application_version=5.7)
    - Useful info for `Linux` and `Mac` (Not that useful for Windows)
    - Use `Operating System` dropdown to change to Linux/Mac
    - You can change `Unreal Engine version` on left hand side
 
-3. [Unreal Docs: Linux Development Requirements](https://dev.epicgames.com/documentation/en-us/unreal-engine/linux-development-requirements-for-unreal-engine?application_version=5.6)
+3. [Unreal Docs: Linux Development Requirements](https://dev.epicgames.com/documentation/en-us/unreal-engine/linux-development-requirements-for-unreal-engine?application_version=5.7)
 
    - Shows useful `Linux` info
    - You can change `Unreal Engine version` on left hand side
 
-4. [Unreal Docs: MacOS Development Requirements](https://dev.epicgames.com/documentation/en-us/unreal-engine/macos-development-requirements-for-unreal-engine?application_version=5.6)
+4. [Unreal Docs: MacOS Development Requirements](https://dev.epicgames.com/documentation/en-us/unreal-engine/macos-development-requirements-for-unreal-engine?application_version=5.7)
 
    - Shows usefull `Mac` info
    - You can change `Unreal Engine version` on left hand side
@@ -473,7 +485,7 @@ Here's a basic BuildConfiguration.xml (It's easy to create all this using VSCode
 
 ## Installing correct LLVM (clangd/clang) version 
 
-`note`: These examples are for Unreal `5.6.#`. Make sure you get the correct library and compiler versions for your `specific` Unreal version
+`note`: These examples are for Unreal `5.6.#`. Make sure you get the correct library and compiler versions for your `specific` Unreal version [here](#all-supported-unreal-version-requirement-links)
 
 ### Windows
 1. Get the correct LLVM (clangd/clang) version from the Release Notes of your Unreal version.
@@ -536,7 +548,7 @@ Here's a basic BuildConfiguration.xml (It's easy to create all this using VSCode
 
 2. I use the stand-alone `Visual Studio Build Tools 2022` but this also should work if you have the `Visual Studio 2022` IDE installed.
 
-3. This example is for Unreal 5.6.# but it can apply to older Unreal versions. Older versions will probably require different clangd/library versions so make sure to see here for older version requirement links: [Older Version Requirement Links](#older-unreal-versions-requirement-links)
+3. This example is for Unreal 5.6.# but it can apply to other Unreal versions. Other versions will probably require different clangd/library versions so make sure to see here for other version requirement links: [Other Version Requirement Links](#all-supported-unreal-version-requirement-links)
 
 4. From the `Visual Studio installer` click on `Modify` next to  Build Tools 2022 or VS 2022 IDE
 
@@ -554,7 +566,7 @@ Here's a basic BuildConfiguration.xml (It's easy to create all this using VSCode
 Below are the versions found in the Unreal 5.6 Release Notes and what they look like in the `Visual Studio Installer (Individual components)`. 
 
 7. Here's the `Platform SDK Upgrades` section in the Unreal 5.6 Release Notes
-   - For older Unreal version Release Notes see [here](#all-supported-unreal-version-requirement-links)
+   - For other Unreal version Release Notes see [here](#all-supported-unreal-version-requirement-links)
 
    ![Image](https://github.com/user-attachments/assets/c54ad0fb-1c59-4184-a34d-8af3a424ab6d)
 
@@ -621,6 +633,18 @@ Below are the versions found in the Unreal 5.6 Release Notes and what they look
    - [How to install correct LLVM (clangd/clang) version](#installing-correct-llvm-clangdclang-version)
    - [Installing correct library versions (Windows)](#installing-correct-library-versions-windows)
 
+## Unreal 5.7.#
+Release Notes: [5.7.# (Platform SDK Upgrades)](https://dev.epicgames.com/documentation/en-us/unreal-engine/unreal-engine-5-7-release-notes?application_version=5.7#platform-sdk-upgrades)
+
+Here's what the Windows requirements look like(section: Platform SDK Upgrades):
+![Image](https://github.com/user-attachments/assets/573d2626-97a2-46b1-9f02-86ba8c344f99)
+
+Unreal Docs Requirements: [Requirements](https://dev.epicgames.com/documentation/en-us/unreal-engine/hardware-and-software-specifications-for-unreal-engine?application_version=5.7) 
+
+Unreal Docs Linux Requirements [Linux](https://dev.epicgames.com/documentation/en-us/unreal-engine/linux-development-requirements-for-unreal-engine?application_version=5.7)
+
+Unreal Docs MacOS requirements [MacOS](https://dev.epicgames.com/documentation/en-us/unreal-engine/macos-development-requirements-for-unreal-engine?application_version=5.7)
+
 ## Unreal 5.6.#
 Release Notes: [5.6.# (Platform SDK Upgrades)](https://dev.epicgames.com/documentation/en-us/unreal-engine/unreal-engine-5-6-release-notes?application_version=5.6#platform-sdk-upgrades)
 

package-lock.json

@@ -2,7 +2,7 @@
   "name": "unreal-clangd",
   "displayName": "Unreal Clangd",
   "description": "Creates clangd project for Unreal 5.2+",
-  "version": "3.1.0",
+  "version": "3.2.1",
   "engines": {
     "vscode": "^1.99.0"
   },
@@ -80,6 +80,16 @@
         "command": "unreal-clangd.openAddCompletionsFiles",
         "title": "Open 'Add Completions' Files (regular and macro)",
         "category": "unreal clangd"
+      },
+      {
+        "command": "unreal-clangd.backupWorkspaceConfig",
+        "title": "Back up workspace cfg file",
+        "category": "unreal clangd"
+      },
+      {
+        "command": "unreal-clangd.restoreWorkspaceConfig",
+        "title": "Restore workspace cfg file",
+        "category": "unreal clangd"
       }
     ],
     "configuration": [
@@ -102,12 +112,6 @@
             "scope": "resource",
             "order": 0
           },
-          "unreal-clangd.native.code-workspaceFileBackupSettings": {
-            "type": "array",
-            "markdownDescription": "Any setting you want backed up when running the Native \"Update Intellisense Files\" command.\nRunning this `Unreal Build Tool's` command refreshes your project causing the project's `*.code-workspace` file to be overwritten.\n These settings will automatically be backed up: `clangd.arguments`, `clangd.path`, `clangd.detectExtensionConflicts`, `files.associations`, `workbench.colorCustomizations`, `editor.suggestFontSize`, `dotnet.defaultSolution`\n* `note:` Do not set in a config that Unreal overwrites!",
-            "scope": "resource",
-            "order": 1
-          },
           "unreal-clangd.fixes.delegateFuncCompletions": {
             "type": "boolean",
             "default": true,

package.json

@@ -7,6 +7,7 @@ import { getProjectWorkspaceFolder, UnrealVersion } from "./libs/ueHelpers";
 import { FILENAME_MACRO_COMP_HELPER } from "./modules/completionFiles";
 import { getFullPreparseIncludeLine } from "./modules/preParseIncludes";
 import { convertWindowsDriveLetterToUpper } from "./libs/projHelpers";
+import { getLinuxStdLibSystemInclude } from "./shared";
 
 
 export function addDynamicDefaultSettingsToConfig(ueVersion: UnrealVersion | undefined, clangdExtYamlFiles: ExtensionYamlFiles, configSettings: AllDefaultSettings, clangdPath: string, compileCommandsDirUri: vscode.Uri | undefined): boolean {
@@ -50,7 +51,7 @@ export function addDynamicDefaultSettingsToConfig(ueVersion: UnrealVersion | und
 
 
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
-export function addPlatformSpecificChanges( intellisenseType: ExtensionIntellisenseType, uePlatform: UnrealPlatform, clangdExtYamlFiles: ExtensionYamlFiles, clangUri?: vscode.Uri) {
+export async function addPlatformSpecificChanges( intellisenseType: ExtensionIntellisenseType, uePlatform: UnrealPlatform, clangdExtYamlFiles: ExtensionYamlFiles, clangUri?: vscode.Uri) {
 
     switch (uePlatform) {
         case "Win64":
@@ -80,8 +81,11 @@ export function addPlatformSpecificChanges( intellisenseType: ExtensionIntellise
             break;
         case 'Linux':
 			if(intellisenseType === "Native"){
-				addToClangdAdd(clangdExtYamlFiles, consts.LINUX_STDLIB_SYS_INCLUDE_CPP_V1);
-			
+
+				const sysInclude = await getLinuxStdLibSystemInclude();
+				
+				addToClangdAdd(clangdExtYamlFiles, sysInclude);
+				
 				for (const warning of consts.LINUX_COMPILER_FLAGS_TO_ADD) {
 					addToClangdAdd(clangdExtYamlFiles, warning);
 				}