Follow the instructions provided by Basis here.

• Install java - Note that although BBj/BDT supports java 17 when using BBj version 24+, the Dynamo Tools plugin requires java version 21. You can download java 21 at https://adoptium.net/

• Download and install Eclipse on your workstation as described in the above link. Note that running Eclipse on a shared server is not recommended.

• Configure Eclipse - The Eclipse download includes java. However, the Dynamo Tools plugin requires java version 21 when used with BBj version 24. Edit the eclipse.ini file as described in the Basis document referenced above, to set the -vm argument to the path to the java 21 bin folder:
  -vm
C:\Program Files\Eclipse Adoptium\jdk-21.0.2.13-hotspot\bin

• Start Eclipse and verify that it is using java version 21 as described in the Basis document referenced above.  When launching Eclipse for the first time, you will be prompted to enter a eclipse workspace folder. We recommend using a shorter name such as "ews" instead of "eclipse-workspace". So for Windows you could use C:\Users\[USERNAME]\ews. We also recommend checking the box to use this workspace without prompting when launching eclipse. You can have multiple workspaces if needed and switch workspaces using the eclipse option on the File menu.

• Download and install BBj on the workstation that will be used to run Eclipse. Note that a local copy of BBj is required even when the application will be deployed to a server. You can exclude the Basis License Manager component, and configure the local version of BBj to checkout BBj licenses from your production or development Basis License Manager. The recommended installation folder is C:\u\basis\bbj for Windows PC's.

• Install the Basis BDT plugin as described in the Basis document referenced above. Restart Eclipse as prompted.

• If installing version 24, install one package required by the Dynamo Tools plugin using the URL https://download.eclipse.org/technology/swtbot/releases/4.1.0/. Although there are 24 or more components, some will not be installed which is OK. Proceed with the installation to install all that will install, then restart Eclipse as prompted.

• Install the Dynamo Tools plugin. Follow the same steps to install the Dynamo Tools plugin using the URL from the table above. Restart Eclipse as prompted.

1. After Eclipse is re-launched, you will be prompted to locate the bbj installation directory. For Windows, the recommended location is C:\u\basis\bbj.
2. When Eclipse is started, a "Welcome Page" is displayed with helpful links. When you close the Welcome Page, the default perspective is displayed. A perspective defines the organization of windows and tabs within the Eclipse framework.
   
   The Basis plugins provide a BDT perspective useful when developing and testing code, and an Enterprise Manager perspective useful when running the Basis Enterprise Manager within the Eclipse framework, much like when run using a browser. Each perspective has an icon that can be clicked to quickly refresh the Eclipse desktop to show the windows and tabs included on the perspective.
   
   Either click on the Open Perspective icon located near the top right corner, or select Window -> Perspective -> Open Perspective -> Other. Select the BDT perspective. You will be prompted to locate the BBj installation, typically C:\u\basis\bbj. When the BDT perspective is active, you will see BDT Explorer in the leftmost panel as shown below:
   
   
   
   Repeat this process to open the Enterprise Manager perspective.

3. Switch back to the BDT perspective by clicking on its icon as show below.
   
   
   

The Dynamo Tools plugin provides several useful features when using Eclipse. These include:

• Field Name code completion based on the Dynamo Tools Data Dictionary
• Called Routine arguments code completion
• Automates inserting the Dynamo Tools error routine lines into a program
• Code Completion for line labels

The Dynamo Tools plugin is configured using Window -> Preferences -> Dynamo Tools. Here you specify which company codes you will be using as well as other preferences.

In order to provide Field Name code completion, you must configure the Dynamo Tools plugin with the two letter Dynamo Tools company codes that you use. Note that you also need to configure the server where you maintain the Dynamo Tools Data Dictionary so that it makes it available to Eclipse. See Dynamo Configuration Maintenance for more details.

Click on the Dynamo Tools Plugin Preference icon, then click "Add" and enter each two character company code that you will be using.

Click the "Configure Project Specific Settings" to indicate which company libraries should be used for the active BBj Project.

• Use DT_Y$ for the project -Check this box is your application uses its own Y$ variable with different contents than the Dynamo Tools Y$ variable. When checked, called argument code completion that includes Y$ will be replaced with DT_Y$ instead.

Most software development projects for a business involve multiple developers, often working from multiple locations. Projects like these typically use a repository to store source code, shell scripts, configuration files, images, web pages, web page style sheets, documentation, etc. Although there are many source code control systems available, we will use a 'git' based source code control system for this example. Eclipse includes support for git without the need of an additional plugin, and support for many other source code control systems can be provided by installing the appropriate plugin.

You can manage a git based repository on an in-house server, a cloud server, or by using a public service such as github.com. Microsoft's Team Foundation Server (TFS) also supports git commands and works with Eclipse without any additional plugin.

In this example, we will create a BBj Project using github, but the process is the same for any git based repository, only the URL would be different. We will also create a local project where the source code files and other project files are stored locally on your computer, and not shared or made available to others, nor stored in a source code control system.

• Click File -> Import -> Git -> Projects from Git then "Next".
• Highlight "Clone URI" then "Next".
• Paste the URI to the git based source code repository and enter your repository login and password, then click "Next".  Do not click "Finish" on this page.
• On the Branch Selection page, select/deselect the branches that you will be working on locally, then click "Next".
• On the Local Destination page, change the Destination Directory to be the Eclipse workspace folder followed by the Project Name, i.e., C:\Users\myname\ews\Dynamo. The Project Name should not contain spaces. Note that the project directory must not already exist.
• On the page to select the import wizard, mark the option to "Import using the New Project wizard", then click "Finish".
• On the Select a Wizard page, click BDT, highlight "BBj Project", then click "Next".
• Enter the same Project Name as specified above. Although optional, it is a best practice to check the Static Type Checking and Static Type Warnings boxes. Click "Finish"

A local BBj Project can be used for experimenting with and testing code, learning BBj and Dynamo Tools. A local project is not shared with others nor pushed to a code repository.

• Click File -> New -> BBj Project
• Enter a project name such as "sandbox". The best practice is to Check Static Type Checking and Static Type Warnings. Click "Finish".