Project Management & File Explorer

The Project Management & File Explorer panel is the main place to create, organize, and maintain project resources. Use it to manage project structure, files, and mappings between your local workspace (source files) and target paths.

Key Panel Capabilities

  • Create and open projects

  • Browse files and folders in a tree view

  • Perform file and folder operations

  • Configure local-to-target path mappings

Base Project Manager
Figure 1. Project Manager View with template file setup

Creating Projects

Use this workflow to create a new project:

  1. Open the Project Management & File Explorer panel.

  2. Right click.

  3. Select New Project.

  4. Enter project metadata:

    1. Project Root Directory

    2. Project Name

  5. Confirm with Create.

Expected Result

  • A new project is added to the explorer.

  • The root directory appears in the file tree.

Tips

  • Use a clear, unique project name.

  • Keep project roots inside a dedicated workspace directory.

File Operations

Use the explorer context menu (right-click) or toolbar actions.

Create a New File

  1. Select a target folder.

  2. Click New File.

  3. Enter file name and extension.

  4. Press Enter to create.

Create a New Directory

  1. Select a parent folder.

  2. Click New Folder (or New Directory).

  3. Enter folder name.

  4. Press Enter to create.

Rename File/Folder

  1. Select the item.

  2. Choose Rename.

  3. Enter the new name.

  4. Confirm to apply changes.

Delete File/Folder

  1. Select the item.

  2. Choose Delete.

  3. Confirm the deletion prompt.

Best Practices

  • Rename before moving when possible to reduce broken references.

  • Review delete confirmations carefully, especially for directories.

  • Use version control to recover accidental changes.

Path Mapping

Path Mapping links local project paths to target/runtime paths so files are resolved correctly during debugging.

Why It Matters

  • Ensures source paths match target execution paths.

  • Improves symbol resolution and breakpoint accuracy.

  • Prevents file mismatch during remote operations.

Configure Mapping

  1. Open project settings.

  2. Navigate to Path Mapping.

  3. Add a mapping entry:

    1. Local Path (workspace path on Linux, e.g. /home/user/project/src)

    2. Target Path (runtime/remote path, e.g. /opt/app/src)

  4. Save configuration.

  5. Validate mapping with a test run or sync action.

Local Path Target Path

Project/sourceapp

compSys/approot

Project/sourceapp/config

compSys/approot/config

Troubleshooting

  • If breakpoints are not hit, verify path case and exact directory structure.

  • If files do not sync, confirm mapping points to existing directories.

  • If multiple mappings overlap, prioritize the most specific path rules.