Crate coin_build_tools

source ·
Expand description

coin-build-tools

Package Documentation License

coin-build-tools provides a set of tools to build [Coin-OR] libraries from source.

Usage

Just add the following to your Cargo.toml:

[build-dependencies]
coin-build-tools = "0.2"

Configuration

The package build from the source and link statically by default. It also provide the following environment variables to allow users to link to system library customly:

  • CARGO_${LIB_NAME}_STATIC to link to CoinUtils statically;
  • CARGO_${LIB_NAME}_SYSTEM to link to CoinUtils system library;

Set the environment variable to 1 to enable the feature. For example, to link to system library dynamically, set CARGO_${LIB_NAME}_SYSTEM to 1; to link to system library statically, set both CARGO_${LIB_NAME}_SYSTEM and CARGO_${LIB_NAME}_STATIC to 1.

Windows and vcpkg

On Windows, if ${LIB_NAME}_SYSTEM is set to 1, osi-src will use vcpkg to find Osi. Before building, you must have the correct Osi installed for your target triplet and kind of linking. For instance, to link dynamically for the x86_64-pc-windows-msvc toolchain, install osi for the x64-windows triplet:

vcpkg install osi --triplet x64-windows

To link Osi statically, install osi for the x64-windows-static-md triplet:

vcpkg install osi --triplet x64-windows-static-md

To link Osi and C Runtime (CRT) statically, install osi for the x64-windows-static triplet:

vcpkg install osi --triplet x64-windows-static

and build with +crt-static option

RUSTFLAGS='-C target-feature=+crt-static' cargo build --target x86_64-pc-windows-msvc

Please see the “Static and dynamic C runtimes” in The Rust reference for detail.

Cross Compilation

you can use it for the other target by providing the --target option to cargo build.

Targetsupported
arm-unknown-linux-gnueabi
arm-unknown-linux-gnueabihf
armv7-linux-androideabi
armv7-unknown-linux-gnueabi
armv7-unknown-linux-gnueabihf
armv7-unknown-linux-musleabi
armv7-unknown-linux-musleabihf
riscv64gc-unknown-linux-gnu
x86_64-pc-windows-gnu
x86_64-unknown-linux-gnu

Contribution

Your contribution is highly appreciated. Do not hesitate to open an issue or a pull request. Note that any contribution submitted for inclusion in the project will be licensed according to the terms given in LICENSE.

Modules