Difference between revisions of "EiffelOnMac"
(Add warning about Vision2 not compiling on the Mac in EiffelStudio 7.1)
(Clarify the requirements for installing Xcode)
|Line 6:||Line 6:|
*You will need to install '''
*You will need to install '''''' from the App Store. (On old of OS X, was on your OSX-Installation disk, or you downloaded it from Apple's developer web site.)
Make sure that you install the development toolswith Xcode. You
don't need to install '''X11'''. , install it from your OSX-Installation disk.
== Installation ==
== Installation ==
Revision as of 20:47, 18 September 2012
This page gives you an overview about how to get EiffelStudio running on your Mac (Leopard, Snow Leopard or Lion).
- 1 Requirements
- 2 Installation
- 3 Starting EiffelStudio
- 4 FAQ
- 4.1 I get a crash with a Permission denied: Operating system error, how do I fix it?
- 4.2 I get an error with precompiles, why is that ?
- 4.3 How can I make EiffelStudio on the Mac look nicer?
- 4.4 Typing ec or estudio on the command line doesn't work
- 4.5 The latest release of EiffelStudio isn't available yet via MacPorts
- 5 Hints
- You will need to install Xcode from the App Store. (On old versions of OS X, Xcode was on your OSX-Installation disk, or you downloaded it from Apple's developer web site.)
- Make sure that you install the development tools with Xcode. (In theory, with current versions of the development tools, you may not need to install Xcode. You could save yourself a huge amount of time by not downloading Xcode; but on the other hand, you might waste a lot of time trying to fix missing dependencies if things go wrong. Unless you're feeling adventurous, do install Xcode.)
- On OS X 10.5 and later, you don't need to install X11. (On older versions of OS X, install it from your OSX-Installation disk.)
The following should work on Mac OS X 10.4 and later.
MacPorts is a tool that allows you to use many Unix applications on the Mac. We have created a package in the MacPorts repository that allows you to to install Eiffel Studio with all dependencies in a convenient way. First, install MacPorts.
Now simply type (from a bash terminal):
sudo port install eiffelstudioXX
where 'XX' stands for the EiffelStudio version you want to install (for example eiffelstudio71) and after some time (compiling on a 2.4 GHz Intel Mac takes about an hour) you're ready to go.
Older development packages are available under the name eiffelstudio65, etc. All packages can be installed simultaneously because they are located in different directories.
When a new release of the same version EiffelStudio becomes available, you can upgrade like so:
sudo port selfupdate sudo port upgrade outdated
<custom name="vision_implementation" excluded_value="gtk34"/>
sudo port deactivate gtk2 @2_24_5_0+x11 sudo port activate gtk2 @2_24_4_0+x11
Using binary packages
This installer was created using MacPorts as well as using the mpkg command. For more information take a look at the MacPorts Guide
Simply navigate to /Applications/MacPorts/Eiffel<nn> and double click the EiffelStudio icon.
Alternatively, you can also start EiffelStudio from the command line by entering the command 'estudio' or use the command-line eiffel compiler 'ec'.
I get a crash with a Permission denied: Operating system error, how do I fix it?
Delete the .ec directory in your home directory.
I get an error with precompiles, why is that ?
Precompiles did not work on the Mac before EiffelStudio 6.4 due to a limitation of the linker. To work around this issue you have to disable the precompiles with those versions or upgrade to a recent version of EiffelStudio.
How can I make EiffelStudio on the Mac look nicer?
- From macports, install the gtk2 (if not already installed) and gtk-chtheme packets. Then run gtk-chtheme and you get a nice GUI to choose your theme. Additional GTK themes can be put in /opt/local/share/themes/ (There a thousands of them on the web, for example here : http://art.gnome.org/themes/gtk2)
Typing ec or estudio on the command line doesn't work
To run the ec compiler from your shell, set up variables similar to these (e.g. in ~/.profile):
# Setting variables for EiffelStudio. export ISE_EIFFEL=/Applications/MacPorts/Eiffel66 export ISE_PLATFORM=macosx-ppc (or macosx-x86) export ISE_PROJECTS=$HOME export ES_PATH=$ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin export PATH=$ES_PATH:$PATH
The latest release of EiffelStudio isn't available yet via MacPorts
MacPorts installs a particular version of EiffelStudio by following the rules defined in a Portfile. For example, http://trac.macports.org/browser/trunk/dports/lang/eiffelstudio68/Portfile is the Portfile for EiffelStudio 6.8. Someone has to write this file and upload it, but they might not have done so yet. You could make enquiries about when it will be available, but if you want to get the latest urgently it isn't hard to write your own Portfile and run it locally. Here's how.
http://guide.macports.org/#development.local-repositories explains how to do it.
- Go to https://sourceforge.net/projects/eiffelstudio/files and download the relevant PorterPackage file.
- Run openssl to find out the checksum of the PorterPackage file. E.g., for EiffelStudio 7.1 the command is openssl rmd160 ~/Downloads/PorterPackage_88986_gpl.tar.
- Open /opt/local/etc/macports/sources.conf in a text editor (with super user privileges). Insert a line as explained on http://guide.macports.org, e.g., file:///Applications/MacPorts/ports
- Create the Portfile in a text editor, e.g., file:///Applications/MacPorts/ports/lang/eiffelstudio71/Portfile
- Copy the contents of the most recently available EiffelStudio Portfile (e.g., from http://trac.macports.org/browser/trunk/dports/lang/eiffelstudio68/Portfile) into your Portfile.
- Correct the name, minor_version and version.
- Make sure that the distname will resolve to the current PorterPackage file name that you see on https://sourceforge.net/projects/eiffelstudio/files
- Set the first checksums to the value that you got earlier from running openssl.
- You've finished writing your Portfile. Save it!
- Go to the ports directory, e.g., cd /Applications/MacPorts/ports
- sudo portindex
- You should now be able to install in the usual way, e.g., sudo port install eiffelstudio71
- Pick and Drop works with Apple-key + mouse click.
- To set up the correct (default) browsers use "open" as your command-line browser in Tools>Preferences...
- The F10 and F11 debugging shortcuts conflict with the standard Exposé keys. Here are some workarounds:
- Use the toolbar instead.
- Reassign these shortcuts in EiffelStudio (Tools>Preferences).
- Reassign the Exposé keys in System Preferences.
- The version of X11 installed with Mac OS X Leopard 10.5.0 and 10.5.1 does not work. The 10.5.2 and later updates are probably ok, however, but if you're having problems have a look at http://trac.macosforge.org/projects/xquartz. For more details, see http://www.eiffelroom.com/blog/paulbates/a_little_help_for_mac_users which pre-dates the release of 10.5.2.