diff --git a/README.md b/README.md index 16dfb35..53fc409 100644 --- a/README.md +++ b/README.md @@ -41,6 +41,9 @@ Quick installation using curl and bash: **The latest release can be found [here](https://github.com/eMoflon/emoflon-ibex-eclipse-build/releases/latest).** Download an archive for the version you are looking for from the release page and extract it. +> [!CAUTION] +> The built Eclipse version for **macOS** needs further adjustments to execute correctly. Please follow the steps in the respective [documentation](./doc/how-to-run-eclipse-on-macos.md) if you are using macOS. + ### Updating You can use the [update script](./emoflon-update.sh) to update your installation. diff --git a/doc/eclipse-damaged.png b/doc/eclipse-damaged.png new file mode 100644 index 0000000..5195020 Binary files /dev/null and b/doc/eclipse-damaged.png differ diff --git a/doc/eclipse-java-home-error.png b/doc/eclipse-java-home-error.png new file mode 100644 index 0000000..6fd1968 Binary files /dev/null and b/doc/eclipse-java-home-error.png differ diff --git a/doc/eclipse-jdk-cli-error.png b/doc/eclipse-jdk-cli-error.png new file mode 100644 index 0000000..d89d7a1 Binary files /dev/null and b/doc/eclipse-jdk-cli-error.png differ diff --git a/doc/how-to-run-eclipse-on-macos.md b/doc/how-to-run-eclipse-on-macos.md new file mode 100644 index 0000000..4bb1935 --- /dev/null +++ b/doc/how-to-run-eclipse-on-macos.md @@ -0,0 +1,64 @@ +# How to run a custom Eclipse on macOS + +(Apparantly, this was only tested on AMD64-based Macs = Intel Macs only!) + + +## Problem + +If you just run a custom Eclipse without further configuration on modern macOS systems, you will propably get one of the following error messages: + +![](./eclipse-damaged.png) + +![](./eclipse-java-home-error.png) + +![](./eclipse-jdk-cli-error.png) + + +## Solution + +The following steps are necessary to run a custom Eclipse on modern macOS systems. + +- Allow your Terminal the privileges to `Full Disk Access` and `Developer Tools` in the `Settings` app of macOS. + - `Settings` -> `Privacy & Security` -> `Full Disk Access` -> Add `Terminal` app and/or toggle its setting to `on`. + - `Settings` -> `Privacy & Security` -> `Developer Tools` -> Add `Terminal` app and/or toggle its setting to `on`. +- Install the recommend JDK, e.g., [Eclipse Temurin JDK 17](https://adoptium.net/de/temurin/releases/?os=mac&arch=x64&package=jdk&version=17). +- Download the custom Eclipse archive (e.g., from https://emoflon.org or GitHub). +- Extract it with a double click. +- Right click on `Eclipse.app` -> `Show Package Contents` -> Navigate into `Contents`. +- Open `Info.plist` with a text editor of your choice (e.g., [VSCodium](https://vscodium.com/)). +- Open a Terminal window and run `$ /usr/libexec/java_home` + - This should return you a single path to your default Java JDK installation, e.g., `/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home` +- Leave your Terminal window open and return to your text editor (showing the contents of `Info.plist`). Scroll down into the block below the line `Eclipse` and enter your Java JDK's path with this syntax: `-vm$YOUR_PATH/bin/java` + - Example: `-vm/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home/bin/java` +- Save the file, close your editor, and open your Terminal window again. +- Navigate the Terminal window to your Eclipse folder using `cd $FOLDER_NAME`, e.g., `cd Downloads/eclipste`. + - Verify that your custom `Eclipse.app` is located in the currently selected folder via `ls`. +- Sign the modified `Eclipse.app` with this command: `$ sudo codesign --force --deep --sign - ./Eclipse.app` + - When requested, type in the password of your user account and hit enter. +- Run `$ xattr -d com.apple.quarantine ./Eclipse.app` within the Terminal. +- As for the `Terminal` app, add the privileges for `Full Disk Access` and `Developer Tools` to your `Eclipse.app`. + +You can now start your custom `Eclipse.app` with a double click on it. +If macOS asks if you really want to start the "broken" app, select `Run`. + +--- + +## Currently known issues + +... besides the hustle to get Eclipse running. + +- Custom eMoflon settings will not be honored. + - The default *perspective* is not the *eMoflon perspective*. + - The default workspace encoding may not be *UTF8*. + - The default git clone path is not `${workspace_loc}/git` as required to run eMoflon. +- There is no specific build for ARM64/Apple ARM-based macOS systems. + +--- + +## References/Pointers to useful websites + +- https://stackoverflow.com/questions/70725347/the-application-eclipse-can-t-be-opened-macos-monterey/71740449#71740449 +- https://www.eclipse.org/forums/index.php/t/1106695/ +- https://forums.developer.apple.com/forums/thread/684509 +- https://forums.developer.apple.com/forums/thread/673057 +- https://stackoverflow.com/questions/44872071/removing-the-code-signature-from-a-mac-app-executable