#423 Added PKG Installer build for macOS systems

.github/workflows/nightly-build.yml

@@ -83,6 +83,41 @@ jobs:
           name: msi
           path: windows-installer/signed/ideasy.msi
 
+      - name: Build MacOS PKG
+        if: runner.os == 'macOS'
+        shell: bash
+        run: |
+          maven_config="$(cat .mvn/maven.config)"
+          current_version="${maven_config/#*-Drevision=}"
+          current_version="${current_version/ */}"
+          next_version="${current_version/-SNAPSHOT/}"
+          cd documentation
+          mvn -B -ntp clean install
+          cd ..
+          mkdir -p macos-installer/pkg-root/Library/IDEasy/bin
+          mkdir -p macos-installer/Resources
+          cp documentation/target/generated-docs/LICENSE.rtf macos-installer/Resources/LICENSE.rtf
+          cp -r cli/target/package/* macos-installer/pkg-root/Library/IDEasy/
+          rm -rf macos-installer/pkg-root/Library/IDEasy/system/windows
+          rm -rf macos-installer/pkg-root/Library/IDEasy/system/linux
+          cp cli/target/ideasy macos-installer/pkg-root/Library/IDEasy/bin/
+          chmod +x macos-installer/pkg-root/Library/IDEasy/bin/ideasy
+          chmod +x macos-installer/scripts/postinstall
+          cd macos-installer
+          pkgbuild --root pkg-root --identifier com.devonfw.ideasy \
+          --version $next_version --install-location "/" \
+          --scripts scripts IDEasyComponent.pkg
+          sed -i '' "s/\${next_version}/${next_version}/" Distribution.xml
+          productbuild --distribution Distribution.xml --resources Resources \
+          --package-path . IDEasy-$next_version.pkg
+        # pkgbuild is responsible for building the installation bundle. By using productbuild, we can custimze the installation process, including things like showing a license.
+      - name: Upload PKG
+        if: runner.os == 'macOS'
+        uses: actions/upload-artifact@v4
+        with:
+          name: pkg
+          path: macos-installer/IDEasy-*.pkg
+
   # Downloads all native image artifacts to cli/target and builds the project using assemblies for final deployment to OSSRH Nexus
   deploy:
     name: Build Project and Deploy

.github/workflows/release.yml

@@ -84,6 +84,40 @@ jobs:
         with:
           name: msi
           path: windows-installer/signed/ideasy.msi
+      - name: Build MacOS PKG
+        if: runner.os == 'macOS'
+        shell: bash
+        run: |
+          maven_config="$(cat .mvn/maven.config)"
+          current_version="${maven_config/#*-Drevision=}"
+          current_version="${current_version/ */}"
+          next_version="${current_version/-SNAPSHOT/}"
+          cd documentation
+          mvn -B -ntp clean install
+          cd ..
+          mkdir -p macos-installer/pkg-root/Library/IDEasy/bin
+          mkdir -p macos-installer/Resources
+          cp documentation/target/generated-docs/LICENSE.rtf macos-installer/Resources/LICENSE.rtf
+          cp -r cli/target/package/* macos-installer/pkg-root/Library/IDEasy/
+          rm -rf macos-installer/pkg-root/Library/IDEasy/system/windows
+          rm -rf macos-installer/pkg-root/Library/IDEasy/system/linux
+          cp cli/target/ideasy macos-installer/pkg-root/Library/IDEasy/bin/
+          chmod +x macos-installer/pkg-root/Library/IDEasy/bin/ideasy
+          chmod +x macos-installer/scripts/postinstall
+          cd macos-installer
+          pkgbuild --root pkg-root --identifier com.devonfw.ideasy \
+          --version $next_version --install-location "/" \
+          --scripts scripts IDEasyComponent.pkg
+          sed -i '' "s/\${next_version}/${next_version}/" Distribution.xml
+          productbuild --distribution Distribution.xml --resources Resources \
+          --package-path . IDEasy-$next_version.pkg
+        # pkgbuild is responsible for building the installation bundle. By using productbuild, we can custimze the installation process, including things like showing a license.
+      - name: Upload PKG
+        if: runner.os == 'macOS'
+        uses: actions/upload-artifact@v4
+        with:
+          name: pkg
+          path: macos-installer/IDEasy-*.pkg
 
   # Downloads all native image artifacts to cli/target and builds the project using assemblies for final deployment to Maven Central.
   # The version number for the next build will be incremented automatically.

.gitignore

@@ -19,6 +19,11 @@ eclipse-target/
 generated/
 node_modules
 
+#macOs installer files
+macos-installer/*.pkg
+macos-installer/Resources/LICENSE.rtf
+macos-installer/pkg-root
+
 # Package Files #
 *.jar
 *.war

CHANGELOG.adoc

@@ -12,6 +12,7 @@ Release with new features and bugfixes:
 * https://github.com/devonfw/IDEasy/issues/822[#822] : Added Cwd path limit in shell
 * https://github.com/devonfw/IDEasy/issues/1517[#1517]: Fix IDEasy MSI does not configure Windows Terminal for git-bash
 * https://github.com/devonfw/IDEasy/issues/1227[#1227]: Added Setup instrcutions to the Windows installer
+* https://github.com/devonfw/IDEasy/issues/423[#423]: Added IDEasy installer for macOS.
 
 The full list of changes for this release can be found in https://github.com/devonfw/IDEasy/milestone/46?closed=1[milestone 2026.07.001].
 

macos-installer/Distribution.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="utf-8"?>
+<installer-gui-script minSpecVersion="1">
+  <title>IDEasy - 2026.07.001</title>
+  <license file="LICENSE.rtf"/>
+  <conclusion file="CONCLUSION.rtf"/>
+  <options customize="never" require-scripts="false" rootVolumeOnly="true"/>
+  <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="2026.07.001" onConclusion="none">IDEasyComponent.pkg</pkg-ref>
+</installer-gui-script>

macos-installer/Resources/CONCLUSION.rtf

@@ -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}}.}

macos-installer/scripts/postinstall

@@ -0,0 +1,35 @@
+#!/bin/bash
+set -e
+
+INSTALL_DIR="/Library/IDEasy"
+
+echo "Begin install"
+
+# Determine the logged-in user. When the PKG installer executes a script, it references the ROOT, not a user, therefore we have to find out who runs the script.
+CONSOLE_USER=$(stat -f%Su /dev/console)
+# dscl -read reads the given user information reliably
+USER_HOME=$(dscl . -read "/Users/${CONSOLE_USER}" NFSHomeDirectory 2>/dev/null | awk '{print $2}')
+
+if [ -z "$USER_HOME" ] || [ "$CONSOLE_USER" = "root" ]; then
+    echo "ERROR: could not determine target user, aborting IDEasy install." >&2
+    exit 1
+fi
+
+LOG_DIR="${USER_HOME}/.ide/logs"
+sudo -u "$CONSOLE_USER" mkdir -p "$LOG_DIR"
+ts=$(date +"%Y-%m-%d-%H-%M-%S")
+
+ln -sf "$INSTALL_DIR/bin/ideasy" /usr/local/bin/ideasy
+
+echo "IDEasy installation log for this session can be found at: $LOG_DIR/install-$ts.log"
+
+sudo -u "$CONSOLE_USER" -H \
+  "$INSTALL_DIR/bin/ideasy" -ftb --no-colors install \
+  > "$LOG_DIR/install-$ts.log" 2>&1
+
+
+echo "$INSTALL_DIR/bin" > /etc/paths.d/ideasy #Add ideasy to PATH for both zsh and bash
+
+echo "Install finished"
+
+exit 0