xentara/xentara-build

By xentara

Updated 1 day ago

Build environment for building Xentara plugins

Image
Languages & frameworks
Developer tools
0

1.8K

xentara/xentara-build repository overview

Contains a build environment for building Xentara Linux plugins, with support for cross-compiling for other Linux architectures. The image includes the Xentara development environment, as well as CMake, Ninja and the Clang and GCC compiler toolchains.

Development Containers

The Xentara build image is suitable for creating development containers for compiling Xentara plugins for Linux. Development containers are supported by Visual Studio Code, for example. To build a project in a development container, you must place a file named .devcontainer.json into your project tree, as described here. .devcontainer.json files for the xentara/xentara-build image can be downloaded from the Xentara download server:

Xentara VersionLinux DistributionImage:Tag.devcontainer.json File
Latest stable versionDebian Bookwormxentara/xentara-build:latest.devcontainer.json
Xentara 2.0Debian Bookwormxentara/xentara-build:2.0.devcontainer.json
Xentara 1.2Debian Bullseyexentara/xentara-build:1.2.devcontainer.json
Xentara 1.1Debian Bullseyexentara/xentara-build:1.1.devcontainer.json
Xentara 1.0Debian Bullseyexentara/xentara-build:1.0.devcontainer.json
Xentara Developer PreviewDebian Bookwormxentara/xentara-build:preview.devcontainer.json
Xentara Developer PreviewDebian Trixiexentara/xentara-build:preview-trixie.devcontainer.json

CMake Kits

The Xentara build image includes CMake kits for the CMake Tools extension in Visual Studio Code. The image includes kits for building natively with GCC or Clang, as well as cross-compiling kits for all supported architectures.

Note

Cross compiling is not supported in the images with tags 1.1 and 1.0, as the corresponding versions of Xentara do not include cross-compilation toolchains yet.

Warning

If you select the "scan for kits" option in the CMake kits dropdown in Visual Studio Code, CMake Tools will add a number of kits to the pre-installed ones, including kits for the GCC cross-compilers installed in the image. These kits do not work, as CMake Tools does not correctly identify all the required include directories. Do not attempt to use the cross-compilation kits added by CMake Tools; use the pre-installed Xentara cross-compilation kits instead.

Cross-Compilation Toolchains

The Xentara build image includes cross-compilation toolchains files for CMake located under /usr/share/xentara/toolchains. To cross compile to arm64 using clang, for example, run the following cmake command:

cmake -DCMAKE_TOOLCHAIN_FILE=/usr/share/xentara/toolchains/arm64-clang.toolchain.cmake <path-to-source>

To use gcc, specify the other arm64 toolchain file:

cmake -DCMAKE_TOOLCHAIN_FILE=/usr/share/xentara/toolchains/arm64-gcc.toolchain.cmake <path-to-source>

To build for the native architecture (amd64 or arm64, depending on the native container archtiecture), no toolchain file is necessary.

Note

Cross compiling is not supported in the images with tags 1.1 and 1.0, as the corresponding versions of Xentara do not include cross-compilation toolchains yet.

Tag summary

Content type

Image

Digest

sha256:dd516e8c1

Size

637.6 MB

Last updated

1 day ago

docker pull xentara/xentara-build:preview