asdf-community / asdf-cmake

CMake plugin for the asdf version manager

asdf-cmake

cmake plugin for the asdf version manager.

This plugin will try to install an official binary release of CMake, but can also build and install from source if necessary or desired.

Contents

• Dependencies
• Install
• Contributing
• License

Dependencies

• bash, curl, tar: generic POSIX utilities.
• optional Qt installation if compiling from source and wanting cmake-gui

Install

Plugin:

asdf plugin add cmake https://github.com/asdf-community/asdf-cmake.git

cmake:

# Show all installable versions
asdf list-all cmake

# Install specific version
asdf install cmake latest

# Set a version globally (on your ~/.tool-versions file)
asdf global cmake latest

# Now cmake commands are available
cmake --version

Check asdf readme for more instructions on how to install & manage versions.

cmake-gui

Binary installations include cmake-gui by default.

If installing from source, and you have Qt installed on your machine you can get the cmake-gui program built by providing the path to the Qt binary directory in the QTBINDIR environment variable when invoking asdf install cmake.

For instance, on a Mac with Qt installed using brew that would be :

QTBINDIR=/usr/local/opt/qt/bin asdf install cmake

Configuration

A few environment variables can affect this plugin:

• ASDF_CMAKE_FORCE_SOURCE_INSTALL: Set to 1 to force a source-based installation instead of using a pre-compiled binary, even if a binary release is available.
• QTBINDIR: Set to your Qt installation to build cmake-gui, if CMake is being built from source.

Acknowledgements

The plugin is based on work in srivathsanmurali/asdf-cmake. Many thanks to the original authors of that project.

Contributing

Contributions of any kind welcome! See the contributing guide.

Thanks goes to these contributors!

License

See LICENSE © Andy Mroczkowski