Skip to content

Commit

Permalink
[docs] Add FAQ question related to the failure of SARL Eclipse launch…
Browse files Browse the repository at this point in the history
… on MacOS X.

Thanks to ThomasFarrenkopf for the finding.

see #1022

Signed-off-by: Stéphane Galland <galland@arakhne.org>
  • Loading branch information
gallandarakhneorg committed Nov 30, 2020
1 parent b4793a5 commit 0c9defa
Show file tree
Hide file tree
Showing 3 changed files with 20 additions and 0 deletions.
1 change: 1 addition & 0 deletions README.adoc
Expand Up @@ -186,6 +186,7 @@ Please read the link:./CONTRIBUTING.adoc[guidelines for contributors].
* image:https://avatars.githubusercontent.com/klmp200[width="50px",link=https://github.com/klmp200] Antoine Bartuccio, fireworks and Sierpinski fractal examples.
* image:https://avatars.githubusercontent.com/gb96[width="50px",link=https://github.com/gb96] Greg Bowering, fixes for localization support within the fireworks example.
* image:https://avatars.githubusercontent.com/m-ezzat[width="50px",link=https://github.com/m-ezzat] Mohamed Ezzat, code cleaning and optimization.
* image:https://avatars.githubusercontent.com/ThomasFarrenkopf[width="50px",link=https://github.com/ThomasFarrenkopf] Thomas Farrenkopf, documentation contributor.
* image:https://avatars.githubusercontent.com/jgfoster[width="50px",link=https://github.com/jgfoster] James Foster, documentation contributor.
* image:https://avatars.githubusercontent.com/gallandarakhneorg[width="50px",link=https://github.com/gallandarakhneorg] link:http://www.ciad-lab.fr/author-10836/[Stéphane GALLAND], founder, original and active author.
* image:https://avatars.githubusercontent.com/ngaud[width="50px",link=https://github.com/ngaud] link:http://www.ciad-lab.fr/author-10834/[Nicolas GAUD], founder, original and active author.
Expand Down
Expand Up @@ -212,6 +212,18 @@ Nevertheless, the two most reported causes of avoidance of the SARL Eclipse laun
* install the JDK [:sarl-run.min.jdk.version!], and configuring your operating system to use it by default; or
* force the SARL product to use the JDK [:sarl-run.min.jdk.version!] by editing the `eclipse-sarl.ini` file into the folder of the SARL IDE. Add the following parameter on a new line: `-vm path`, where `path` is the path to the binary file `javaw` or `java` of at least the JDK [:sarl-run.min.jdk.version!].
[:Fact:]("[:sarl-run.min.jdk.version!]".shouldBeAtLeastJava)
2. The Gatekeeper of MacOS X blocks the launch of the SARL Eclipse, because Gatekeeper considers SARL Eclipse as unstable. You could confirm this problem by looking into your `system.log` file and searching for a message that looks like:

```
(application.io.sarl.lang.product.72020573.72020798[78958]): removing service since it exited with consistent failure - OS_REASON_EXEC | Gatekeeper policy blocked execution
```

On order to enable Gatekeper to enable the SARL Eclipse launch, you should type on the Terminal the following command:
```
sudo xattr -rd com.apple.quarantine Eclipse.app
```

Where `Eclipse.app` is the name of the SARL Eclipse application on MacOS X.


### Why does the SARL product launch but not contain any features related to SARL?
Expand Down
7 changes: 7 additions & 0 deletions pom.xml
Expand Up @@ -237,6 +237,13 @@
<role>Code cleaning and optimization</role>
</roles>
</contributor>
<contributor>
<name>Thomas Farrenkopf</name>
<url>https://github.com/ThomasFarrenkopf</url>
<roles>
<role>Documentation Contributor</role>
</roles>
</contributor>
<contributor>
<name>James Foster</name>
<email>github@jgfoster.net</email>
Expand Down

0 comments on commit 0c9defa

Please sign in to comment.