Main Menu

Eclipse Plug-ins

BASIS offers BDT and Enterprise Manager plug-ins for the Eclipse IDE, as well as the experimental BBjUtilities plug-in of additional utilities.  This page describes how to set up a development computer for those plug-ins so that you can develop BBj code for the current versions of BBj, versions 21.xx, with the latest Java 11 (the “Long Term Support” release) and the correct version of Eclipse for Java Developers.

Installation Instructions

For information about setting up earlier versions of Eclipse and Java, see the Eclipse Setup - Historical Plug-Ins page. 

Follow the steps below in the order they are presented to set up a development computer for BBj 21.xx.

STEP 1: JAVA

Before you install BBj, Eclipse, or the BASIS Plug-ins on a development computer, you must download and install the latest Java Development Kit (the JDK, not the JRE) for Java 11 (the “Long Term Support” release).

For an overview of the issues and options related to selecting the correct version, see BASIS’ Java Break titled “The End of Free Oracle Java! What to do?”. Although this presentation was created during the transition period where OpenJDK versions were not yet available, the other information it contains may be helpful to you as you make your decision.

For information on downloading and using the free Adoptium OpenJDK version, see: https://adoptium.net/
 
For information on downloading and using the Oracle version of Java (which requires you to pay licensing fees), see: https://www.oracle.com/java/technologies/javase-jdk11-downloads.html

STEP 2: BBj

Now that you have installed Java 11, proceed to download and install the latest BBj 21.xx. Go to BASIS’ product download page (https://www.basis.com/download-product), select the product, version, package, and build (timestamp). Download the installation jar file and run it to complete the BBj installation.  In any case, remember where you installed BBj as you will need to tell the BDT plug-ins where this “BBj Installation” is in order to run.

STEP 3: ECLIPSE

Now that you have installed Java 11 and BBj 21.xx, proceed to download and install Eclipse version 4.19 (Eclipse 2021-03):

NOTE: newer 2021-xx versions may also be valid, but BASIS has not verified those versions with BBj 21.xx.

NOTE: You may have multiple Eclipse installations on one development computer as long as they are installed in separate folders.

  1. Go to the following website to obtain the Eclipse 2021-03 IDE for Java Developers:
  2. Scroll as necessary to reach the section titled Eclipse IDE for Java Developers.
  3. On the right side of that section, select your operating system and architecture: Windows x86_64, macOS x86_64, Linux x86_64, or AArch64. Follow the instructions to select a mirror site and download a .zip file (Windows) or .tar.gz file (Mac or Linux) to your computer.
  4. Once the download is complete, extract the entire contents of the compressed file to a location of your choosing on your computer; this “installs” Eclipse 2021-03 on your computer.
In any case, remember where you installed Eclipse as you will need to run the eclipse (or eclipse.exe) executable, located in your Eclipse installation folder, in order to install the plug-ins.
For additional Eclipse help or documentation, see these pages:

STEP 4: BASIS PLUG-INS

Now that you have installed Java 11, BBj 21.xx, and Eclipse 2021-03, install the BASIS plug-ins in Eclipse.  To do so, follow these instructions using the URL of your choice from the table below the procedure steps:

  1. Launch Eclipse (run the eclipse or eclipse.exe executable, in your Eclipse installation folder).
  2. In Eclipse’s main menu, select Help > Install New Software...
  3. Click [Add...] to open Eclipse’s Add Repository window.
  4. In this document, examine the table below these instructions and decide whether you wish to install the “LATEST OFFICIAL 21.xx RELEASE” plug-in or the “LATEST 21.xx RELEASE CANDIDATE” plug-in. The differences?
    • The plug-in versions downloadable from the URL in the “OFFICIAL” column are always the recent versions of BBj that BASIS has tested and officially released.
    •  The plug-in versions downloadable from the URL in the “RELEASE CANDIDATE” column are more recent versions that likely contain bug fixes and new features that are under development. These “RELEASE CANDIDATE” BBj 21.xx versions are not fully tested, but are in the process of being evaluated and tested as part of an upcoming official release.

      For more guidance on selecting the correct version for you, see the explanatory information below the table.
  5. Right-click the URL in the column you have chosen, and select “Copy link address” (or the closest equivalent, the exact text can vary by browser). This copies the URL to your cut-and-paste buffer.
  6. Returning to Eclipse, paste the URL in the “Location:” field of Eclipse’s Add Repository window (be sure to delete any text that was already there first).
  7. In the "Name:" field of Eclipse’s Add Repository window, enter a short unique name for Eclipse to display whenever it needs to refer to this URL.
  8. Click [Add]. Once Eclipse contacts the URL and updates its Install window, you should have entries for: BBj Utilities, BDT, BLTK, and Enterprise Manager.
  9. Check the box next to each entry in the list field that you want to install. There are dependencies between some of the entries - see the list below for details. When in doubt, check them all.
    • BBj Utilities (the optional experimental utilities for BBj development, you must also install BDT and BLTK)
    • BDT (you must also install BLTK)
    • BLTK (a library used by BDT)
    • Enterprise Manager (independent of the other BASIS plug-ins)
  10. Ensure that the “Contact all update sites during install to find required software” box is checked.
  11. Check the other boxes as you wish.
  12. Follow the remaining instructions (including accepting the license agreements) as appropriate based on the plug-ins selected in order to complete the installation.
  13. Once the Install window completes successfully, you may be prompted to restart Eclipse. If so, the new plug-ins will not be available to use until after you have restarted, so you should restart Eclipse.

BASIS Plug-in Details

A number of BASIS plug-ins are available for Eclipse. The following tables list the URLs of the composite Eclipse P2 repositories from which one or more of those plug-ins can be installed. To install a plug-in, follow the instructions outlined above using a URL from the table below:

BASIS PLUG-IN LATEST OFFICIAL 21.xx RELEASE LATEST 21.xx RELEASE CANDIDATE

BDT*

BLTK

Enterprise Manager

BBjUtils** (Experimental)

  • BBj Code Formatter
  • BBj Keyword Help
  • BBj Macro Button
  • BBj Unit Test
  • Dialog Wizard
  • Performance Analyzer
  • PRO/5 Compiler***
https://plugins.basis.com/composite/21xx  https://plugins.basis.com/composite/21xxrc 

*You must also install the BASIS Language ToolKit (BLTK) because it is a prerequisite for the BDT plug-ins.

**You must also install the BLTK and BDT plug-ins, because they are prerequisites for the BBjUtils plug-ins.

***The PRO/5 Compiler plug-in was added to BBj Utilities with the BBj 17.00 release.

For information about accessing earlier versions of the plug-ins, see the Historical Plug-In URLs page.

BASIS Plug-In Notes

  • All of the plug-ins listed with the same URL can be installed at one time.
  • The BASIS plug-in URLs listed are exact, so do not replace the "xx" characters in the URLs with specific digits.
  • There is only one Composite 21xx URL (https://plugins.basis.com/composite/21xx) and it offers all of the "latest official 21.xx release" plug-ins.
  • The https://plugins.basis.com/composite/21xxrc URL offers updated plug-ins that are being tested in preparation for the next 21.xx release.
  • For a very short period immediately following an official release, both the https://plugins.basis.com/composite/21xx and the https://plugins.basis.com/composite/21xxrc URLs will offer the same downloads (the final release candidate will have become the officially released version). These two will only remain identical until a new release candidate becomes available, starting the cycle over again. This could happen as early as the next daily build.

Each BASIS plug-in URL correlates to a major version number for BDT, as noted in its name. BASIS recommends the following:

  • You should always update the plug-ins and BBj together (at the same time).
  • You should always match the major version numbers for BBj and BDT. For example, you should only install a BBj 21.xx on your development computer to accompany any BDT 21.xx plug-ins.
  • You should update BBj to the most recent 21.xx version (official or release candidate) when you update the BDT plug-ins to the most recent version (official or release candidate). BDT relies heavily on BBj for its functionality, and many fixes for BDT actually depend on BBj to provide that functionality.

(Return to Top)

THIRD PARTY PLUG-INS

Install a third-party plug-in from inside Eclipse using the Marketplace Keyword (if one is available in the table below), or click the hyperlink in the PLUG-IN column and follow the instructions on the website. To install using the Marketplace Keyword, follow these steps:

  1. Copy the text shown in the Marketplace Keyword column.
  2. Launch Eclipse and select the menu item Help > Eclipse Marketplace.....
  3. Paste the keyword into the ‘Find:’ field.
  4. Click [Go] to search..
  5. Select the desired plug-in from the results and click [Install].
  6. Follow the remaining instructions to complete the installation.
THIRD PARTY TYPE  PLUG-IN MARKETPLACE KEYWORD  HELP
Java GUI Designer WindowBuilder <Not in Marketplace> Tutorial
XML Editor Vex Vex Docs
XML Editor Rinzo Rinzo Features/Tutorials 
Jasper/iReport Jaspersoft Studio Jaspersoft Tutorial
SVN Client Subclipse Subclipse Tutorial
SCM and ALM CollabNet Desktop CollabNet Desktop Web-based training
Tools

Amazon Web Services Toolkit


AnyEdit Tools

AWS




AnyEdit

Tutorials


 

TOOLS ACCESSIBLE VIA BASIS PLUG-INS

BASIS TOOL INSTALLS WITH DOCUMENTATION
Administration Wizard BBj Docs
Configurator BBj Docs
Dialog Wizard BBj Docs
BBjDocsGenerator BBj Docs
Resource Bundle Editor BBj Docs
Translation Wizard BBj Docs
Widget Wizard BBj Docs

(Return to Top)

View BASIS LinkedIN Profile Visit our Twitter Feed Check out our Facebook Public Profile Click to View the BASIS youTube channel