RKWard on Mac

Revision as of 13:14, 19 July 2010

Status

To date we are not aware of successful attempts to install RKWard on Mac OS X. Unfortunately, none of the main contributors has a Mac available, so we cannot figure out a complete step-by-step guide without your help. If you would like to give this a try, please do! You are likely to run into a problem, here or there, but we are very much willing to talk you through those, and we are confident that RKWard on Mac is just a few steps away.

Please take the outline below as a rough guide of the required steps. If one of the steps is unclear, or simply does not work, let us know, and we will find a solution.

Pre-Requirements

1. You need an existing installation of R (2.7.0 or higher). http://www.r-project.org/ has binaries for MacOS, and you will likely use the latest available binary installer.
2. For KDE4, follow this procedure (taken from http://mac.kde.org):
   1. Install Fink: http://www.finkproject.org/download/index.php
   2. Open a Terminal
   3. Enable the "unstable" distribution:

      fink configure

   4. Update Fink:

      fink selfupdate      # This will take a while to complete

   5. Finally, install kdelibs and some needed packages. Currently it is important to use the X11 versions, RKWard will not work with the native versions, yet:

   fink install kdebase4-x11        # This will take a long time to complete
   fink install svn                 # if you do not have svn, already

Notes:

• Fink also provides an R package, but this seems to be very old, thus it is recommended to install the official binary from http://www.r-project.org, as detailed above. After installation, you should have a console version of R at /usr/bin/R .

Building RKWard

Next fetch the latest SVN sources:

 svn co http://rkward.svn.sourceforge.net/svnroot/rkward/trunk rkward_trunk

The remainder of the process should work as detailed at Building RKWard From Source. These commands will hopefully do the trick:

 cd rkward_trunk/rkward;  # the directory with the svn checkout
 mkdir build; cd build
 . /sw/sbin/kde4-buildenv.sh    # this sets some environment variables needed for building; we assume your fink base is "/sw".
 cmake .. -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix`
 make
 sudo make install

This should be all!

Running RKWard

For some reason fink places the KDE binaries in a rather hidden place, which is not in the path by default. If you have done everything as described above, rkward will be at

 /sw/opt/kde4/x11/bin/rkward

Troubleshooting

Again: Some detail or other of the above instructions is probably just wrong. If / when you get an error, please don't give up. Send us a mail, and we will talk you through.

BTW: If you figured out the remaining details all by yourself: Great! But please drop us a note as well, so we can provide more accurate instructions in the future.