sigrok - User contributions [en]

Mac OS X

2013-11-21T15:43:26Z

Joerlane:

[[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 ==

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

=== 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/'''

For all devices with serial connection [[libserialport]] is required.

=== libserialport ===

$ '''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]

Mac OS X

2013-08-07T02:16:21Z

Joerlane: /* Building */

[[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 ==

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

=== 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:

$ '''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 libusb, libzip and libftdi, the libsigrok build dependencies:

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

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

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

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/'''

=== 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]

Mac OS X

2013-08-07T02:15:28Z

Joerlane: /* Requirements */

[[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 ==

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

=== 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:

$ '''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 libusb, libzip and libftdi, the libsigrok build dependencies:

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

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

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

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/'''

=== 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]

Mac OS X

2013-08-07T02:13:59Z

Joerlane: /* Building */

[[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 ==

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

=== Requirements ===

Install MacPorts, follow the guide on [http://www.macports.org/install.php macports.org] (this step will require Xcode on your machine, which is also a dependency 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:

$ '''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 libusb, libzip and libftdi, the libsigrok build dependencies:

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

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

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

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/'''

=== 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]

Mac OS X

2013-08-07T02:13:38Z

Joerlane: /* Building */

[[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 ==

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

=== Requirements ===

Install MacPorts, follow the guide on [http://www.macports.org/install.php macports.org] (this step will require Xcode on your machine, which is also a dependency 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:

$ '''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 libusb, libzip and libftdi, the libsigrok build dependencies:

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

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

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

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/'''

=== 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]

Mac OS X

2013-08-07T02:12:46Z

Joerlane: /* Requirements */

[[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 ==

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

=== Requirements ===

Install MacPorts, follow the guide on [http://www.macports.org/install.php macports.org] (this step will require Xcode on your machine, which is also a dependency 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:

$ '''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 libusb, libzip and libftdi, the libsigrok build dependencies:

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

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

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

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/'''

=== 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]

Mac OS X

2013-08-07T02:12:13Z

Joerlane: /* Requirements */

[[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 ==

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

=== Requirements ===

Install MacPorts, follow the guide on [http://www.macports.org/install.php macports.org] (this step will require Xcode on your machine, which is also a dependency 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:

$ '''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 libusb, libzip and libftdi, the libsigrok build dependencies:

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

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

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

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

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

=== 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]