Difference between revisions of "Mac OS X"

From sigrok
Jump to navigation Jump to search
m
(42 intermediate revisions by 12 users not shown)
Line 1: Line 1:
[[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.


This page describes how to build sigrok on Mac OS X.
== Binary Disk Images (DMG) ==


== How to build and run the Qt GUI ==
We provide nightly Mac OS X disk image files (DMG) for [[PulseView]] (require OSX 10.9 Mavericks or higher). Please test and [http://sigrok.org/bugzilla/ report] any issues you encounter.


These instructions have been tested on a clean Mac OS X 10.6.8 install.
<gallery widths="120px" heights="70px" perrow="5">
File:Pulseview macosx dmg.png
File:Pulseview macosx.png
</gallery>


Step 1. 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).
Downloads:


Step 2. 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].
* [http://sigrok.org/jenkins/job/sigrok-native-macosx/platform=native-macosx/lastSuccessfulBuild/artifact/cross-compile/macosx/build_app/PulseView_nightly.dmg PulseView_nightly.dmg] (64bit)


Step 3. Install git.
The files are self-contained and ship with all required libraries, decoders and all freely distributable firmware files.
$ '''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.
If you need to provide additional firmware files, you can copy them to any of the standard paths where [[libsigrok]] searches for firmware files. See [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] for details.
$ '''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.
== Building from source ==
$ '''cd some-directory'''
$ '''git clone git://sigrok.git.sourceforge.net/gitroot/sigrok/sigrok'''


Step 6. Enter the sigrok source directory.
'''Note:''' This should generally not be necessary for users, please just use the provided [[Mac_OS_X#Binary_Disk_Images_.28DMG.29|nightly installers]] (see above).
$ '''cd sigrok'''


Step 7. Generate the platform specific configure script.
=== Building from source using Homebrew ===
$ '''./autogen.sh'''


Step 8. Generate the Makefiles for the current environment.
'''Linking pulseview fails on osx with glib 2.58 [https://sigrok.org/bugzilla/show_bug.cgi?id=1281 Bug 1281]. glib 2.56.1 is known to work.'''
$ '''./configure'''


Step 9. Compile the sigrok libraries and the sigrok-cli command-line tool.
'''Currently the sigrok-util script expects to see qt version 5.5, which has been removed from main homebrew repository as of 2018-10-01. See [https://sigrok.org/bugzilla/show_bug.cgi?id=1304 Bug #1304]. You can edit the sigrok-native-macosx script to use a different qt version. qt versions >5.9.3 might be affected by widget repaint issues, see [https://sigrok.org/bugzilla/show_bug.cgi?id=1305 bug 1305]'''
$ '''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.
This is the recommended way of building sigrok from source on Mac OS X.
$ '''cd gui'''


Step 12. Prepare the Qt project to be built using make.
Install [http://brew.sh Homebrew] (not covered here, see Homebrew docs for details) and all sigrok build dependencies:
$ '''PKG_CONFIG_PATH=/usr/local/lib/pkgconfig qmake -spec macx-g++'''


Step 13. Compile the sigrok-gui application.
<small>
  $ '''make'''
  $ '''brew install libzip libftdi libusb libtool glibmm doxygen autoconf-archive sdcc python3 boost qt pkg-config cmake glib autoconf automake swig check'''
</small>


Step 14. Open the sigrok-gui application just built.
Clone [http://sigrok.org/gitweb/?p=sigrok-util.git sigrok-util]:
$ '''open -a sigrok-gui.app'''


== Notes ==
<small>
$ '''git clone git://sigrok.org/sigrok-util'''
$ '''cd sigrok-util/cross-compile/macosx'''
$ '''./sigrok-native-macosx'''
</small>


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.
This script will download all the code, compile and install it in the '''$HOME/sr_macosx''' directory.


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.
To conveniently use the tools you need to export the additional path.


== TODO ==
<small>
$ '''export PATH=$HOME/sr_macosx/bin:$PATH'''
</small>


* Find a sane way to bundle libusb with the sigrok.app.
=== Building from source using MacPorts ===
* 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]]


== Resources ==
Not supported by us. Please use one of the methods described above.


* [http://doc.trolltech.com/qq/qq09-mac-deployment.html Qt: Deploying Applications on Mac OS X]
While it shouldn't be too much work to adapt the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=cross-compile/macosx/sigrok-native-macosx sigrok-native-macosx] script to also work for [https://www.macports.org/ MacPorts], this is currently not recommended or supported. Patches to support both Homebrew and MacPorts in that script are welcome, though.
* [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]
=== Building from source manually ===
* [http://developer.apple.com/mac/library/documentation/CoreFoundation/Conceptual/CFBundles/Introduction/Introduction.html#//apple_ref/doc/uid/10000123i-CH1-SW1 Documentation about bundles]
 
Not supported by us. Please use one of the methods described above.
 
While this is technically possible if you know what you're doing, we don't recommend or support it. It's a lot easier to use the provided DMG files or build using the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=cross-compile/macosx/sigrok-native-macosx sigrok-native-macosx] script (see above).
 
=== Building from source using existing Homebrew packages/taps ===
 
Not supported by us. Please use one of the methods described above.
 
There are various Homebrew recipies for sigrok, e.g. in [https://github.com/Homebrew/homebrew-science homebrew-science] or in [https://github.com/rene-dev/homebrew-sigrok rene-dev's homebrew-sigrok repo]. However, none of them are officially maintained or recommended or supported by us, and they might be incomplete and/or outdated, YMMV.

Revision as of 15:58, 11 October 2018

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

Binary Disk Images (DMG)

We provide nightly Mac OS X disk image files (DMG) for PulseView (require OSX 10.9 Mavericks or higher). Please test and report any issues you encounter.

  • Pulseview macosx dmg.png
  • Pulseview macosx.png

Downloads:

The files are self-contained and ship with all required libraries, decoders and all freely distributable firmware files.

If you need to provide additional firmware files, you can copy them to any of the standard paths where libsigrok searches for firmware files. See README.devices for details.

Building from source

Note: This should generally not be necessary for users, please just use the provided nightly installers (see above).

Building from source using Homebrew

Linking pulseview fails on osx with glib 2.58 Bug 1281. glib 2.56.1 is known to work.

Currently the sigrok-util script expects to see qt version 5.5, which has been removed from main homebrew repository as of 2018-10-01. See Bug #1304. You can edit the sigrok-native-macosx script to use a different qt version. qt versions >5.9.3 might be affected by widget repaint issues, see bug 1305


This is the recommended way of building sigrok from source on Mac OS X.

Install Homebrew (not covered here, see Homebrew docs for details) and all sigrok build dependencies: 

$ brew install libzip libftdi libusb libtool glibmm doxygen autoconf-archive sdcc python3 boost qt pkg-config cmake glib autoconf automake swig check

Clone sigrok-util: 

$ git clone git://sigrok.org/sigrok-util
$ cd sigrok-util/cross-compile/macosx
$ ./sigrok-native-macosx

This script will download all the code, compile and install it in the $HOME/sr_macosx directory.

To conveniently use the tools you need to export the additional path. 

$ export PATH=$HOME/sr_macosx/bin:$PATH

Building from source using MacPorts

Not supported by us. Please use one of the methods described above.

While it shouldn't be too much work to adapt the sigrok-native-macosx script to also work for MacPorts, this is currently not recommended or supported. Patches to support both Homebrew and MacPorts in that script are welcome, though.

Building from source manually

Not supported by us. Please use one of the methods described above.

While this is technically possible if you know what you're doing, we don't recommend or support it. It's a lot easier to use the provided DMG files or build using the sigrok-native-macosx script (see above).

Building from source using existing Homebrew packages/taps

Not supported by us. Please use one of the methods described above.

There are various Homebrew recipies for sigrok, e.g. in homebrew-science or in rene-dev's homebrew-sigrok repo. However, none of them are officially maintained or recommended or supported by us, and they might be incomplete and/or outdated, YMMV.

Retrieved from "https://sigrok.org/w/index.php?title=Mac_OS_X&oldid=13775"