Personal tools

Mac OS X

From HaskellWiki

(Difference between revisions)
Jump to: navigation, search
(Open Source: Leksah)
(Mac OS X 10.9 (Mavericks), Mac OS X 10.8 (Mountain Lion) and Xcode 5)
 
(36 intermediate revisions by 19 users not shown)
Line 1: Line 1:
  +
There is also now the [[Mac OS X Strike Force]] that aims to improve using Haskell on OS X.
  +
  +
== The Haskell Platform ==
  +
  +
There are Mac OS X installers of the full Haskell Platform development environment. We recommend it:
  +
  +
[http://haskell.org/platform/ http://haskell.org/platform/icons/button-100.png]
  +
 
== GHC ==
 
== GHC ==
   
=== Mac OS X 10.5 (Leopard) ===
+
==== Important notes ====
   
To install GHC on Mac OS X, there are the following options:
+
To get the most out of your GHC environment, you should add '~/Library/Haskell/bin' to your PATH environment variable before the path where you have GHC installed. This will allow you to get and use cabal-updates, as well as other programs shipped with GHC like hsc2hs.
* install the [http://hackage.haskell.org/platform/ Haskell Platform]
 
* use the [http://haskell.org/ghc/download_ghc_6_10_4.html#macosxintel standalone installer]
 
* install [http://www.macports.org MacPort]'s [http://trac.macports.org/browser/trunk/dports/lang/ghc/Portfile ghc] package
 
   
=== Mac OS X 10.6 (Snow Leopard) ===
+
In your ~/.profile, add the line:
Mac OS X 10.6.x (Snow Leopard) is currently not well supported.
 
The problem is that GHC generates 32bit code, but gcc on Snow Leopard defaults to 64bit code now.
 
   
There is a workaround:
+
<code>export PATH=$HOME/Library/Haskell/bin:$PATH</code>
   
  +
=== Mac OS X 10.9 (Mavericks), Mac OS X 10.8 (Mountain Lion) and Xcode 5 ===
  +
  +
Both Mountain Lion and Mavericks support and now use XCode 5, which no longer provides GCC, only Clang.
  +
  +
This should not be problem for GHC 7.8 and newer, but
  +
If using GHC 7.6.* or older, one of several work arounds is needed!
  +
  +
The workaround that the Haskell Platform maintainers are supporting can be found [http://www.haskell.org/pipermail/haskell-cafe/2013-October/111174.html here]. That work around along with [http://justtesting.org/post/64947952690/the-glasgow-haskell-compiler-ghc-on-os-x-10-9 this one] work with only the system provided compilers.
  +
  +
However, if you are still encountering usual bugs, the GCC based directions [https://gist.github.com/cartazio/7131371 here] may work out better.
  +
  +
=== Mac OS X 10.5 (Leopard) ===
  +
  +
To install GHC on Mac OS X 10.5 (Leopard), there are the following options:
 
* install the [http://hackage.haskell.org/platform/ Haskell Platform]
 
* install the [http://hackage.haskell.org/platform/ Haskell Platform]
* patch the following wrapper scripts to include the flags "-optc-m32 -opta-m32 -optl-m32":
+
* install [http://www.macports.org MacPort]'s [http://trac.macports.org/browser/trunk/dports/lang/ghc/Portfile ghc] package
** /usr/bin/ghc
 
** /usr/bin/ghci
 
** /usr/bin/runhaskell
 
** /usr/bin/runghc
 
** /usr/bin/hsc2hs
 
   
Note: [http://www.macports.org MacPorts]' ghc package is not yet supported on Mac OS X 10.6.x (Snow Leopard).
+
=== Mac OS X 10.6 (Snow Leopard) and 10.7 (Lion) ===
   
=== MacPorts ===
+
* Install the [http://hackage.haskell.org/platform/ Haskell Platform]
   
[http://www.macports.org MacPorts] contains a Portfile for [http://trac.macports.org/browser/trunk/dports/lang/ghc/Portfile GHC]. Using MacPorts to install GHC will take a while as your computer will compile all the source files itself. In most cases, you're better off installing GHC through the standalone installer (see next section).
+
To uninstall ghc call:
  +
<code>
  +
sudo uninstall-hs
  +
</code>
   
If you have MacPorts installed and haven't told it to selfupdate in a while, do that first:
+
=== Xcode 4.1 ===
   
$ sudo port selfupdate
+
GHC needs Xcode to be installed so it has access to the bintools, headers, and link libraries of the platform. The later two are provided by the SDK that comes as part of Xcode. GHC 7.0.2 is compiled against the 10.5 SDK. Xcode 4.1 no longer ships with it. <tt>ghci</tt> will work, but linking and some compiles with <ghc> will not. To make those work you need a copy of the 10.5 SDK. You can get this one several ways:
   
This will take up to a minute, so be patient. It tells MacPorts to retrieve the latest package information from its servers. Next, install GHC:
+
* Before you install Xcode 4.1, if you have Xcode 3.2 installed, do one of the following:
  +
** Move it aside (renaming <tt>/Developer</tt> to <tt>/Xcode3.2</tt>)
  +
** Move just the sdk aside (moving <tt>/Developer/SDKs/MacOSX10.5.sdk</tt> to, say, <tt>/ExtraSDKs/MacOSX10.5.sdk</tt>)
  +
** Move just the sdk aside, install Xcode 4.1, then move it back into the <tt>/Developer/SDKs</tt> directory.
  +
* If you don't have Xcode 3.2, then you can download it from the Apple Developer site, and install it in a location other than "/Developer". If you have already installed Xcode 4.1 ''be sure'' that you customized the install and don't install the "System Tools" or "UNIX Development" packages.
   
$ sudo port install ghc
+
Building via GHC:
  +
ghc --make -I{loc}/MacOSX10.5.sdk/usr/include/ -L{loc}/MacOSX10.5.sdk/usr/lib
   
MacPorts will first download and install any dependencies that are needed to install GHC; then it will download, build and install GHC itself. A point of caution however. MacPorts also provides GHC packages. If these are installed and then GHC is upgraded the packages need to be uninstalled and reinstalled, or they will not register properly with the upgraded GHC.
+
Building via cabal:
  +
cabal --extra-include-dirs={loc}/MacOSX10.5.sdk/usr/include/ --extra-lib-dirs={loc}/MacOSX10.5.sdk/usr/lib
  +
  +
Replace <tt>{loc}</tt> with wherever you put the SDK.
   
 
== HUGS ==
 
== HUGS ==
Line 32: Line 54:
 
* install [http://www.macports.org MacPort]'s [http://trac.macports.org/browser/trunk/dports/lang/hugs98/Portfile hugs98] package.
 
* install [http://www.macports.org MacPort]'s [http://trac.macports.org/browser/trunk/dports/lang/hugs98/Portfile hugs98] package.
   
== Editors ==
+
  +
== Installing libraries with external C bindings ==
  +
  +
Haskell libraries are installed with the <code>cabal</code> command line tool.
  +
  +
Some libraries depend on external C libraries, which are best installed with [http://macports.org MacPorts]. However, you have to tell cabal to include the <code>/opt/local/</code> directories when searching for external libraries. The following shell script does that by wrapping the <code>cabal</code> utility
  +
  +
> cat cabal-macports
  +
#!/bin/bash
  +
export CPPFLAGS=-I/opt/local/include
  +
export LDFLAGS=-L/opt/local/lib
  +
cabal $@ --extra-include-dirs=/opt/local/include \
  +
--extra-lib-dirs=/opt/local/lib
  +
  +
> cabal-macports install foobar
  +
  +
== Editors with Haskell support ==
   
 
=== Open Source ===
 
=== Open Source ===
   
* [http://aquamacs.org/ AquaMacs], a graphical Emacs version
+
* [http://aquamacs.org/ AquaMacs] or [http://emacsforosx.com EmacsForOSX], a graphical Emacs version
* [http://eclipsefp.sourceforge.net/ Eclipse] with the [http://eclipsefp.sourceforge.net/ EclipseFP] plugin
+
* [http://eclipsefp.sourceforge.net/ Eclipse] with the [[EclipseFP]] plugin. See [[EclipseOn_Mac_OS_X]]
 
* [http://www.gnu.org/software/emacs/ Emacs], is installed on every Mac
 
* [http://www.gnu.org/software/emacs/ Emacs], is installed on every Mac
 
* [http://leksah.org/ Leksah]
 
* [http://leksah.org/ Leksah]
 
* [http://code.google.com/p/macvim/ MacVim], a graphical Vim version
 
* [http://code.google.com/p/macvim/ MacVim], a graphical Vim version
  +
* [https://github.com/textmate/textmate Textmate 2], open source incarnation of TextMate 1.
 
* [http://www.vim.org/ Vim], is installed on every Mac
 
* [http://www.vim.org/ Vim], is installed on every Mac
 
* [http://haskell.org/haskellwiki/Yi Yi] (written in Haskell itself!), is available through cabal-install
 
* [http://haskell.org/haskellwiki/Yi Yi] (written in Haskell itself!), is available through cabal-install
Line 54: Line 77:
 
[[Image:TextMate.png]]
 
[[Image:TextMate.png]]
   
and [http://tuppis.com/smultron/ Smultron]:
+
[http://tuppis.com/smultron/ Smultron]:
   
 
[[Image:Smultron.png]]
 
[[Image:Smultron.png]]
  +
  +
and [http://www.sublimetext.com/ Sublime Text 2]:
  +
[[Image:SubilmeText2.png]]
   
 
TextEdit is Mac's default text editor, a very basic editor that works fine for most uses, you must however be careful to put it into plain text mode using the Format menu.
 
TextEdit is Mac's default text editor, a very basic editor that works fine for most uses, you must however be careful to put it into plain text mode using the Format menu.
Line 64: Line 90:
 
* [http://hackage.haskell.org/cgi-bin/hackage-scripts/package/mkbndl mkbndl] builds installable Mac OSX applications from your Haskell project.
 
* [http://hackage.haskell.org/cgi-bin/hackage-scripts/package/mkbndl mkbndl] builds installable Mac OSX applications from your Haskell project.
   
  +
== Links ==
  +
* [[Using Haskell in an Xcode Cocoa project]]; a description of how to add a Haskell module (callable from C) to an Xcode/Cocoa/Interface builder project on your Mac.
  +
* [[Mac OS X Common Installation Paths]]: an effort to standardize where things go on a Mac OS X installation
 
[[Category:OS]]
 
[[Category:OS]]

Latest revision as of 20:45, 8 November 2013

There is also now the Mac OS X Strike Force that aims to improve using Haskell on OS X.

Contents

[edit] 1 The Haskell Platform

There are Mac OS X installers of the full Haskell Platform development environment. We recommend it:

button-100.png

[edit] 2 GHC

[edit] 2.1 Important notes

To get the most out of your GHC environment, you should add '~/Library/Haskell/bin' to your PATH environment variable before the path where you have GHC installed. This will allow you to get and use cabal-updates, as well as other programs shipped with GHC like hsc2hs.

In your ~/.profile, add the line:

export PATH=$HOME/Library/Haskell/bin:$PATH

[edit] 2.2 Mac OS X 10.9 (Mavericks), Mac OS X 10.8 (Mountain Lion) and Xcode 5

Both Mountain Lion and Mavericks support and now use XCode 5, which no longer provides GCC, only Clang.

This should not be problem for GHC 7.8 and newer, but
If using GHC 7.6.*  or older, one of several work arounds is needed!

The workaround that the Haskell Platform maintainers are supporting can be found here. That work around along with this one work with only the system provided compilers.

However, if you are still encountering usual bugs, the GCC based directions here may work out better.

[edit] 2.3 Mac OS X 10.5 (Leopard)

To install GHC on Mac OS X 10.5 (Leopard), there are the following options:

[edit] 2.4 Mac OS X 10.6 (Snow Leopard) and 10.7 (Lion)

To uninstall ghc call: sudo uninstall-hs

[edit] 2.5 Xcode 4.1

GHC needs Xcode to be installed so it has access to the bintools, headers, and link libraries of the platform. The later two are provided by the SDK that comes as part of Xcode. GHC 7.0.2 is compiled against the 10.5 SDK. Xcode 4.1 no longer ships with it. ghci will work, but linking and some compiles with <ghc> will not. To make those work you need a copy of the 10.5 SDK. You can get this one several ways:

  • Before you install Xcode 4.1, if you have Xcode 3.2 installed, do one of the following:
    • Move it aside (renaming /Developer to /Xcode3.2)
    • Move just the sdk aside (moving /Developer/SDKs/MacOSX10.5.sdk to, say, /ExtraSDKs/MacOSX10.5.sdk)
    • Move just the sdk aside, install Xcode 4.1, then move it back into the /Developer/SDKs directory.
  • If you don't have Xcode 3.2, then you can download it from the Apple Developer site, and install it in a location other than "/Developer". If you have already installed Xcode 4.1 be sure that you customized the install and don't install the "System Tools" or "UNIX Development" packages.

Building via GHC:

ghc --make -I{loc}/MacOSX10.5.sdk/usr/include/ -L{loc}/MacOSX10.5.sdk/usr/lib

Building via cabal:

cabal --extra-include-dirs={loc}/MacOSX10.5.sdk/usr/include/ --extra-lib-dirs={loc}/MacOSX10.5.sdk/usr/lib

Replace {loc} with wherever you put the SDK.

[edit] 3 HUGS


[edit] 4 Installing libraries with external C bindings

Haskell libraries are installed with the cabal command line tool.

Some libraries depend on external C libraries, which are best installed with MacPorts. However, you have to tell cabal to include the /opt/local/ directories when searching for external libraries. The following shell script does that by wrapping the cabal utility

   > cat cabal-macports
   #!/bin/bash
   export CPPFLAGS=-I/opt/local/include
   export LDFLAGS=-L/opt/local/lib
   cabal $@ --extra-include-dirs=/opt/local/include \
            --extra-lib-dirs=/opt/local/lib
   > cabal-macports install foobar

[edit] 5 Editors with Haskell support

[edit] 5.1 Open Source

[edit] 5.2 Commercial

SubEthaEdit:

SubEthaEdit.png

TextMate:

TextMate.png

Smultron:

Smultron.png

and Sublime Text 2: SubilmeText2.png

TextEdit is Mac's default text editor, a very basic editor that works fine for most uses, you must however be careful to put it into plain text mode using the Format menu.

[edit] 6 Shipping Installable Haskell Applications

  • mkbndl builds installable Mac OSX applications from your Haskell project.

[edit] 7 Links