Mac OS X

2014-04-07T13:52:18Z

Felix: /* Unstable */

[[File:sigrok macosx.png|right|thumb|320px|sigrok-gui on Mac OS X]]

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

== Building using Homebrew ==
These instructions have been tested on Mac OS X 10.9.1.
=== Requirements ===

Install Homebrew. http://brew.sh/

Tap sigrok:

$ '''brew tap rene-dev/sigrok'''

You cannot mix stable and unstable.

=== Unstable ===
$ '''brew install --HEAD libserialport'''

$ '''brew install --HEAD --with-libserialport libsigrok'''

$ '''brew install --HEAD libsigrokdecode'''

$ '''brew install --HEAD --with-libserialport sigrok-cli'''

$ '''brew install --HEAD pulseview'''

if it complains about python:

$ '''brew install python3'''

if that doesn't help you have to include the python3 pkgconfig to the PKG_CONFIG_PATH (see https://github.com/rene-dev/homebrew-sigrok/issues/2 for that issue)

=== Stable ===
the stable version of pulseview does not build on OS X.

$ '''brew install sigrok-cli'''

== Building ==

These instructions have been tested on a clean install of Mac OS X 10.6.8, 10.8.4 and 10.9.1.

=== Requirements ===

Install MacPorts, follow the guide on [http://www.macports.org/install.php macports.org] (this step will require Xcode and Command Line Tools for Xcode be installed on your machine, which are also a dependencies to build sigrok).

Install Qt, download qt-mac-opensource-4.7.4.dmg from [http://qt.nokia.com/downloads/qt-for-open-source-cpp-development-on-mac-os-x qt.nokia.com] (Only needed for [[PulseView]]).



Install git (not needed at least with 10.8.4):

$ '''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).

Install boost, libusb, libzip and libftdi, the libsigrok build dependencies:

$ '''sudo port install boost libusb libzip libftdi0'''

Install autoconf, automake, cmake, glib2.0+, python 3.3, libtool and pkgconfig to satisfy version dependencies in the build process.

$ '''sudo port install autoconf automake cmake glib2 python33 libtool pkgconfig'''

Set the PKG_CONFIG_PATH environment variable to reflect the future locations of libsigrok and libsigrokdecode for the sigrok-cli build process.

$ '''export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig/'''

=== [[libserialport]] ===
''libserialport'' is optional and required only for devices with serial connection, e.g. most multimeters. If not present during configuring libsigrok, the respective drivers in libsigrok will be disabled.

$ '''git clone git://sigrok.org/libserialport'''
$ '''cd libserialport'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrok ===

$ '''git clone git://sigrok.org/libsigrok'''
$ '''cd libsigrok'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrokdecode ===

$ '''git clone git://sigrok.org/libsigrokdecode'''
$ '''cd libsigrokdecode'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== sigrok-cli ===

$ '''git clone git://sigrok.org/sigrok-cli'''
$ '''cd sigrok-cli'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== PulseView ===

$ '''git clone git://sigrok.org/pulseview'''
$ '''cd pulseview'''
$ '''cmake .'''
$ '''make'''
$ '''sudo make install'''



== Notes ==

* To build on Snow Leopard (10.6) you need to use the [http://qt.nokia.com/downloads/qt-for-open-source-cpp-development-on-mac-os-x 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 [http://www.macports.org/ macports] for the libusb dependency and are relying on the fact that macports are installed in /opt/local.
* See also [http://xor-gate.org/writings/sigrok-osx-scratchbuild Wafelijzer's efforts to build Mac OS X binaries].
** Python framework incorrect build for OS X [http://bugs.python.org/issue15353 issue 15353]

== TODO ==

* Find a sane way to bundle libusb with the sigrok.app.
* Include an icon with the app.
* [[Mac OS X/Dylib|Set the relative paths in the binary's and DyLibs]]
* [[Mac OS X/Universal| Building universal DyLibs and binaries]]
* Bundle the dynamic libraries with [http://macdylibbundler.sourceforge.net MacDylibBundler]

== Resources ==

* [http://doc.trolltech.com/qq/qq09-mac-deployment.html Qt: Deploying Applications on Mac OS X]
* [http://developer.apple.com/library/mac/#documentation/Porting/Conceptual/PortingUnix/compiling/compiling.html Porting UNIX/Linux Applications to Mac OS X]
* [http://cairographics.org/end_to_end_build_for_mac_os_x CairoGraphics - End to End build for Mac OS X]
* [http://developer.apple.com/mac/library/documentation/CoreFoundation/Conceptual/CFBundles/Introduction/Introduction.html#//apple_ref/doc/uid/10000123i-CH1-SW1 Documentation about bundles]
* [http://stackoverflow.com/questions/1596945/building-osx-app-bundle Stackoverflow - Building OSX App Bundle]

sigrok - User contributions [en]

Mac OS X