#423 Added PKG Installer build for macOS systems #2098
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -9,6 +9,7 @@ Release with new features and bugfixes: | |
| * https://github.com/devonfw/IDEasy/issues/2039[#2039]: IDE logo not shown in mac task bar | ||
| * https://github.com/devonfw/IDEasy/issues/2176[#2176]: Support 7z archive extraction | ||
| * https://github.com/devonfw/IDEasy/issues/2100[#2100]: Fix Python not available for Mac x64 | ||
| * https://github.com/devonfw/IDEasy/issues/423[#423]: Added IDEasy installer for macOS. | ||
| * https://github.com/devonfw/IDEasy/issues/2224[#2224]: Brew upgrade ideasy not working | ||
| * https://github.com/devonfw/IDEasy/issues/1784[#1784]: GUI now supports displaying progress bars | ||
| * https://github.com/devonfw/IDEasy/issues/1917[#1917]: Allow the creation of a desktop shortcut for the GUI | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -196,6 +196,28 @@ | |
| </resources> | ||
| </configuration> | ||
| </execution> | ||
| <execution> | ||
| <id>Copy Distribution.xml [macOS Installer]</id> | ||
|
Member
There was a problem hiding this comment. an execution ID is not a descriptive comment but a short unique identifier without spaces and special characters. It may be there to be reference it from CLI or other POMs. |
||
| <phase>validate</phase> | ||
| <goals> | ||
| <goal>copy-resources</goal> | ||
| </goals> | ||
| <configuration> | ||
| <outputDirectory>${project.build.directory}/macos-installer</outputDirectory> | ||
| <delimiters> | ||
| <delimiter>$[*]</delimiter> | ||
| </delimiters> | ||
|
Comment on lines
+207
to
+209
Member
There was a problem hiding this comment. Instead of copy&paste you should extract this to |
||
| <resources> | ||
| <resource> | ||
| <directory>../macos-installer/src</directory> | ||
| <filtering>true</filtering> | ||
| <includes> | ||
| <include>Distribution.xml</include> | ||
| </includes> | ||
| </resource> | ||
| </resources> | ||
| </configuration> | ||
| </execution> | ||
| </executions> | ||
| </plugin> | ||
| </plugins> | ||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -19,7 +19,7 @@ If you prefer a manual installation feel free to read-one. | |
| We try to make it as simple as possible for you. | ||
| However, there are some minimal prerequisites: | ||
|
|
||
| * Unless you use the MSI installer for Windows or the PKG installer for MacOS, you need to have a tool to extract `*.tar.gz` files (`tar` and `gzip`). | ||
| On Windows before Version 10 (1803) use https://www.7-zip.org/[7-zip]. | ||
| On all other platforms this comes out of the box. | ||
| * You need to have https://git-scm.com[git]. | ||
|
|
@@ -36,9 +36,13 @@ The latest release of `IDEasy` can be downloaded from https://github.com/devonfw | |
| Extract the contents of the downloaded archive (`ide-cli-*.tar.gz`) to a new folder and run `setup` in this folder (on windows double-click on `setup.bat`). | ||
|
|
||
| On MacOS please study link:mac-gatekeeper.adoc[Gatekeeper problem and workaround] in order to use IDEasy. | ||
| This is also relevant in case of using the PKG installer on MacOS. | ||
|
|
||
| On Linux, run `./setup` to install. | ||
| Your current terminal session will not recognize the `ide` command immediately. | ||
| To enable it, run `source ~/.bashrc` (or your shell config). | ||
| Alternatively, open a new terminal window to load the configuration automatically. | ||
| For any other existing terminal sessions, you must run the `source` command manually in each. | ||
|
|
||
| Once installed, you want to link:project.adoc[create a project]. | ||
| As next step read the link:usage.adoc[usage]. | ||
|
|
@@ -101,27 +105,35 @@ ide upgrade --mode=stable | |
|
|
||
| === Downloading SNAPSHOT releases manually | ||
|
|
||
| It is also possible to download IDEasy SNAPSHOT releases manually - including for other platforms. | ||
| This may be useful to verify if SNAPSHOT releases for other platforms include an expected file or not. | ||
| However, please note that this is a manual process containing multiple steps: | ||
|
|
||
| First, identify the latest SNAPSHOT version by going to https://central.sonatype.com/repository/maven-snapshots/com/devonfw/tools/IDEasy/ide-cli/maven-metadata.xml. | ||
| The latest version will be indicated by the `<latest>` tag. | ||
| For example, if the file would include | ||
|
|
||
| ``` | ||
| <latest>2026.04.001-SNAPSHOT</latest> | ||
| ``` | ||
|
|
||
| the latest SNAPSHOT version would be `2026.04.001-SNAPSHOT`. | ||
|
|
||
| Next, we add the latest identified version into the following URL: | ||
|
|
||
| ``` | ||
| https://central.sonatype.com/repository/maven-snapshots/com/devonfw/tools/IDEasy/ide-cli/${latest_version}/maven-metadata.xml | ||
| ``` | ||
|
|
||
| In our example, the URL would be https://central.sonatype.com/repository/maven-snapshots/com/devonfw/tools/IDEasy/ide-cli/2026.04.001-SNAPSHOT/maven-metadata.xml. | ||
| On this page you can find the artifacts of the latest SNAPSHOT release for each platform supported by IDEasy. | ||
|
|
||
| Lastly, we obtain a download link of the SNAPSHOT version for our desired platform by constructing a final URL: | ||
|
|
||
| ``` | ||
| https://central.sonatype.com/repository/maven-snapshots/com/devonfw/tools/IDEasy/ide-cli/${latest_version}/ide-cli-${version.value}-${version.classifier}.${version.extension} | ||
| ``` | ||
|
|
||
| In our example, if we wanted to download the mac version, the final URL would be https://central.sonatype.com/repository/maven-snapshots/com/devonfw/tools/IDEasy/ide-cli/2026.04.001-SNAPSHOT/ide-cli-2026.04.001-20260321.030716-2-mac-x64.tar.gz. | ||
|
|
||
| From there, we can download the artifact, extract and test it. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,21 @@ | ||
| {\rtf1\ansi\ansicpg1252\cocoartf2867 | ||
| \cocoatextscaling0\cocoaplatform0{\fonttbl\f0\fswiss\fcharset0 Arial-BoldMT;\f1\fnil\fcharset0 AndaleMono;} | ||
| {\colortbl;\red255\green255\blue255;} | ||
| {\*\expandedcolortbl;;} | ||
| \paperw7920\paperh11520\margl172\margr172\margb172\margt172\vieww11520\viewh8400\viewkind0 | ||
| \deftab720 | ||
| \pard\pardeftab720\ri0\sa80\partightenfactor0 | ||
|
|
||
| \f0\b\fs24 \cf0 Thank you for using IDEasy.\ | ||
| \ | ||
| You can create your first project now by typing:\ | ||
|
|
||
| \f1\b0 ide create <project-name>\ | ||
| \ | ||
|
|
||
| \f0\b Or see all available commands by typing:\ | ||
|
|
||
| \f1\b0 ide help\ | ||
| \ | ||
|
|
||
| \f0\b If you need more information, take a look at our {\field{\*\fldinst{HYPERLINK "https://github.com/devonfw/IDEasy/blob/main/documentation/setup.adoc"}}{\fldrslt documentation}}.} |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,53 @@ | ||
| #!/bin/bash | ||
| set -e | ||
|
|
||
| console_user=$(stat -f "%Su" /dev/console) | ||
| console_uid=$(id -u "$console_user") | ||
|
|
||
| show_error() { | ||
| /bin/launchctl asuser "$console_uid" /usr/bin/osascript \ | ||
| -e "display dialog \"$1\" with title \"IDEasy Installer\" buttons {\"OK\"} with icon stop" | ||
| } | ||
|
|
||
| echo "Step 1/2: Running IDEasy installation..." | ||
|
|
||
| INSTALL_DIR="$HOME/projects/_ide/tmp/ideasy" | ||
|
|
||
| echo "Installing IDEasy to $INSTALL_DIR" | ||
|
|
||
| LOG_DIR="$HOME/.ide/logs" | ||
| mkdir -p "$LOG_DIR" | ||
| ts=$(date +"%Y-%m-%d-%H-%M-%S") | ||
| LOG_FILE="$LOG_DIR/install-$ts.log" | ||
|
|
||
| echo "IDEasy installation log for this session can be found at: $LOG_FILE" | ||
|
|
||
| if [ ! -d "$INSTALL_DIR" ]; then | ||
| echo "ERROR: expected install directory not found: $INSTALL_DIR" >&2 | ||
| show_error "IDEasy installation failed: expected directory not found:\n$INSTALL_DIR" | ||
| exit 1 | ||
| fi | ||
|
|
||
| "$INSTALL_DIR/bin/ideasy" -ftb --no-colors install \ | ||
| > "$LOG_FILE" 2>&1 | ||
| install_rc=$? | ||
|
|
||
| # 1. Handle generic install errors by analyzing the log file for known error messages | ||
| if grep -q "ide (install) failed after" "$LOG_FILE"; then | ||
| show_error "IDEasy installation failed. See log:\n$LOG_FILE" | ||
| exit 1 | ||
| fi | ||
|
|
||
| # 3. Fallback: Exit-Code != 0 and no error message could be detected in the log file. Show generic error message with log file path. | ||
| if [ $install_rc -ne 0 ]; then | ||
| show_error "IDEasy installation failed (exit code $install_rc). See log:\n$LOG_FILE" | ||
| exit 1 | ||
| fi | ||
|
|
||
| echo "Step 2/2: Cleaning up temporary ideasy installation..." | ||
|
|
||
| rm -rf "$INSTALL_DIR" | ||
|
|
||
| echo "Install finished" | ||
|
|
||
| exit 0 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,23 @@ | ||
| <?xml version="1.0" encoding="utf-8"?> | ||
| <!-- This file is the installer configuration file for the macOS pkg-Installer. The next_version placeholder will be replaced during build with the correct version. --> | ||
| <installer-gui-script minSpecVersion="1"> | ||
| <title>IDEasy - $[project.version]</title> | ||
| <license file="LICENSE.rtf"/> | ||
| <conclusion file="CONCLUSION.rtf"/> | ||
| <background file="background.png" alignment="left" scaling="tofit"/> | ||
|
laim2003 marked this conversation as resolved.
|
||
| <background-darkAqua file="background.png" alignment="left" scaling="tofit"/> | ||
| <options customize="never" require-scripts="true"/> | ||
| <domains enable_anywhere="false" | ||
| enable_currentUserHome="true" | ||
| enable_localSystem="false"/> | ||
| <choices-outline> | ||
| <line choice="default"> | ||
| <line choice="com.devonfw.ideasy"/> | ||
| </line> | ||
| </choices-outline> | ||
| <choice id="default"/> | ||
| <choice id="com.devonfw.ideasy" visible="false"> | ||
| <pkg-ref id="com.devonfw.ideasy"/> | ||
| </choice> | ||
| <pkg-ref id="com.devonfw.ideasy" version="$[project.version]" onConclusion="none">IDEasyComponent.pkg</pkg-ref> | ||
| </installer-gui-script> | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -287,6 +287,26 @@ | |
| <violationSeverity>error</violationSeverity> | ||
| </configuration> | ||
| </plugin> | ||
|
|
||
| <!-- Clean up macOS installer artifacts --> | ||
| <plugin> | ||
| <groupId>org.apache.maven.plugins</groupId> | ||
|
Member
There was a problem hiding this comment. IMHO we should improve the design how you integrated this into maven. |
||
| <artifactId>maven-clean-plugin</artifactId> | ||
| <version>3.5.0</version> | ||
| <configuration> | ||
| <filesets> | ||
| <fileset> | ||
| <directory>${basedir}/macos-installer</directory> | ||
| <includes> | ||
| <include>Distribution.xml</include> | ||
| <include>*.pkg</include> | ||
| <include>pkg-root/</include> | ||
| </includes> | ||
| <followSymlinks>false</followSymlinks> | ||
| </fileset> | ||
| </filesets> | ||
| </configuration> | ||
| </plugin> | ||
| </plugins> | ||
| </build> | ||
|
|
||
|
|
||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do not copy&paste this.
PR #2223 just introduced a clean solution to avoid this.
Please use
RELEASE_VERSIONvariable.