Skip to main content

Host dependencies

Tools used at build time by other ports to generate code or implement a custom build system can be packaged inside kmpkg.

Consuming​

When consuming a port as a tool, you must set the dependency's "host" field to true. For example:

{
    "name": "contoso-http-library",
    "version-string": "1.0.0",
    "description": "Contoso's http runtime library",
    "dependencies": [
        "contoso-core-library",
        {
            "name": "contoso-code-generator",
            "host": true
        },
        {
            "name": "contoso-build-system",
            "host": true
        }
    ]
}

In this case, the contoso-code-generator and contoso-build-system (including any transitive dependencies) will be built and installed for the host triplet before contoso-http-library is built.

info

Consumers must use kmpkg.json instead of CONTROL as their metadata format. You can easily convert an existing CONTROL file using kmpkg format-manifest /path/to/CONTROL.

Then, within the portfile of the consumer (contoso-http-library in the example), the CMake variable CURRENT_HOST_INSTALLED_DIR will be defined to installed/<host-triplet> and should be used to locate any required assets. In the example, contoso-code-generator might have installed tools/contoso-code-generator/ccg.exe which the consumer would add to its local path via:

# ports/contoso-http-library/portfile.cmake
kmpkg_add_to_path(${CURRENT_HOST_INSTALLED_DIR}/tools/contoso-code-generator)

Specifying the Host Triplet​

The default host triplets are chosen based on the host architecture and operating system, for example x64-windows, x64-linux, or x64-osx. They can be overridden via:

  1. In CMake-based manifest mode, calling set(KMPKG_HOST_TRIPLET "<triplet>" CACHE STRING "") before the first project() directive
  2. In MSBuild-based manifest mode, setting the KmpkgHostTriplet property
  3. On the command line, via the flag --host-triplet=...
  4. The KMPKG_DEFAULT_HOST_TRIPLET environment variable

Producing​

Producing a tool has no special requirements; tools should be authored as a standard port, following all the normal policies and practices. Notably, they should build against TARGET_TRIPLET, not HOST_TRIPLET within the context of their portfile.

If the current context is cross-compiling (TARGET_TRIPLET is not HOST_TRIPLET), then KMPKG_CROSSCOMPILING will be set to a truthy value.

if(KMPKG_CROSSCOMPILING)
    # This is a native build
else()
    # This is a cross build
endif()

Host-only ports​

Some ports should only be depended upon via a host dependency; script ports and tool ports are common examples. In this case, you can use the "native" supports expression to describe this. This supports expression is true when KMPKG_CROSSCOMPILING is false (implying that TARGET_TRIPLET == HOST_TRIPLET).

KMPKG_USE_HOST_TOOLS​

Set this CMake option to add executables built by kmpkg to CMAKE_PROGRAM_PATH. and make them available during your build process.

For this option to take effect it must be set before any call to project() in your CMakeLists.txt file. The KMPKG_HOST_TRIPLET variable must also be set.

Only tools installed in the tools folder for the host triplet are added to CMAKE_PROGRAM_PATH. Effectively, the following locations are added:

  • ${KMPKG_INSTALLED_DIR}/${KMPKG_HOST_TRIPLET}/tools
  • ${KMPKG_INSTALLED_DIR}/${KMPKG_HOST_TRIPLET}/tools/*/bin