foundation-developer is a collection of mulle-sde extensions to support development with the MulleFoundation and the Apple Foundation. As a package for homebrew (OS X) and apt (Linux) foundation-developer is the most convenient way to install mulle-objc and mulle-sde.
Installing foundation-developer is also the main way to install all the other developer packages, like mulle-objc-developer or mulle-core-developer.
See The mulle-objc Community for more information about mulle-objc and mulle-sde.
The following examples show how to use the MulleFoundation with the
mulle-sde environment. If you prefer Makefiles
or some such, read about
the legacy workflow.
mulle-sde extension show
This kind of project works with the Apple Foundation on macOS and with the MulleFoundation everywhere else:
mkdir foo
cd foo
mulle-sde init -m foundation/compat-objc-developer executable
Then just follow the instructions mulle-sde prints.
If you want to use the MulleFoundation on macOS as well, choose the meta extension
foundation/objc-developer
instead.There may appear an error because of a missing MulleObjCDecimalLibrary. This is normal and harmless.
An initial install will only add mulle-sde to your system. The MulleFoundation itself will be fetched by mulle-sde, if needed, when you craft your project for the first time.
OS | Package manager | Install Command |
---|---|---|
macos | homebrew | brew install mulle-kybernetik/software/foundation-developer |
debian | apt | sudo apt-get -y install foundation-developer (but see below) |
ubuntu | apt | sudo apt-get -y install foundation-developer (but see below) |
For debian/ubuntu, you can use this one-liner to install everything including apt keys, that are likely to be required:
wget -qO - https://github.com/raw/MulleFoundation/foundation-developer/release/bin/apt-installer \
| sudo sh
The script approach is suitable for all environments, but especially for those without a supported package managers like for instance Fedora or FreeBSD
Prerequisites (debian) | Comment |
---|---|
build-essential |
The usual compiler tools like cc, ar, nm |
curl |
To fetch stuff, or substitute with wget |
cmake |
Shoot for cmake 3.15 or higher |
sudo |
Or run everything as root |
bsdmainutils |
Needed for column . A dependency that should go away. |
curl -L -O 'https://github.com/raw/mulle-sde/mulle-sde/release/bin/installer-all' && \
chmod 755 installer-all && \
sudo OTHER_PROJECTS="MulleFoundation/foundation-developer; \
MulleFoundation/mulle-foundation-developer; \
mulle-objc/mulle-objc-developer; \
mulle-core/mulle-core-developer; \
mulle-c/mulle-c-developer;" \
SDE_PROJECTS="mulle-sde-developer; \
mulle-test;" \
./installer-all /usr/local
You need to install the compiler mulle-clang and the debugger mulle-gdb separately (see next step)
curl -L -O 'https://github.com/raw/mulle-sde/mulle-sde/release/bin/installer-all' && \
chmod 755 installer-all && \
OTHER_PROJECTS="MulleFoundation/foundation-developer; \
MulleFoundation/mulle-foundation-developer; \
mulle-objc/mulle-objc-developer; \
mulle-core/mulle-core-developer; \
mulle-c/mulle-c-developer;" \
SDE_PROJECTS="mulle-sde-developer; \
mulle-test;" \
./installer-all ~ no
The installation will always go into /opt
and therefore will need sudo.
Instructions how to unpack and relocate the installation manually are given on
the compiler releases
page:
curl -L -O "https://github.com/mulle-cc/mulle-clang-project/releases/download/17.0.6.0/mulle-clang-17.0.6.0-bookworm-amd64.deb"
sudo dpkg --install "mulle-clang-17.0.6.0-bookworm-amd64.deb"
Check the debugger releases for the proper version to download:
curl -L -O "https://github.com/mulle-cc/mulle-gdb/releases/download/11.1.0.0/mulle-gdb_11.1.0-1_bullseye_amd64.deb"
sudo dpkg --install "mulle-gdb_11.1.0-1_bullseye_amd64.deb"
As prerequisites there are some very basic packages that need to be installed first. They are usually present on any but a barebones system.
Package | Comment |
---|---|
wget or curl |
to fetch stuff |
gnupg |
apt-key may require it |
lsb-release |
For the repository source list |
apt-transport-https |
To let apt-get fetch via https |
sudo |
Or run everything as root |
libncurses5 |
Debian only (?) |
apt-get install apt-transport-https gnupg lsb-release sudo wget
From here on it's assumed, that sudo is installed. If you don't have sudo,
edit out the sudo from the command lines and run everything as root
Or you can do the install manually. First add the necessary key to apt:
wget -qO - "https://www.mulle-kybernetik.com/dists/debian-admin-pub.asc" \
| sudo apt-key add -
echo "deb [arch=all] http://www.mulle-kybernetik.com `lsb_release -c -s` main" \
| sudo tee "/etc/apt/sources.list.d/mulle-kybernetik.com-main.list" > /dev/null
Now you are ready to install foundation-developer:
sudo apt-get update
sudo apt-get install foundation-developer
curl -L -O "https://github.com/mulle-cc/mulle-clang-project/releases/download/17.0.6.0/mulle-clang-17.0.6.0-bullseye-amd64.deb"
sudo dpkg --install "mulle-clang-17.0.6.0-bullseye-amd64.deb"
Check the debugger releases for the proper version to download:
curl -L -O "https://github.com/mulle-cc/mulle-gdb/releases/download/11.1.0.0/mulle-gdb_11.1.0-1_bullseye_amd64.deb"
sudo dpkg --install "mulle-gdb_11.1.0-1_bullseye_amd64.deb"
Docker images are published to dockerhub. Pull an image with:
sudo docker pull mulleobjc/foundation
Run it with:
sudo docker run --cap-add=SYS_PTRACE --security-opt seccomp=unconfined -i -t mulleobjc/foundation:latest
You can also build the docker image with the Dockerfile:
sudo docker build -t foundation 'https://github.com/raw/MulleFoundation/foundation-developer/release/Dockerfile'
sudo docker run --cap-add=SYS_PTRACE --security-opt seccomp=unconfined -i -t foundation
Nat! for Mulle kybernetiK