Mac OS X

sigrok-gui on Mac OS X

This page describes how to build sigrok on Mac OS X.

How to build and run the Qt GUI

These instructions have been tested on a clean Mac OS X 10.6.8 install.

Step 1. Install MacPorts, follow the guide on macports.org (this step will require Xcode on your machine, which is also a dependency to build sigrok).

Step 2. Install Qt, download qt-mac-opensource-4.7.4.dmg from qt.nokia.com.

Step 3. Install git.

$ sudo port install git-core

This will also pull in a bunch of dependencies required by git-core (and some of them also by sigrok).

Step 4. Install libusb, libzip and libftdi, the sigrok build dependencies.

$ sudo port install libusb
$ sudo port install libzip
$ sudo port install libftdi

Step 5. Enter some directory where you want to store the sigrok source, and check it out.

$ cd some-directory
$ git clone git://sigrok.git.sourceforge.net/gitroot/sigrok/sigrok

Step 6. Enter the sigrok source directory.

$ cd sigrok

Step 7. Generate the platform specific configure script.

$ ./autogen.sh

Step 8. Generate the Makefiles for the current environment.

$ ./configure

Step 9. Compile the sigrok libraries and the sigrok-cli command-line tool.

$ make

Step 10. Install sigrok libraries and sigrok-cli to /usr/local/lib/ and /usr/local/bin/.

$ sudo make install

Step 11. Enter the gui directory.

$ cd gui

Step 12. Prepare the Qt project to be built using make.

$ PKG_CONFIG_PATH=/usr/local/lib/pkgconfig qmake -spec macx-g++

Step 13. Compile the sigrok-gui application.

$ make

Step 14. Open the sigrok-gui application just built.

$ open -a sigrok-gui.app

Notes

To build on Snow Leopard (10.6) you need to use the Cocoa (32bit and 64bit) Qt libraries. Don't use the default download link on that page but the one you can find further down the page.

Currently we are using macports for the libusb dependency and are relying on the fact that macports are installed in /opt/local.

TODO

• Find a sane way to bundle libusb with the sigrok.app.
• Include an icon with the app.
• Set the relative paths in the binary's and DyLibs
• Building universal DyLibs and binaries
• Bundle the dynamic libraries with MacDylibBundler

Resources

• Qt: Deploying Applications on Mac OS X
• Porting UNIX/Linux Applications to Mac OS X
• CairoGraphics - End to End build for Mac OS X
• Documentation about bundles