Difference between revisions of "MacOS Installation"
GlenWhitney (talk | contribs) (Quartz instructions moved to a separate page) |
GlenWhitney (talk | contribs) (Bump heading levels so top is ==, as recommende by "editing help" link; also clarify reference to top of the page) |
||
| Line 1: | Line 1: | ||
| − | = PPC Macs = | + | == PPC Macs == |
| − | == Using Fink == | + | === Using Fink === |
[http://fink.sourceforge.net/ Fink] is a package-management tool making it easier to install all your favorite *nix tools and libraries under OS X. It's also the quickest and easiest way to get at least some version of GnuCash running on a PowerPC Mac (Intel Mac users see [[#Intel_Macs|below]].) | [http://fink.sourceforge.net/ Fink] is a package-management tool making it easier to install all your favorite *nix tools and libraries under OS X. It's also the quickest and easiest way to get at least some version of GnuCash running on a PowerPC Mac (Intel Mac users see [[#Intel_Macs|below]].) | ||
| − | === gnucash-1.8 === | + | ==== gnucash-1.8 ==== |
Under Mac OS X 10.4 on a PowerPC Mac, gnucash-1.8 installation is as simple as: | Under Mac OS X 10.4 on a PowerPC Mac, gnucash-1.8 installation is as simple as: | ||
# download and install fink | # download and install fink | ||
| Line 11: | Line 11: | ||
# start up [http://www.apple.com/downloads/macosx/apple/x11formacosx.html X11] and run 'gnucash &' from an xterm | # start up [http://www.apple.com/downloads/macosx/apple/x11formacosx.html X11] and run 'gnucash &' from an xterm | ||
| − | === gnucash-2.0.x === | + | ==== gnucash-2.0.x ==== |
Installing a recent version of GnuCash-2.0 is slightly more complicated, since the Fink package for this is still being tested and is therefore in their 'unstable' tree. So in addition to the basic install of Fink you must [http://fink.sourceforge.net/faq/usage-fink.php?phpLang=en#unstable enable the unstable tree]. Note that the Fink package name for GnuCash-2.0.x is "gnucash2", and that this package is in the "crypto" category in Fink, rather than the "gnome" category as "gnucash" is. This categorization can make it tricky to see gnucash2 when browsing Fink packages. As of May 2007, the gnucash2 package was up-to-date with the latest 2.0.5 release. Note also that fink packages in 'unstable' need to be compiled from source, compared to most of the ones considered stable (ie gnucash 1.8). So, if you are short of time or downloading and compiling from source makes you uneasy (even though Fink automates this process rather reliably and safely), you might want to stick with 1.8 until 2.0 is available as a stable fink package. Other sections on this page describe ways of obtaining GnuCash versions 2.0 and higher, but note that they all involve, directly or indirectly, downloading and compiling source code. | Installing a recent version of GnuCash-2.0 is slightly more complicated, since the Fink package for this is still being tested and is therefore in their 'unstable' tree. So in addition to the basic install of Fink you must [http://fink.sourceforge.net/faq/usage-fink.php?phpLang=en#unstable enable the unstable tree]. Note that the Fink package name for GnuCash-2.0.x is "gnucash2", and that this package is in the "crypto" category in Fink, rather than the "gnome" category as "gnucash" is. This categorization can make it tricky to see gnucash2 when browsing Fink packages. As of May 2007, the gnucash2 package was up-to-date with the latest 2.0.5 release. Note also that fink packages in 'unstable' need to be compiled from source, compared to most of the ones considered stable (ie gnucash 1.8). So, if you are short of time or downloading and compiling from source makes you uneasy (even though Fink automates this process rather reliably and safely), you might want to stick with 1.8 until 2.0 is available as a stable fink package. Other sections on this page describe ways of obtaining GnuCash versions 2.0 and higher, but note that they all involve, directly or indirectly, downloading and compiling source code. | ||
| − | === Other Fink options === | + | ==== Other Fink options ==== |
Further discussion of semi-manual ways to compile GnuCash using Fink tools can be found [[MacOSX/FinkManual|here]]. Most of that information is generally outdated since the availability of the gnucash2 package. However, it may still be useful in some cases, for example if you would like to use Fink in conjunction with compiling a version of GnuCash newer than any available in a Fink package. | Further discussion of semi-manual ways to compile GnuCash using Fink tools can be found [[MacOSX/FinkManual|here]]. Most of that information is generally outdated since the availability of the gnucash2 package. However, it may still be useful in some cases, for example if you would like to use Fink in conjunction with compiling a version of GnuCash newer than any available in a Fink package. | ||
| − | == Using MacPorts == | + | === Using MacPorts === |
MacPorts (formerly known as DarwinPorts) is another, parallel package manager for Mac OS X. All of the options discussed below are covered in more detail in [[MacOSX/MacPortsDetail]]. | MacPorts (formerly known as DarwinPorts) is another, parallel package manager for Mac OS X. All of the options discussed below are covered in more detail in [[MacOSX/MacPortsDetail]]. | ||
| − | === gnucash-2.0.x === | + | ==== gnucash-2.0.x ==== |
The standard gnucash port in MacPorts was up-to-date with GnuCash-2.0.5 as of May 2007. Therefore, installing the latest stable version of GnuCash consists simply of: | The standard gnucash port in MacPorts was up-to-date with GnuCash-2.0.5 as of May 2007. Therefore, installing the latest stable version of GnuCash consists simply of: | ||
| Line 29: | Line 29: | ||
#Run <code>gnucash</code> from an XTerm. | #Run <code>gnucash</code> from an XTerm. | ||
| − | === Development version === | + | ==== Development version ==== |
To install a recent development version of GnuCash (2.1.1 as of May 2007), simply replace "gnucash" in the third step above with "gnucash-devel". | To install a recent development version of GnuCash (2.1.1 as of May 2007), simply replace "gnucash" in the third step above with "gnucash-devel". | ||
| − | === Even more bleeding edge === | + | ==== Even more bleeding edge ==== |
[[MacOSX/MacPortsDetail]] also includes instructions for compiling any GnuCash source distribution in the context of a MacPorts software installation. | [[MacOSX/MacPortsDetail]] also includes instructions for compiling any GnuCash source distribution in the context of a MacPorts software installation. | ||
| − | == Manual compilation (GnuCash 2.1.1 '''Quartz''') == | + | === Manual compilation (GnuCash 2.1.1 '''Quartz''') === |
It is possible to get GnuCash running | It is possible to get GnuCash running | ||
| Line 45: | Line 45: | ||
| − | = Intel Macs = | + | == Intel Macs == |
| − | == gnucash-1.8 == | + | === gnucash-1.8 === |
As of June, 2006, GnuCash-1.8 does '''not''' work on Intel-based Macs. Both 1.8.''x'' and 1.9.''x'' series installations have dependencies (such as libgnomecanvas [http://bugzilla.gnome.org/show_bug.cgi?id=339489 Gnome Bug #339489]) which are known not to function correctly in this environment. As the known issues reside in external libraries (i.e. not within the GnuCash source tree), we are hoping that they will be resolved by the maintainers of those libraries (or their fink ports). Please check the [https://lists.gnucash.org/search/ gnucash (-users and -devel)] and [http://news.gmane.org/gmane.os.apple.fink.general fink-users] mailing list archives for more history and updates. | As of June, 2006, GnuCash-1.8 does '''not''' work on Intel-based Macs. Both 1.8.''x'' and 1.9.''x'' series installations have dependencies (such as libgnomecanvas [http://bugzilla.gnome.org/show_bug.cgi?id=339489 Gnome Bug #339489]) which are known not to function correctly in this environment. As the known issues reside in external libraries (i.e. not within the GnuCash source tree), we are hoping that they will be resolved by the maintainers of those libraries (or their fink ports). Please check the [https://lists.gnucash.org/search/ gnucash (-users and -devel)] and [http://news.gmane.org/gmane.os.apple.fink.general fink-users] mailing list archives for more history and updates. | ||
| − | == gnucash-2.0 == | + | === gnucash-2.0 === |
| − | As of August 2006, Gnucash 2 works fine on many Intel Macs. Installation instructions for gnucash-2.0 on Intel Macs may be found [http://captnswing.net/2006/07/10/gnucash20_on_intel_macs.html here] (or | + | As of August 2006, Gnucash 2 works fine on many Intel Macs. Installation instructions for gnucash-2.0 on Intel Macs may be found [http://captnswing.net/2006/07/10/gnucash20_on_intel_macs.html here] (or presumably most or all of the Gnucash-2.x instructions above for PowerPC work on Intel Macs as well.) |
| − | = Final Words = | + | == Final Words == |
Currently, none of the primary GnuCash development occurs under OS X; as such, clear and specific bug reports (particularly of new issues not already reported) may be helpful. If you encounter problems, please check the mailing list archives first and then, if your problem cannot be resolved based on the information found there, report it to the mailing list. Please do remember that GnuCash developers are volunteers and are not responsible for your computer; as such, your help (in the form of exhausting readily available resources before asking for help and in [http://www.catb.org/~esr/faqs/smart-questions.html asking for help in a clear manner]) is appreciated. | Currently, none of the primary GnuCash development occurs under OS X; as such, clear and specific bug reports (particularly of new issues not already reported) may be helpful. If you encounter problems, please check the mailing list archives first and then, if your problem cannot be resolved based on the information found there, report it to the mailing list. Please do remember that GnuCash developers are volunteers and are not responsible for your computer; as such, your help (in the form of exhausting readily available resources before asking for help and in [http://www.catb.org/~esr/faqs/smart-questions.html asking for help in a clear manner]) is appreciated. | ||
Revision as of 06:09, 7 May 2007
Contents
PPC Macs
Using Fink
Fink is a package-management tool making it easier to install all your favorite *nix tools and libraries under OS X. It's also the quickest and easiest way to get at least some version of GnuCash running on a PowerPC Mac (Intel Mac users see below.)
gnucash-1.8
Under Mac OS X 10.4 on a PowerPC Mac, gnucash-1.8 installation is as simple as:
- download and install fink
- run 'sudo apt-get install gnucash'
- start up X11 and run 'gnucash &' from an xterm
gnucash-2.0.x
Installing a recent version of GnuCash-2.0 is slightly more complicated, since the Fink package for this is still being tested and is therefore in their 'unstable' tree. So in addition to the basic install of Fink you must enable the unstable tree. Note that the Fink package name for GnuCash-2.0.x is "gnucash2", and that this package is in the "crypto" category in Fink, rather than the "gnome" category as "gnucash" is. This categorization can make it tricky to see gnucash2 when browsing Fink packages. As of May 2007, the gnucash2 package was up-to-date with the latest 2.0.5 release. Note also that fink packages in 'unstable' need to be compiled from source, compared to most of the ones considered stable (ie gnucash 1.8). So, if you are short of time or downloading and compiling from source makes you uneasy (even though Fink automates this process rather reliably and safely), you might want to stick with 1.8 until 2.0 is available as a stable fink package. Other sections on this page describe ways of obtaining GnuCash versions 2.0 and higher, but note that they all involve, directly or indirectly, downloading and compiling source code.
Other Fink options
Further discussion of semi-manual ways to compile GnuCash using Fink tools can be found here. Most of that information is generally outdated since the availability of the gnucash2 package. However, it may still be useful in some cases, for example if you would like to use Fink in conjunction with compiling a version of GnuCash newer than any available in a Fink package.
Using MacPorts
MacPorts (formerly known as DarwinPorts) is another, parallel package manager for Mac OS X. All of the options discussed below are covered in more detail in MacOSX/MacPortsDetail.
gnucash-2.0.x
The standard gnucash port in MacPorts was up-to-date with GnuCash-2.0.5 as of May 2007. Therefore, installing the latest stable version of GnuCash consists simply of:
- Download and install MacPorts.
sudo port selfupdatesudo port install gnucash# Note this takes quite a while- Run
gnucashfrom an XTerm.
Development version
To install a recent development version of GnuCash (2.1.1 as of May 2007), simply replace "gnucash" in the third step above with "gnucash-devel".
Even more bleeding edge
MacOSX/MacPortsDetail also includes instructions for compiling any GnuCash source distribution in the context of a MacPorts software installation.
Manual compilation (GnuCash 2.1.1 Quartz)
It is possible to get GnuCash running completely without X Windows, thanks to recent work at the Gtk+ on Mac OS X project. It's not for the faint of heart, though, as it currently requires this laborious manual process. Hopefully the process will be automated (probably in MacPorts), at which point this option can be subsumed into an earlier section. Although there are several caveats (detailed along with the procedure), overall the usability, appearance, and convenience of the Quartz version have been decent.
Intel Macs
gnucash-1.8
As of June, 2006, GnuCash-1.8 does not work on Intel-based Macs. Both 1.8.x and 1.9.x series installations have dependencies (such as libgnomecanvas Gnome Bug #339489) which are known not to function correctly in this environment. As the known issues reside in external libraries (i.e. not within the GnuCash source tree), we are hoping that they will be resolved by the maintainers of those libraries (or their fink ports). Please check the gnucash (-users and -devel) and fink-users mailing list archives for more history and updates.
gnucash-2.0
As of August 2006, Gnucash 2 works fine on many Intel Macs. Installation instructions for gnucash-2.0 on Intel Macs may be found here (or presumably most or all of the Gnucash-2.x instructions above for PowerPC work on Intel Macs as well.)
Final Words
Currently, none of the primary GnuCash development occurs under OS X; as such, clear and specific bug reports (particularly of new issues not already reported) may be helpful. If you encounter problems, please check the mailing list archives first and then, if your problem cannot be resolved based on the information found there, report it to the mailing list. Please do remember that GnuCash developers are volunteers and are not responsible for your computer; as such, your help (in the form of exhausting readily available resources before asking for help and in asking for help in a clear manner) is appreciated.
