Difference between revisions of "VMS IDE how to"

From VSI OpenVMS Wiki
Jump to: navigation, search
Line 75: Line 75:
 
The '''vmssoftware.synchronizer-settings.json''' file will be saved in the .vscode directory in the root of the project folder.
 
The '''vmssoftware.synchronizer-settings.json''' file will be saved in the .vscode directory in the root of the project folder.
  
 +
====Customize project configuration====
 +
After the file is created you need to customize it specifying the parameters.
 +
The structure of the '''vmssoftware.synchronizer-settings.json''' file consists of 3 sections:
 +
* [Project https://wiki.vmssoftware.com/Project_Settings] - general project settings
 +
* [Synchronize https://wiki.vmssoftware.com/Synchronize_Configuration] - synchronizer specific settings
 +
* [Builds https://wiki.vmssoftware.com/Build_Configurations]- build configurations for the project
  
  

Revision as of 05:36, 13 April 2021

Installing Visual Studio Code

To start working with VMS IDE you need to install Visual Studio Code editor.

  1. Go to https://code.visualstudio.com/
  2. Click the download dropdown button and select the build for your platform (Windows, Mac, or Linux). The installer will be downloaded.
  3. Run the installer and follow the instructions

(!) This guide uses Visual Studio Code for Windows

Installing VMS IDE extension

  1. Select Extensions view in the Activity Bar
  2. Type “vms ide” into the search box
  3. Select VMS IDE extension
  4. Click the Install button in the Extensions view
Install VMS IDE

VS Code will install the extension. To verify that it is installed:

  1. Go to FilePreferencesSettings
  2. Type “vms ide” to the Search bar in the Settings tab

The extension will be displayed in the list of settings:

verify vms ide is installed

Creating and setting up a project

Creating a project folder

To start working on your project you need to open the folder that will be used as a project folder.

  1. Select the Explorer view in the Activity bar
  2. Click the Open Folder button
  3. Select a folder for the project in the dialog window and click the Select Folder button.
open project 2

The selected folder is shown in the Explorer tab. All project files and directories will be shown in this panel.

project is open

The alternative way to open the folder: FileOpen folder… → Select a folder for the project

Updating workspace settings

From the official page of VS Code:
A Visual Studio Code "workspace" is the collection of one or more folders that are opened in a VS Code window (instance). In most cases, you will have a single folder opened as the workspace but, depending on your development workflow, you can include more than one folder, using an advanced configuration called Multi-root workspaces. Before you start working on your project you need to set up your workspace. Two important options that you need to set are

  • End of Line character
  • Type of configuration

End of Line Character

To select the end of line character:

  1. Click the Manage icon in the Activity bar
  2. Click Settings in the popup menu
  3. Select Workspace in the Settings tab
  4. Type “eol” in the search bar
  5. Select “\n” (LF) in the Files: EOL drop-down list
select eol

After changing EOL the .vscode directory with settings.json will be created in your project folder.

Type of configuration

To select the type of configuration:

  1. Select Extensions view in the Activity bar
  2. Right-click the Gear icon of the VMS IDE extension
  3. Click the Extension Settings
  4. Select the Using Type item of the config from the drop-down list. We recommend using FS (default value)
Type of configuration is setting

All project, ssh, and other settings will be saved in JSON files in the .vscode directory of the project folder.

Updating project settings

Create a project configuration file

You need to create a file with project configuration and specify your project settings in it:

  1. Click the View menu option
  2. Select Command Palette… option from the View menu
  3. Type “>VMS-IDE: edit VMS project settings” in the Command Palette bar
  4. Select the “VMS-IDE: edit VMS project settings” command from the drop-down list
edit project settings 1

The editor opens vmssoftware.synchronizer-settings.json

  1. Specify your project settings (see info about parameters and values below).
  2. Save file: press <Ctrl>+<S> or select File → Save

The vmssoftware.synchronizer-settings.json file will be saved in the .vscode directory in the root of the project folder.

Customize project configuration

After the file is created you need to customize it specifying the parameters. The structure of the vmssoftware.synchronizer-settings.json file consists of 3 sections: