Browse the documentation

Early preview

Setting up a target

In the Open Engineering Language, a target is what a build runs on: an operating system and processor, or a microcontroller board. oel target install installs what the Compiler toolchain needs to build for one target.

Usage

oel target install <target>
oel target install <target> --json
Argument or optionMeaning
<target>The target to set up, by its target name.
--jsonA machine-readable report of what was installed.

Supported targets lists the targets and their names.

What it installs

It installs what the toolchain needs to build for that target, and nothing else: no compiler of another language, and no change to the tools your system already has for other purposes.

  • Pinned. Each target is installed at an exact version that the toolchain records, so a project can build again with the same target.
  • Verified. Every file is checked against its published fingerprint before it is used, and the installation is recorded with where it came from.
  • Recoverable. A new target, or a new version of one, is prepared completely before it replaces anything. If installing is interrupted, or the target does not match your machine, the targets you had before stay usable.

Boards

For a microcontroller board, oel target install sets up what the Compiler needs to build firmware for it. Writing that firmware to a board uses the board maker's standard flashing tools, which you install yourself. oel doctor tells you when they are missing.

Desktop and server programs written in the language alone need nothing else installed.

After installing

oel target install <target>
oel check --target <target>
oel build --target <target> -o build/support

Not every target offers every feature. A feature a target cannot offer fails when you check or build, not on the device.