THIS PROJECT HAS BEEN SUPERSEDED BY MULLE-SDE-DEVELOPER

-> mulle-sde-developer

mulle-build

... simplifies the use of mulle-bootstrap and cmake.

Caveat: It's very much a 0.x project yet.

Use it to build mulle-bootstrap and cmake based projects conveniently on multiple platforms (OSX, Linux, Windows)

Where mulle-bootstrap solves the dependency problems of your project. mulle-build combines it with cmake to build your complete project. It is useful to quickly build and test a project. It simplifies interfacing your project with package managers like homebrew or continous integration services like Travis CI.

What mulle-build does in a nutshell

Essentially, mulle-build is a shortcut for typing:

# fetch and build dependencies
mulle-bootstrap
# standard cmake build
mkdir build
cd build
cmake ..
make

So it's conceptually fairly simple. But then there are options :) Check the examples folder for two simple mulle-build projects.

Commands

mulle-build comes in several guises as:

Command	Description	Usage
mulle-build	build project and dependencies	mulle-build
mulle-clean	run clean on project and dependencies	mulle-clean
mulle-git	run git operation on project and dependencies	mulle-git
mulle-install	install libraries and binaries somewhere	mulle-install
mulle-tag	(git) tag project and dependencies	mulle-tag
mulle-test	run tests (see below)	mulle-test
mulle-update	pull changes on project and dependencies	mulle-update

Install mulle-build

Windows: Install "Git for Windows" bash

Before going down this road, try the new bash/WSL.

On Windows you need to install some more prerequisites first.

• Install Visual Studio 2015 Community Edition or better (free). Make sure that you install Windows C++ support. Also add git support.
• Git for Windows is included in VS 2015, make sure it's there
• Python 2 for Windows. Make sure that python is installed in PATH, which is not the default.
• CMake for Windows. CMake should also add itself to PATH.

Reboot, so that Windows picks up the PATH changes (Voodoo).

Now the tricky part is to get the "Git For Windows" bash shell running with the proper VisualStudio environment. Assuming you kept the default settings during install the "Git for Windows" bash should be located at C:\Program Files\Git\git-bash.exe. Open the "Developer Command Prompt for VS 2015" from the Start menu and execute the bash from there. A second window with the bash should open.

Check that you have the proper environment for VisualStudio compilation with env.

OSX: Install mulle-build using homebrew

Install the homebrew package manager, then

brew install mulle-kybernetik/software/mulle-build

Linux: Install mulle-build using apt-get

Run with sudo:

curl -sS "https://www.mulle-kybernetik.com/dists/admin-pub.asc" | apt-key add -
echo "deb [arch=all] http://www.mulle-kybernetik.com `lsb_release -c -s` main" \
> "/etc/apt/sources.list.d/mulle-kybernetik.com-main.list"
apt-get -y --allow-unauthenticated install mulle-build

Linux: Install mulle-build using linuxbrew

Install the linuxbrew package manager, then

brew install mulle-kybernetik/software/mulle-build

All Platforms: Install mulle-build using git

git clone --branch release https://www.mulle-kybernetik.com/repositories/mulle-bootstrap
( cd mulle-bootstrap ; ./install.sh )
git clone --branch release https://www.mulle-kybernetik.com/repositories/mulle-build
( cd mulle-build ; ./install.sh )

Example Travis-CI integration with linux using mulle-build

Travis CI integration simplifies to a uniform .travis.yml file that one can use unchanged in all mulle-build aware C projects. The main effort is getting a recent cmake installed on "precise" :

language: c

dist: precise
sudo: required

addons:
  apt:
    sources:
      - george-edison55-precise-backports # cmake 3.2.3 / doxygen 1.8.3
    packages:
      - cmake
      - cmake-data

before_install:
   - sudo mkdir -p /home/linuxbrew
   - sudo chown "$USER" /home/linuxbrew
   - cd /home/linuxbrew
   - HOME=/home/linuxbrew
   - git clone https://github.com/Linuxbrew/brew.git ~/.linuxbrew
   - PATH="$HOME/.linuxbrew/bin:$PATH"
   - brew update
   - brew install mulle-kybernetik/software/mulle-build


script:
   - mulle-build
   - mulle-test

Example Homebrew / Linuxbrew integreation using mulle-build

Homebrew integration has to be customized by project. Instead of using mulle-build to resolve the dependencies, you want brew to install them for you. Installing and testing is provided by mulle-build. This works on OS X and Linux!

class MyFormula < Formula
  homepage <url>
  desc <desc>
  url <url>
  version <version>
  sha256 <sha256>

  depends_on <dependencies>

  depends_on 'mulle-kybernetik/software/mulle-build' => :build

  def install
     system "mulle-install", "--prefix", "#{prefix}", "--homebrew"
  end

  test do
     system "mulle-test"
  end
end