[[Category:EiffelStudio]]
[[Category:Macintosh]]

This page gives you an overview about how to get EiffelStudio running on your Mac.

== Installation ==

=== Using MacPorts ===
The officially supported versions of Mac OS X are 10.4 and 10.5.

MacPorts is a great 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 as described [http://trac.macosforge.org/projects/macports/wiki/InstallingMacPorts here].

Now simply type:
<pre>
sudo port install eiffelstudio64
</pre>
and you're ready to go (after a few hours compiling that is :)). Compiling on a new Intel Mac reportedly takes about an hour. An old 800 MHz PowerPC takes about seven hours.

A fairly recent development package is available under the name eiffelstudio65. (Both packages can be installed simultaneously)

The installer from the previous subsection is actually created using MacPorts as well using the mpkg command. For more information take a look at the [http://guide.macports.org MacPorts Guide]

== Starting EiffelStudio ==

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'.

== Upgrading ==

When a new version of EiffelStudio is available, you can upgrade like so:
<pre>
sudo port selfupdate
sudo port upgrade eiffelstudio
</pre>

Be prepared for another long wait while it compiles. You can do likewise for eiffelstudio-devel, of course.

Beware that this may not get the latest release if [http://trac.macports.org/browser/trunk/dports/lang/eiffelstudio/Portfile the Port file] has not been updated yet. Even after it has been updated, it may take a week for it to propagate to MacPorts. If you can't wait, here's how to get the latest version immediately:
# Edit your local copy of the Portfile: '''sudo port edit eiffelstudio'''. Change '''minor_version''' and '''version'''. Save.
# Tell MacPorts to use the local copy of your Portfile: '''cd /opt/local/var/macports/sources/rsync.macports.org/release/ports''' (assuming this is where your ports are), then type '''portindex'''. It will print hundreds of "Adding port" messages, one of which should be lang/eiffelstudio.
# Find out the checksums for the new version: '''sudo port -d upgrade eiffelstudio'''.
# Edit your local Portfile again, substituting the checksums.
# Now '''sudo port upgrade eiffelstudio''' should upgrade to the version described in your local Portfile.

== FAQ ==
====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 a linking error with precompiles on PPC, 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 don't use precompiles on Macs.

{{Note|When you create a project, EiffelStudio will ask if you want to perform precompiles – say no. Then disable the precompiles for this project through the Project>Project menu. In the 'Groups>Precompile' section, remove all precompiles (eg., base_pre). Select the 'base_pre' precompile and click the red cross delete tool at the top of the window.}}

{{Note|Precompiling the Eiffel libraries after installing the Port is possible, there are security policies to take into account. The Port installs EiffelStudio under the system's ''/Application/MacPorts'' directory and '''not''' the user ''~/Application/MacPorts''. Due of this, EiffelStudio must be run as a super user and the precompiles build using the '''Tools''' > '''Precompile Wizard''' option. Alternatively, alter the base installation path when requesting to install the Port.}}

==Hints==
* Use Helvetica 12 as Editor font. If you prefer a smaller font, use Hei 10.
* 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...
[[Image:preferences_open_mac.jpg]]
* To run the '''ec''' compiler from your shell, set up variables similar to these (e.g. in ~/.profile):
<pre>
# Setting variables for EiffelStudio.
export ISE_EIFFEL=/Applications/MacPorts/Eiffel61
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
</pre>
* 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.

2009-08-21T14:14:20Z

Dfurrer: /* Overview */

[[Category:Projects]]
[[Category:EiffelVision2]]
[[Category:Macintosh]]

=Overview=
This project was created with the goal of running Eiffel Studio natively on the Mac and succeeds the previous Carbon based EiffelVision implementation.
=Screenshots=
[[Image:EiffelStudio-19-05-09.png|200px|thumb|left|EiffelStudio on 19.5.09]]
[[Image:EiffelStudio-3-07-09.png|200px|thumb|left|EiffelStudio on 3.7.09]]
[[Image:EiffelStudio-21-08-09.png|200px|thumb|left|EiffelStudio on 21.8.09]]

=Build instructions=
<ol>
<li> Get the latest EiffelStudio for the Mac. If you have MacPorts installed you can do this by typing
<pre>port install eiffelstudio65</pre></li>
<li> Check out the latest source code from the trunk
<pre>svn co https://svn.origo.ethz.ch/eiffelstudio/trunk</pre></li>
<li>Set your EIFFEL_SRC and ISE_LIBRARY to the directory
<pre>
export EIFFEL_SRC=/directory/to/your/checkout/trunk/Src
export EIFFEL_SRC=$ISE_LIBRARY
</pre>
</li>
<li>Locate EiffelStudio's config.sh file (probably /Applications/MacPorts/Eiffel65/studio/spec/macosx-x86/include/config.sh) and add the flag -ObjC to the definition of the ccflags, like this:
<pre>
ccflags='-ObjC -pipe -no-cpp-precomp -fno-common -fPIC'
</pre>
</li>
<li>Compile the C-parts of the library
<pre>
cd $ISE_LIBRARY/experimental/library/objc_base/Clib
finish_freezing -library
cd $ISE_LIBRARY/experimental/library/cocoa/Clib
finish_freezing -library
</pre>
</li>
<li>Now open the .ecf file of your project and add the following line to your target:
<pre>
<variable name="vision_implementation" value="cocoa"/>
</pre>
alternatively you can add another target which will allow you to easily compile both, a GTK+ and a Cocoa version of your application:
<pre>
<target name="cocoa" extends="classic">
<variable name="vision_implementation" value="cocoa"/>
</target>
</pre>
If you want to compile Eiffel Studio there is already a target called "bench_cocoa" which you can select.
</li>
<li>Use ec -experiment (or estudio -experiment) to compile</li>
</ol>

= FAQ =
==Problem==
C compilation yields syntax errors:
<pre>
Compiling C code in C190
In file included from /System/Library/Frameworks/Foundation.framework/Headers/Foundation.h:12,
from /System/Library/Frameworks/Cocoa.framework/Headers/Cocoa.h:12,
from ns6299.c:27,
from big_file_C191_c.c:54:
/System/Library/Frameworks/Foundation.framework/Headers/NSObjCRuntime.h:124: error: stray '@' in program
/System/Library/Frameworks/Foundation.framework/Headers/NSObjCRuntime.h:124: error: syntax error before 'NSString'
/System/Library/Frameworks/Foundation.framework/Headers/NSObjCRuntime.h:126: error: syntax error before '*' token
/System/Library/Frameworks/Foundation.framework/Headers/NSObjCRuntime.h:127: error: syntax error before '*' token
/System/Library/Frameworks/Foundation.framework/Headers/NSObjCRuntime.h:129: error: syntax error before '*' token
/System/Library/Frameworks/Foundation.framework/Headers/NSObjCRuntime.h:130: error: syntax error before '*' token
/System/Library/Frameworks/Foundation.framework/Headers/NSObjCRuntime.h:132: error: syntax error before '*' token
/System/Library/Frameworks/Foundation.framework/Headers/NSObjCRuntime.h:132: error: syntax error before '*' token
/System/Library/Frameworks/Foundation.framework/Headers/NSObjCRuntime.h:133: error: syntax error before '*' token
/System/Library/Frameworks/Foundation.framework/Headers/NSObjCRuntime.h:133: error: syntax error before '*' token
/System/Library/Frameworks/Foundation.framework/Headers/NSObjCRuntime.h:137: error: syntax error before '*' token
/System/Library/Frameworks/Foundation.framework/Headers/NSObjCRuntime.h:138: error: syntax error before '*' token
In file included from /System/Library/Frameworks/Foundation.framework/Headers/NSObject.h:6,
from /System/Library/Frameworks/Foundation.framework/Headers/NSAffineTransform.h:5,
from /System/Library/Frameworks/Foundation.framework/Headers/Foundation.h:13,
from /System/Library/Frameworks/Cocoa.framework/Headers/Cocoa.h:12,
from ns6299.c:27,
from big_file_C191_c.c:54:
/System/Library/Frameworks/Foundation.framework/Headers/NSZone.h:8: error: stray '@' in program
</pre>

==Solution==
Make sure your config.sh was changed to allow compiling Objective-C (see step 4 above).
==Problem==
C compilation yields an linker error (symbols not found):
Compiling C code in C1
Compiling C code in E1
Undefined symbols:
"_bridge_void_general", referenced from:
_bridge_void_general$non_lazy_ptr in Cobj160.o
"_bridge_void_ptr_ptr", referenced from:
_bridge_void_ptr_ptr$non_lazy_ptr in Cobj160.o
ld: symbol(s) not found
collect2: ld returned 1 exit status
make: *** [ec] Error 1
==Solution==
Make sure you compiled the C-parts of the libraries (see step 5 above).

= Contact =

If you run into any problems or have any other feedback I'll be happy to hear from you.

* [[User:Dfurrer|Dfurrer]]

File:EiffelStudio-21-08-09.png

2009-08-21T14:11:21Z

Dfurrer:

File:EiffelStudio-19-05-09.png

2009-08-21T14:06:57Z

Dfurrer:

File:EiffelStudio-3-07-09.png

2009-08-21T14:06:44Z

Dfurrer:

2009-08-20T12:20:26Z

Dfurrer: /* Contact */

[[Category:Projects]]
[[Category:EiffelVision2]]
[[Category:Macintosh]]

=Overview=
This project was created with the goal of running Eiffel Studio natively on the Mac and succeeds the previous Carbon based vision implementation.

=Build instructions=
* Get the latest EiffelStudio for the Mac. If you have MacPorts installed you can do this by typing
port install eiffelstudio65
* Check out the latest source code from the trunk
svn co https://svn.origo.ethz.ch/eiffelstudio/trunk
* Set your EIFFEL_SRC and ISE_LIBRARY to the directory
export EIFFEL_SRC=/directory/to/your/checkout/trunk/Src
export EIFFEL_SRC=$ISE_LIBRARY
* Locate EiffelStudio's config.sh file (probably /Applications/MacPorts/Eiffel65/studio/spec/macosx-x86/include/config.sh) and add the flag -ObjC to the definition of the ccflags, like this:
ccflags='-ObjC -pipe -no-cpp-precomp -fno-common -fPIC'
* Now open the .ecf file of your project and add the following line to your target:
<variable name="vision_implementation" value="cocoa"/>
alternatively you can add another target which will allow you to easily compile both, a GTK+ and a Cocoa version of your application:
<target name="cocoa" extends="classic">
<variable name="vision_implementation" value="cocoa"/>
</target>
If you want to compile Eiffel Studio there is already a target called "bench_cocoa" which you can select.

= Contact =

If you run into any problems or have any other feedback I'll be happy to hear from you.

* [[User:Dfurrer|Dfurrer]]