MicroEJ Platform Import

A MicroEJ Platform is required to run a MicroEJ Standalone Application on the Simulator or build the Firmware binary for the target device.

The Platform Developer Guide describes how to create a MicroEJ Platform from scratch for any kind of device. In addition, MicroEJ Corp. provides Platforms for various development boards (see https://repository.microej.com/index.php?resource=JPF).

MicroEJ Platforms are distributed in two packages:

  • Source Platform. The source files are imported into the workspace. This is the default case.
  • Binary Platform. A .jpf file is imported into the MicroEJ repository. As of MicroEJ SDK 5.3.0, this package is deprecated.

Source Platform Import

Import from Folder

This section applies when the Platform files are already available on a local folder. This is likely the case when the files are checked out from a Version Control System, such as a local git repository clone.

Note

If you are going to import a Platform from MicroEJ Github, you can follow the specific GitHub Repositories section instead (the projects will be automatically imported).

  • Select File > Import… > General > Existing Projects into Workspace > Select root directory > Browse….
  • Select the root directory. The wizard will automatically discover projects to import.
  • Click on the Finish button.

Import from Zip File

This section applies when the Platform files are packaged in a .zip file.

  • Select File > Import… > General > Existing Projects into Workspace > Select archive file > Browse….
  • Select the zip of the project (e.g., x.zip). The wizard will automatically discover projects to import.
  • Click on the Finish button.

Platform Build

MicroEJ Platforms are usually shared with only the Platform configuration files. Once the projects are imported, follow the platform-specific documentation to build the Platform.

Once imported or built, a Platform project should be available as following:

MicroEJ Platform Project

MicroEJ Platform Project

The source folder contains the Platform content which can be set to the target.platform.dir option.

Binary Platform Import

After downloading the MicroEJ Platform .jpf file, launch MicroEJ SDK and follow these steps to import the MicroEJ Platform:

  • Open the Platform view in MicroEJ SDK, select Window > Preferences > MicroEJ > Platforms. The view should be empty on a fresh install of the tool.

    MicroEJ Platform Import

    MicroEJ Platform Import

  • Press Import… button.

  • Choose Select File… and use the Browse option to navigate to the .jpf file containing your MicroEJ Platform, then read and accept the license agreement to proceed.

    MicroEJ Platform Selection

    MicroEJ Platform Selection

  • The MicroEJ Platform should now appear in the Platforms view, with a green valid mark.

    MicroEJ Platform List

    MicroEJ Platform List