docs/wiki/geda-devmacosx.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   2  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   3 <html>
   4 <head>
   5   <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
   6   <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
   7   <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
   8
   9   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  10 </head>
  11 <body>
  12
  13 <p>
  14 <em>Translations of this page are also available in the following languages:</em> <a href="geda-devmacosx.ru.html" class="wikilink1" title="geda-devmacosx.ru.html">Русский</a>.
  15 </p>
  16
  17 <p>
  18 See also: Building the pcb package on OS X by Jon Schneider
  19 </p>
  20
  21 <h2 id="gedaonthemac">gEDA On The Mac</h2>
  22 <div class="level2">
  23
  24 <p>
  25 There are a number of options with running gEDA on the mac.  You can install via the fink or macports package management or build from the source or some combination of the two.  Both fink and macports will install software in a directory off the root or &quot;sandbox&quot; (fink /sw and macports /opt) so they don&#039;t co-mingle software with your native mac software.  You can read more about the pros and cons of each online.
  26 </p>
  27
  28 <p>
  29 I have both fink and macports package managers installed and have been using macports lately.  I added some code to my .bash_profile that lets me choose what package manager I want to use on shell startup by setting my path variable.  I&#039;ve pasted it below.
  30 </p>
  31
  32 <p>
  33 Personally, I use macports to install dependencies and build and install geda from the source.  This makes it easy for me to grab the latest code from the git repository.
  34 </p>
  35 <pre class="code">PS3=&quot;Which port?:&quot;
  36 echo &quot;Choose from the list below.&quot;
  37 select NAME in macports fink mac
  38 do
  39         break
  40 done
  41 echo &quot;Setting path to prefer $NAME.&quot;
  42 case $NAME in
  43 macports) export PATH=/opt/local/bin:${PATH} PS1=&quot;opt-\A-[\w]\$&quot; ;;
  44 fink) test -r /sw/bin/init.sh &amp;&amp; . /sw/bin/init.sh PS1=&quot;sw-\A-[\w\\$&quot; ;;
  45 *) PS1=&quot;osx-\A-[\w]\$&quot; ;;
  46 esac
  47
  48 echo &quot;Path set to &quot; $PATH</pre>
  49
  50 </div>
  51
  52 <h2 id="gedaviafink">gEDA via Fink</h2>
  53 <div class="level2">
  54
  55 <p>
  56 You can link to instructions on installing gEDA via fink from the gEDA download page or go directly to http://www.ghz.cc/charles/fink/.  Using fink, gEDA can be installed from binaries or compiled from a recent development snapshot, if the fink unstable branch is enabled.   (Please see the Fink documentation on how to enable the unstable branch.)
  57 </p>
  58
  59 <p>
  60 Once Fink is installed, gEDA (and other programs) can be installed from the command line or through a graphical tool called fink commander.
  61 From the command line, the principal gEDA suite programs can be installed with the command:
  62 </p>
  63 <pre class="code">fink install geda-bundle</pre>
  64
  65 </div>
  66
  67 <h2 id="gedaviamacports">gEDA via macports</h2>
  68 <div class="level2">
  69
  70 <p>
  71 I am in the process of putting together a macports release of gEDA.  You can download macports from http://www.macports.org/.  I use macports with the GUI Porticus.  You can download that from here http://porticus.alittledrop.com/.
  72 </p>
  73
  74 <p>
  75 Until the macports release is ready, you can use Porticus (or macports command line) to install these dependent projects, then download and compile the source from the gEDA download page.
  76 </p>
  77 <ul>
  78 <li class="level1"><div class="li"> gettext</div>
  79 </li>
  80 <li class="level1"><div class="li"> guile</div>
  81 </li>
  82 <li class="level1"><div class="li"> gtk2</div>
  83 </li>
  84 <li class="level1"><div class="li"> groff</div>
  85 </li>
  86 </ul>
  87
  88 <p>
  89 I&#039;ve also installed python25 and python_select.  python_select let&#039;s you choose what version of python your mac will run as the default python.
  90 </p>
  91
  92 <p>
  93 As described here: <a href="geda-gaf_building_git_version.html#macports" class="wikilink1" title="geda-gaf_building_git_version.html">Building gEDA/gaf</a>, to run the software, you need to set an environment variable to allow Guile to load its shared libraries:
  94 </p>
  95 <pre class="code">$ export LTDL_LIBRARY_PATH=/opt/local/lib</pre>
  96
  97 </div>
  98
  99 <h2 id="buildingtheproject">Building The Project</h2>
 100 <div class="level2">
 101
 102 <p>
 103 Once you have the dependencies installed (either via fink or macports) just follow the instructions in the developer section for building and installing.  I had no issues (there was an issue with strnlen function being used in gschem, which isn&#039;t part of the standard gcc libraries, but once that was fixed I was able to build and run with no problems). I have also setup an XCode project to debug gEDA code in.  I will post that up to the site as soon as it&#039;s ready.
 104 </p>
 105
 106 </div>
 107
 108 <h2 id="workingwithpython">Working With Python</h2>
 109 <div class="level2">
 110
 111 <p>
 112 Currently I am working with myEclipse and the PyDev python plugin.  You can download Eclipse http://www.eclipse.org/ or myEclipse http://www.eclipse.org/ which is Eclipse bundled with plugins and currently costs $31.75 per year for a subscription.  You can download PyDev here http://pydev.sourceforge.net/.  It seems to have an annoying popup unless you buy a license, but other than that it seems to work well in Eclipse for working with python code.
 113 </p>
 114
 115 </div>
 116
 117 <h2 id="currentmacissues">Current Mac Issues</h2>
 118 <div class="level2">
 119 <ul>
 120 <li class="level1"><div class="li"> gEDA Manager does not currently run because it needs pyinotify which is based on Linux kernel infrastructure.  If anyone knows a way to get gEDA Manager running on mac that is appreciated.  Otherwise I plan on looking at a cross platform way to modify gEDA Manager.</div>
 121 </li>
 122 </ul>
 123
 124 </div>
 125
 126 <h2 id="gedaviavirtualbox">gEDA via VirtualBox</h2>
 127 <div class="level2">
 128
 129 <p>
 130 An alternative method to run gEDA programs on the Mac is to install them under Linux in an virtualization environment. VirtualBox is a professional-grade x86 virtualization program  that is available under the GPL. After installing this program, you can download and install a linux distribution within that environment.  This method has the advantage of using precompiled linux-oriented binaries, and installatoin - even accounting for for downloading and installing the guest OS - can be <em>very fast</em> compared to compiling and building the gEDA suite in Fink.
 131 </p>
 132
 133 <p>
 134 The gEDA suite programs have been tested and appear to work properly under Ubuntu running within VirtualBox on the Mac.  After downloading and installing VirtualBox, download Ubuntu and launch its installer, following the VirtualBox instructions. Once Ubuntu is installed, you can install gEDA following (simplified, standard) procedures for installing gEDA under linux.  From the command line,
 135 </p>
 136 <pre class="code">sudo apt-get install geda</pre>
 137
 138 <p>
 139 This installs gschem , gnetlist, &amp; gattrib. Then, to install additional applications:
 140 </p>
 141 <pre class="code">sudo apt-get install geda-utils
 142 sudo apt-get install pcb-gtk
 143 sudo apt-get install gerbv
 144 sudo apt-get install geda-xgsch2pcb</pre>
 145
 146 </div>
 147 </body>
 148 </html>