[[Property:modification_date|Thu, 28 Sep 2023 19:28:36 GMT]]
[[Property:publication_date|Sat, 11 Dec 2021 21:57:25 GMT]]
[[Property:title|Mac OS X]]
[[Property:weight|5]]
[[Property:uuid|7cf4e0e5-0858-58bb-351e-52becea59ede]]
==Requirements==

{| class="doctable"
|- 
| '''Computer/Processor'''
| x86-64 or ARM
|- 
| '''Operating System'''
| Mac OS X 10.12 or above
|- 
| '''C compiler'''
| Xcode 8.2 or greater
|- 
| '''Memory'''
| 4GB of RAM
|- 
| '''Hard Disk'''
| 1GB of free space
|- 
| '''ISE_PLATFORM'''
| '''macosx-x86''' for x86 based CPU,  '''macosx-x86-64''' for x64 based CPU and '''macosx-armv6''' for ARM based CPU. 
|}


==Prerequisites==

*You will need to install '''Xcode''' from the App Store.After installing Xcode, make sure to install the command line tools by going to the Xcode preferences and under '''Downloads''' install the '''Command Line Tools''' components.

*You also need to install X11 from  [http://xquartz.macosforge.org http://xquartz.macosforge.org].

==Installing required dependencies of EiffeStudio==

MacPorts is a tool that allows you to use many Unix applications on the Mac. Before we can proceed with the installation of EiffelStudio, we need to install the required dependencies of EiffeStudio. First, install [http://guide.macports.org/#installing MacPorts].

Now simply type (from a bash [http://guides.macrumors.com/Terminal terminal]):
<pre>
sudo port install pkgconfig
sudo port install bzip2
sudo port install xorg-libXtst
sudo port install gtk3                              

</pre>

New required dependency for GTK3
<pre>
sudo port install adwaita-icon-theme
</pre>

==Installing EiffelStudio from a compressed package==
This section only applies if you have installed all the required prerequisites. 

After downloading the compressed package, you should manually extract its contents to your hard drive. For example, you can extract it into /usr/local using the following commands (assuming that you have permission to /usr/local and that the installation package was saved in /tmp/Eiffel_X.Y.tar.bz2, where X.Y stands for the EiffelStudio version):
<code>
cd /usr/local
tar xvfj /tmp/Eiffel_X.Y.tar.bz2</code>

This will install EiffelStudio files into `/usr/local/Eiffel_X.Y` . Once this is done, jump to the [[#Setting up EiffelStudio|Setting up EiffelStudio]]  section in order to complete the installation of EiffelStudio.

==  Setting up EiffelStudio ==
Once the files have been installed, you should define the following environment variables in order to run EiffelStudio:
* ISE_EIFFEL to `/usr/local/Eiffel_X.Y`
* ISE_PLATFORM to `macosx-x86` for the 32 bits version or `macosx-x86-64` for the 64 bits version or `macosx-armv6` for the ARM version. We will be using `macosx-x86-64` in the examples below.
and add `$ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin` to your PATH environment variable.

Using sh or bash as a shell, it suffices to type the following commands:
```shell
export ISE_EIFFEL=/usr/local/Eiffel_X.Y
export ISE_PLATFORM=macosx-x86-64
export PATH=$PATH:$ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin
```

=== Persisting Environment Variables ===
Set them up in the .bash_profile file  once for good, so you don't need to set them up each time.
```
1. Open the profile file into a text editor
2. Add the export command for every environment variable
3. Save your changes.
```
To immediately apply all changes to .bash_profile, use the source command. 
```
source ~/.bash_profile
```
== Starting EiffelStudio ==

Now everything should be properly installed and you should be able to run the compiler. Simply navigate to `/usr/local/Eiffel_X.Y` 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'''.

If you are a new user to EiffelStudio, we recommend that you follow [[Introducing EiffelStudio|the EiffelStudio guided tour]].

== Known issues ==
* Please read carefully [https://www.eiffel.org/doc/eiffelstudio/Release_notes_for_EiffelStudio_22.12_-_macosx The 22.12 release notes] if you use EiffelStudio on M1 or M2.