Difference between revisions of "Mac OS X:Build from source:MacPorts"

From Gramps
Jump to: navigation, search
(30 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[Category:Documentation]][[Category:Developers/Packaging]]
+
{{languages}}
== Installing gramps for X11 using MacPorts ==
+
MacPorts is a package manager for Mac. It allows you to easily install and uninstall open-source software onto your Mac.
 +
==Installing Gramps using MacPorts==
  
Right now, I will just get the basic information down as to the troubles I ran into and how I fixed them. I will later put in more detailed instructions on using MacPorts and the rest.
+
Gramps version available from MacPorts is: {{version_MacPort}}
  
=== Starting ===
+
# Download and install the latest Xcode tools from https://developer.apple.com/xcode/
 +
# Download and install Macports from http://www.macports.org/install.php
 +
# Open Terminal.app from /Applications/Utilities and enter these commands:
 +
sudo port selfupdate
 +
sudo port install gramps
  
So, assuming you have MacPorts installed and updated, you might as well try:
+
If you are running a recent version of OS X (Snow Leopard, or later, at this point), much of the support software is pre-compiled and will install as quickly as it is downloaded.
<code>
 
sudo port install gramps</code>
 
Now, if you're like me and didn't have GNOME or anything like that installed, calling that command will attempt to go through all of the dependencies and install them all. This will take a while, and you might be at this installing gramps for a couple hours (there are a lot of dependencies)
 
  
What I did instead was run <code>
+
{{stub}}
port deps gramps</code>, which listed the major dependencies that gramps has. Then, I installed each separately. They are:
 
<code>
 
shared-mime-info
 
py-gnome
 
py-bsddb</code>
 
I installed them in the following order:
 
# shared-mime-info
 
# py-bsddb
 
# py-gnome (the tough one)
 
  
=== shared-mime-info ===
+
If you have been using Version 3 of Gramps and are not ready to upgrade, the last version available was 3.49.  You can install it with:
In order to successfully install this, I first had to run:<code>
 
sudo port install p5-xml-sax
 
sudo port install p5-xml-sax-expat</code>
 
After that, things installed smoothly
 
  
=== py-bsddb ===
+
sudo port install gramps3
This actually installed smoothly on my computer.
 
  
=== py-gnome ===
+
{{man warn|Note|That gramps3 and gramps4 are obsolete.}}
For now, I merely list the libraries and what I did to fix the problem.
 
# py-gtk2
 
#* I had to make sure to upgrade expat. After that, it installed fine.
 
#* ''I had a real difficulty getting this to fully install. It kept choking on Cairo. After updating XTools to 2.5, Cairo installed without a problem.'' --[[User:A.southern.yankee|A.southern.yankee]] 23:46, 1 May 2008 (EDT)
 
# py-orbit
 
#* This installed without any problems for me.
 
# libzvt
 
#* This package needs "dbus" which in turn needs "xmlto". It appears, however, that "xmlto" is not listed as a dependent of "dbus". Hence, I ran <code>sudo port install xmlto</code> by hand. This installed without any problems on my computer.
 
#* After installing that, and upgrading gtk2 (do this first), this seems to be installing correctly.
 
# gnome-desktop
 
#* This was the next problem for me. I installed ''p5-libxml-perl, p5-xml-simple, py-xml'' by hand, cleaned ''gnome-desktop'', and then tried the installation again. Worked fine!
 
# gstreamer
 
#* This was the next problem for me. I installed ''p5-xml-libxslt, py-libxslt by hand'', cleaned gstreamer, and then tried the installation again. Worked fine!
 
#liboil
 
#* First, I ran <code>sudo port upgrade gtk-doc</code>
 
#* Then, I installed the newest version of the liboil library from [http://liboil.freedesktop.org/download/] and then tried to make the liboil library again. (From the manual download). This worked. I would assume it would work for the port version as well.
 
# nautilus
 
#* This was the last problem for me. To get around the error, I had to create a soft link for the ''libintl.3.dylib'' file in my /opt/local/lib/ directory.
 
  
=== Conclusion ===
+
==Running Gramps==
Those errors were the ones I ran into. I was able to get gramps to work after that, with some of the same glitches as described below.
 
  
 +
Use Terminal to start gramps:
 +
gramps
  
 +
==Graphviz==
  
 +
You may wish to install Graphviz to handle some of the graphical reports that Gramps can produce.  MacPorts can provide you with either graphical or command-line based versions of either a 'stable' or 'development' release of Graphviz.  'graphviz-gui' is recommended unless you know that you have a need for the development version.  Install with:
  
== Glitches ==
+
sudo port install graphviz-gui
  
There are some problems.
+
==Issues==
  
* Help does not work (clicking Help or FAQ etc on the Help menu does nothing).
+
You can search the MacPorts bug tracker for any issues related to the Gramps port:
* 'Enter' or 'return' does not act as OK for closing windows (the button has to be pressed with the mouse). However Esc does work to exit from the window.
 
* The browser and email links under the help menu do nothing.
 
* It is not possible to start Gramps by double clicking on a Mac OS icon, nor by double clicking on a Gramps database that is associated with the application. (It should be possible to create an installation that allows this, just as it is available for OpenOffice).
 
* The PdfDoc.py plugin cannot be installed because ReportLab is not installed.
 
** Note, using macports, run <code> sudo port install py-reportlab </code>. This will take care of this problem.
 
** For fink, run <code>fink install reportlab-py25</code> (py24 or py23, for earlier versions of python).
 
* The LPRDoc.py plugin cannot be loaded because the python bindings for GNOME print are not installed.
 
* Spell checking does not work (on starting Gramps, an error warning "Spelling checker is not installed" appears on the xterm). The python "bindings for [GNOME print and spell checking] are probably in fink's gnome-python2-desktop-py24 and gnome-python2-extras-py24 packages. Or would be, if fink had them at all, which we don't. They are only viable for for newer versions of gnome itself than fink presently has, or have other dependencies that are not yet satisfiable within fink. We're working on it".
 
* All ODF (ODT) output failed with a "Could not create file" error on an Gramps installed via Macports as described above, on a 'virgin' Mac. Benny Malengier forwarded the suggestion from guylinton that <code>zlib</code>  should be installed: with <code> sudo port install py25-zlib </code> all ODT output jumped into action.
 
  
==Starting Gramps using X11==
+
https://trac.macports.org/search?portsummarysearch=on
Once you have successfully installed gramps using MacPorts, you will need to make a note of where the executable is. You can do this in your terminal, by typing "which gramps" (no quotes, of course). You should make a note of this and then start X11 from the Applications folder (in my case from within the Utilities folder). Once you have an X terminal you can type the command, in my case "/opt/local/bin/gramps". If /opt/local/bin is in the PATH for X11, then you should just be able to type "gramps".
+
 
 +
Please don't hesitate to create a ticket if you find a problem that you believe is related to the MacPorts build process.
 +
 
 +
 
 +
[[Category:Developers/Packaging]]

Revision as of 07:51, 9 February 2019

MacPorts is a package manager for Mac. It allows you to easily install and uninstall open-source software onto your Mac.

Installing Gramps using MacPorts

Gramps version available from MacPorts is: 5.1.6

  1. Download and install the latest Xcode tools from https://developer.apple.com/xcode/
  2. Download and install Macports from http://www.macports.org/install.php
  3. Open Terminal.app from /Applications/Utilities and enter these commands:
sudo port selfupdate
sudo port install gramps

If you are running a recent version of OS X (Snow Leopard, or later, at this point), much of the support software is pre-compiled and will install as quickly as it is downloaded.

Gramps-notes.png

This article's content is incomplete or a placeholder stub.
Please update or expand this section.


If you have been using Version 3 of Gramps and are not ready to upgrade, the last version available was 3.49. You can install it with:

sudo port install gramps3
Gnome-important.png
Note

That gramps3 and gramps4 are obsolete.

Running Gramps

Use Terminal to start gramps:

gramps

Graphviz

You may wish to install Graphviz to handle some of the graphical reports that Gramps can produce. MacPorts can provide you with either graphical or command-line based versions of either a 'stable' or 'development' release of Graphviz. 'graphviz-gui' is recommended unless you know that you have a need for the development version. Install with:

sudo port install graphviz-gui

Issues

You can search the MacPorts bug tracker for any issues related to the Gramps port:

https://trac.macports.org/search?portsummarysearch=on

Please don't hesitate to create a ticket if you find a problem that you believe is related to the MacPorts build process.