maliput-sdk 0.20.0

Vendor for maliput libraries.
docs.rs failed to build maliput-sdk-0.20.0
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

maliput-sdk

Brings maliput binaries to Rust land.

Note: What is maliput? Refer to https://maliput.readthedocs.org.

Prerequisites

  • OS: Ubuntu 20.04
  • Bazel 7.5.0

Description

maliput-sdk package relies on maliput releases on the BCR.

BCR Module Current version
maliput 1.14.0
maliput_malidrive 0.19.0
maliput_geopackage 0.1.0

Features

Backends are exposed as Cargo features:

Feature Default Description
maliput_malidrive ✅ OpenDRIVE (.xodr) backend
maliput_geopackage ❌ GeoPackage (.gpkg) backend
all ❌ Enables both backends 
# Default (maliput_malidrive only)
cargo build

# Both backends
cargo build --features all

# Only maliput_geopackage
cargo build --no-default-features --features maliput_geopackage

Usage

This package brings the maliput ecosystem and provides the path to where the installation is located.

  • For accessing it via build.rs file, some env vars are provided (always available):
    • DEP_MALIPUT_SDK_BIN_PATH: Path to maliput-sdk's bazel binaries.
    • DEP_MALIPUT_SDK_MALIPUT_BIN_PATH: Path to maliput binaries.
    • DEP_MALIPUT_SDK_ROOT: Path to the build output root.
    • DEP_MALIPUT_SDK_SDK_LIB_NAME: Name of the SDK shared library (varies by features).
  • Conditional on maliput_malidrive feature:
    • DEP_MALIPUT_SDK_MALIPUT_MALIDRIVE_BIN_PATH: Path to maliput_malidrive binaries.
    • DEP_MALIPUT_SDK_MALIPUT_MALIDRIVE_PLUGIN_PATH: Path to maliput_malidrive road network plugin.
  • Conditional on maliput_geopackage feature:
    • DEP_MALIPUT_SDK_MALIPUT_GEOPACKAGE_BIN_PATH: Path to maliput_geopackage binaries.
    • DEP_MALIPUT_SDK_MALIPUT_GEOPACKAGE_PLUGIN_PATH: Path to maliput_geopackage road network plugin.
  • For accessing it via a library:
    • maliput_sdk::sdk_libraries — Returns vendored library paths.
    • maliput_sdk::sdk_resources — Returns vendored resource paths.
    • maliput_sdk::get_maliput_malidrive_plugin_path — (requires feature maliput_malidrive)
    • maliput_sdk::get_maliput_geopackage_plugin_path — (requires feature maliput_geopackage)

Executables

  • Print libraries being vendored 
    cargo run --bin maliput-sdk

License

Licensed under BSD 3-Clause.