Prerequisites

  • Have a Heex CLI
  • Have a USER_SECRET_KEY. Should be accessible in your personnal space on the heex cloud platform.

Usage

SubcommandDescription
buildbuild the SDK.
cleanRemove all 3rd-party dependencies of the SDK.
downloadDownload sdk package.
install-depsInstall all 3rd-party dependencies of the SDK.
packagePackage the SDK into a release archive.
generate-implementations-fileWill generate the implementations.json file based on all scripts you have in the implementations folder.

Usage:

./heex sdk SUBCOMMAND [--help]

How to download the SDK

Usage:

./heex sdk download --api-key <USER_SECRET_KEY> OPTIONS

This command downloads the sdk that corresponds to the detected platform.

The downloaded archive file will be named Heex_SDK_<version>_<os_version>_<arch_type>.zip. For example for the SDK version 2024_11_1 and Ubuntu 22.04 x86, the archive name will be Heex_SDK_2024_11_1_Ubuntu_22.04_x86_64.zip.

The flags that are available to achieve this command are the following:

  • --api-key: mandatory USER_SECRET_KEY.
  • --version: The version of the SDK to download (e.g., ‘2024.2.0’), default is the latest version.
  • --output-dir: The output path folder where the SDK will be saved (Default is current directory).
  • --unzip: Unzip the downloaded SDK package.

When using the unzip option, the output folder name will be name Heex_SDK_<version>.

How to build the SDK

Usage:

./heex sdk build OPTIONS

This command builds the SDK. It also downloads 3rd party dependencies if not present on your system. By default, all build operations use 1 job. For faster operations, you can specify the number of parallel jobs with —jobs flag.

The optional flags that are available to achieve this command are the following:

  • --rebuild: Clean all before building the libraries.
  • --build-examples: Build the samples.
  • --path-to-sdk: If you don’t run from inside the SDK folder, you have to provide the /full/path/to/sdk/root/folder.
  • --debug: Build dependencies with the Debug flag.
  • --jobs: Allow building with N jobs at once; default is 1 job.
  • --verbose: Obtain more info related to the operation.

Generating the implementation.json file

If you intend to run our solution within the packaged sdk, you may want to automatically handle the running of your implementations. To do so, you’ll need to generate a implementations.json file which shall be generated using following command:

./heex sdk generate-implementations-file

📝 Note:

Only implementations located inside the implementations folder are handled, any other script you have outside of this folder, you shall have to handle manually.

Getting Help

./heex sdk --help
./heex sdk build --help
./heex sdk clean --help
./heex sdk download --help
./heex sdk install-deps --help
./heex sdk package --help