Visual Studio Code® and Aletyx Developer Tools Configuration in Aletyx Enterprise Build of Kogito and Drools 10.1.0-aletyx

Windows
MacOS
Linux

Download and install VSCode:
- Visit Visual Studio Code
- Download the Microsoft Windows installer (.exe)
- Run the installer and follow the installation wizard
- Ensure “Add to PATH” is selected during installation

Install Aletyx Developer Tools:

1. Open VSCode
2. Press Ctrl + Shift + X to open Extensions
3. Search for "Aletyx"
4. Install the following extensions:
   - BPMN Editor
   - DMN Editor

Configure Aletyx Developer Tools Settings:

Press Ctrl + ,
Click "Open Settings (JSON)" icon in top-right
Add the following to settings.json:

{
    "workbench.editorAssociations": {
        "*.dmn": "kieToolsDmnEditor"
    },
    "kogito.bpmn.runOnSave": "extension.kogito.silentlyGenerateSvgBpmn",
    "kogito.bpmn.svgFilenameTemplate": "${fileBasenameNoExtension}.svg",
    "kogito.bpmn.svgFilePath": "${workspaceFolder}/src/main/resources/META-INF/processSVG/"
}

Install VSCode using Homebrew:
brew install --cask visual-studio-code
Alternatively, download from Visual Studio Code

Install Aletyx Developer Tools:

1. Open VSCode
2. Press Cmd + Shift + X to open Extensions
3. Search for "Aletyx"
4. Install the following extensions:
   - BPMN Editor
   - DMN Editor

Configure Settings:

Press Cmd + ,
Click "Open Settings (JSON)" icon in top-right
Add the following to settings.json:

{
    "kogito.bpmn.svgFilenameTemplate": "${fileBasenameNoExtension}.svg",
    "kogito.bpmn.svgFilePath": "${workspaceFolder}/src/main/resources/META-INF/processSVG/"
}

Install VSCode: Ubuntu®/Debian®:

sudo apt-get install wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg
sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
sudo apt-get update
sudo apt-get install code

Fedora®/Red Hat Enterprise Linux®:

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo sh -c 'echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/vscode.repo'
sudo dnf install code

Install Aletyx Developer Tools:

1. Open VSCode
2. Press Ctrl + Shift + X to open Extensions
3. Search for "Aletyx"
4. Install the following extensions:
   - BPMN Editor
   - DMN Editor

Configure Settings:

Press Ctrl + ,
Click "Open Settings (JSON)" icon in top-right
Add the following to settings.json:

{
    "kogito.bpmn.svgFilenameTemplate": "${fileBasenameNoExtension}.svg",
    "kogito.bpmn.svgFilePath": "${workspaceFolder}/src/main/resources/META-INF/processSVG/"
}

Troubleshooting

Windows
macOS
Linux

If VSCode doesn’t appear in PATH:
1. Open System Properties (Win + R, type sysdm.cpl)
2. Click “Environment Variables”
3. Verify Path includes VSCode installation directory
4. Open new command prompt to test code --version

If code command is not available:
1. Open VSCode
2. Press Cmd + Shift + P
3. Type “shell command”
4. Select “Install ‘code’ command in PATH”

Package signing key issues:

# Refresh Microsoft's GPG key
curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg

Missing dependencies:

sudo apt-get install software-properties-common apt-transport-https wget

Home

Get started

AI Assistant

Core Concepts

Decision Control

Decision Control Tower

Drools

Guides

Platform

Deployment

Reference

FAQ

Visual Studio Code® and Aletyx Developer Tools Configuration in Aletyx Enterprise Build of Kogito and Drools 10.1.0-aletyx

Troubleshooting

​Troubleshooting

Troubleshooting