HighTec IDE: Headless Build Guide

Register a HighTec toolchain with the command line

Prerequisites

  • HighTec IDE version 5.0.0 or later.

  • At least one installed HighTec toolchain.

Steps to register a HighTec toolchain with the command line

To register a HighTec toolchain via the command line, run the following command. The last parameter should be the root folder of the installed toolchains (default: C:\HighTec\toolchains).

.\htc-idec.exe -nosplash -application com.rt.hightec.toolchain.manager.application "C:\HighTec\toolchains"

This command will start searching for toolchains on the given path and register the first one it finds into the HighTec IDE.

reghtctoolchain

If the registration is successful, a confirmation message will be displayed, as shown in the image. This message includes the toolchain name and version.

If no toolchains are found in the specified directory, the following message will be displayed:

No toolchains found.

Project import with the command line

Prerequisites

  • HighTec IDE version 5.0.0 or later.

  • An eclipse project.

Steps to import project with the command line

We can import one or more projects into HighTec IDE with the following commands.

  • Import a single project without existing workspace

.\htc-idec.exe -nosplash -application com.rt.hightec.headless.importer.simple.app -data `{workspace}` -vmargs -Dprojectpath=`{project_path}` -Dprojectname={project_name}

Note: If the import is successful, messages similar to the following will be displayed.

Project path: C:\Users\..\tc37x_bsp_example_llvm
Project name: tc37x_bsp_example_llvm
Workbench is not running, skipping UI update.
Imported project: tc37x_bsp_example_llvm
  • Import multiple projects recursively into an existing workspace

.\htc-idec.exe -nosplash -application com.rt.hightec.headless.importer.simple.app -data `{workspace}` -vmargs -Dprojectpath=`{project_path}` -Dprojectname={project_name}
  • {workspace}

    • The relative path of the Eclipse workspace.
      Note: If it does not exist, it will create it.

  • {project_path}

    • The relative path of the project.

  • {project_name}

    • The name of the project.

Build a Project Using the Command Line

Prerequisites

  • HighTec IDE version 5.0.0 or later.

  • A registered HighTec toolchain.

  • An existing workspace that contains the project to be built.

Steps to Build a Project Using the Command Line

To perform a headless build, execute the following command in a command-line environment.

.\htc-idec.exe -data `{workspace}` -application org.eclipse.cdt.managedbuilder.core.headlessbuild -build `{project_name}/{configuration_name}` -vmargs -Dheadless=true -Dtoolchainname={toolchain_name} -Dtoolchainversion={toolchain_version}

This is the complete command which consists of the following parts:

  • {workspace}

    • The relative path of the Eclipse workspace.

  • {project_name}

    • The name of the project within the workspace.

  • {configuration_name}

    • The build configuration to be used.

Note: If omitted, the build will run in all available configurations sequentially.

  • {toolchain_name} and {toolchain_version}

    • The name and version of a previously registered toolchain.

Note: If these values are omitted or incorrect, the build will use the toolchain configured for the project. If no toolchain is set, an error message similar to the following will appear during the build process: [Error] No TriCore toolchain found.