STAR CLI Installers

Author: dellams

STAR ODK/NextGenSoftware.OASIS.STAR.CLI/installers/README.md

@@ -0,0 +1,58 @@
+# STAR CLI – Platform-specific installers (Option 3)
+
+This folder contains scripts to build **native installers** for Windows, macOS, and Linux. Run the scripts on (or for) each platform to produce installable packages.
+
+| Platform | Location | What you get |
+|----------|----------|----------------|
+| **Windows** | `windows/` | **Inno Setup** EXE installer: adds `star.exe` to Program Files and optionally to system PATH. |
+| **macOS** | `macos/` | **.pkg** installer: installs `star` to `/usr/local/bin`. |
+| **Linux** | `linux/` | **.deb** and **.rpm** packages (via **fpm**): install `star` to `/usr/local/bin`. |
+
+All scripts publish the STAR CLI (single-file, self-contained) for the target platform first, then build the installer. Output goes to `publish/installers/` (and for Windows, the Inno script also expects publish output under `publish/win-x64/`).
+
+**DNA folder rule:** Wherever `star` (or `star.exe`) is installed, a **DNA** folder must sit next to it with config/default JSON files. Only **JSON** files are included (no `.cs` or other source). This is enforced in `NextGenSoftware.OASIS.STAR.CLI.csproj` (Content: `DNA\**\*.json`); all installers copy the DNA folder from that publish output.
+
+---
+
+## Quick start
+
+### Windows (run on Windows)
+
+1. Install [Inno Setup 6](https://jrsoftware.org/isinfo.php) (optional; if missing, only the binary is published).
+2. Run:
+   ```bat
+   installers\windows\build-installer.bat
+   ```
+   Or from PowerShell: `.\installers\windows\build-installer.ps1`
+3. Installer: `publish\installers\star-cli-1.0.0-win-x64.exe`
+
+### macOS (run on macOS)
+
+1. In Terminal:
+   ```bash
+   chmod +x installers/macos/build-installer.sh
+   ./installers/macos/build-installer.sh
+   ```
+2. Installer: `publish/installers/star-cli-1.0.0-osx-arm64.pkg` (or `osx-x64` on Intel). Double-click to install.
+
+### Linux (run on Linux)
+
+1. Install **fpm**: `gem install fpm`
+2. Run:
+   ```bash
+   chmod +x installers/linux/build-installer.sh
+   ./installers/linux/build-installer.sh
+   ```
+3. Packages: `publish/installers/star-cli_1.0.0_amd64.deb` and `star-cli-1.0.0-1.x86_64.rpm`  
+   Install: `sudo dpkg -i star-cli_1.0.0_amd64.deb` or `sudo rpm -i star-cli-1.0.0-1.x86_64.rpm`
+
+---
+
+## Prerequisites
+
+- **All:** .NET 8 SDK.
+- **Windows:** Inno Setup 6 (optional) for the EXE installer.
+- **macOS:** None beyond .NET 8 (uses built-in `pkgbuild`).
+- **Linux:** Ruby and **fpm** (`gem install fpm`) for .deb/.rpm; `rpm` for RPM builds.
+
+See each platform’s subfolder for more detail (e.g. `windows/`, `macos/README.md`, `linux/README.md`).

STAR ODK/NextGenSoftware.OASIS.STAR.CLI/installers/linux/README.md

@@ -0,0 +1,11 @@
+# Linux installers
+
+- **Build (on Linux):** `./build-installer.sh` — publishes linux-x64 and builds .deb + .rpm in `publish/installers/`.
+- **Build for ARM64:** `./build-installer.sh linux-arm64`.
+- **Prerequisites:** .NET 8 SDK, Ruby, and **fpm** (`gem install fpm`). For .rpm building, `rpm` must be installed.
+
+**Install (after building):**
+- Debian/Ubuntu: `sudo dpkg -i publish/installers/star-cli_1.0.0_amd64.deb`
+- RHEL/Fedora: `sudo rpm -i publish/installers/star-cli-1.0.0-1.x86_64.rpm`
+
+Without fpm, the script still publishes the binary; you can copy `publish/linux-x64/star` to `/usr/local/bin` manually.

STAR ODK/NextGenSoftware.OASIS.STAR.CLI/installers/linux/build-installer.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+# Build Linux .deb (and optionally .rpm) for STAR CLI.
+# Prerequisites: .NET 8 SDK; fpm (gem install fpm).
+# Usage: ./build-installer.sh [linux-x64|linux-arm64]  (default: linux-x64)
+
+set -e
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+PUBLISH_DIR="$PROJECT_DIR/publish"
+INSTALLER_OUT="$PUBLISH_DIR/installers"
+VERSION="${VERSION:-1.0.0}"
+ARCH="${1:-linux-x64}"
+
+mkdir -p "$INSTALLER_OUT"
+
+if [ ! -d "$PUBLISH_DIR/$ARCH" ] || [ ! -f "$PUBLISH_DIR/$ARCH/star" ]; then
+  echo "Publishing $ARCH..."
+  dotnet publish "$PROJECT_DIR/NextGenSoftware.OASIS.STAR.CLI.csproj" \
+    -c Release -r "$ARCH" \
+    -p:PublishSingleFile=true -p:SelfContained=true \
+    -o "$PUBLISH_DIR/$ARCH"
+fi
+
+STAR_BIN="$PUBLISH_DIR/$ARCH/star"
+if [ ! -f "$STAR_BIN" ]; then
+  echo "Error: $STAR_BIN not found." >&2
+  exit 1
+fi
+
+# Map RID to deb/rpm architecture names
+DEB_ARCH="$ARCH"
+case "$ARCH" in
+  linux-x64)   DEB_ARCH="amd64"; RPM_ARCH="x86_64" ;;
+  linux-arm64) DEB_ARCH="arm64"; RPM_ARCH="aarch64" ;;
+  *)           RPM_ARCH="$ARCH" ;;
+esac
+
+# Stage: star in /usr/local/bin; DNA folder (JSON only) next to it (same rule as Windows/macOS)
+PKG_ROOT="$INSTALLER_OUT/pkgroot"
+rm -rf "$PKG_ROOT"
+mkdir -p "$PKG_ROOT/usr/local/bin"
+cp "$STAR_BIN" "$PKG_ROOT/usr/local/bin/star"
+chmod 755 "$PKG_ROOT/usr/local/bin/star"
+if [ -d "$PUBLISH_DIR/$ARCH/DNA" ]; then
+  cp -R "$PUBLISH_DIR/$ARCH/DNA" "$PKG_ROOT/usr/local/bin/"
+fi
+
+# .deb and .rpm (requires fpm: gem install fpm)
+if command -v fpm >/dev/null 2>&1; then
+  ( cd "$PKG_ROOT" && fpm -s dir -t deb \
+    -n star-cli \
+    -v "$VERSION" \
+    -a "$DEB_ARCH" \
+    -p "$INSTALLER_OUT/star-cli_${VERSION}_${DEB_ARCH}.deb" \
+    --description "OASIS STAR CLI - command-line development tools and low/no-code generator" \
+    --url "https://github.com/NextGenSoftware/OASIS" \
+    --vendor "NextGen Software" \
+    usr )
+  echo "Debian package: $INSTALLER_OUT/star-cli_${VERSION}_${DEB_ARCH}.deb"
+
+  ( cd "$PKG_ROOT" && fpm -s dir -t rpm \
+    -n star-cli \
+    -v "$VERSION" \
+    -a "$RPM_ARCH" \
+    -p "$INSTALLER_OUT/star-cli-${VERSION}-1.${RPM_ARCH}.rpm" \
+    --description "OASIS STAR CLI - command-line development tools and low/no-code generator" \
+    --url "https://github.com/NextGenSoftware/OASIS" \
+    --vendor "NextGen Software" \
+    usr )
+  echo "RPM package: $INSTALLER_OUT/star-cli-${VERSION}-1.${RPM_ARCH}.rpm"
+else
+  echo "fpm not found. Install with: gem install fpm"
+  echo "Staged files are in $PKG_ROOT (usr/local/bin/star). Package manually or install with: sudo cp $PKG_ROOT/usr/local/bin/star /usr/local/bin/"
+fi
+
+rm -rf "$PKG_ROOT"
+echo "Done."

STAR ODK/NextGenSoftware.OASIS.STAR.CLI/installers/macos/README.md

@@ -0,0 +1,7 @@
+# macOS installer
+
+- **Build (on macOS):** `./build-installer.sh` — builds for current architecture (arm64 or x64).
+- **Build for a specific arch:** `./build-installer.sh osx-arm64` or `./build-installer.sh osx-x64`.
+- **Output:** `publish/installers/star-cli-1.0.0-osx-arm64.pkg` (or osx-x64). Double-click to install; `star` is placed in `/usr/local/bin`.
+
+For a DMG wrapper, use [create-dmg](https://github.com/create-dmg/create-dmg) or similar after building the .pkg.

STAR ODK/NextGenSoftware.OASIS.STAR.CLI/installers/macos/build-installer.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+# Build macOS installer (.pkg) for STAR CLI.
+# Prerequisites: .NET 8 SDK. Run on macOS (or cross-publish from Windows then run this on macOS).
+# Usage: ./build-installer.sh [osx-x64|osx-arm64]  (default: detect current arch and build)
+
+set -e
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+PUBLISH_DIR="$PROJECT_DIR/publish"
+INSTALLER_OUT="$PUBLISH_DIR/installers"
+VERSION="${VERSION:-1.0.0}"
+ARCH="${1:-}"
+
+mkdir -p "$INSTALLER_OUT"
+
+if [ -z "$ARCH" ]; then
+  ARCH=$(uname -m)
+  if [ "$ARCH" = "arm64" ]; then
+    ARCH="osx-arm64"
+  else
+    ARCH="osx-x64"
+  fi
+fi
+
+if [ ! -d "$PUBLISH_DIR/$ARCH" ] || [ ! -f "$PUBLISH_DIR/$ARCH/star" ]; then
+  echo "Publishing $ARCH..."
+  dotnet publish "$PROJECT_DIR/NextGenSoftware.OASIS.STAR.CLI.csproj" \
+    -c Release -r "$ARCH" \
+    -p:PublishSingleFile=true -p:SelfContained=true \
+    -o "$PUBLISH_DIR/$ARCH"
+fi
+
+STAR_BIN="$PUBLISH_DIR/$ARCH/star"
+if [ ! -f "$STAR_BIN" ]; then
+  echo "Error: $STAR_BIN not found." >&2
+  exit 1
+fi
+
+# Stage: star in /usr/local/bin; DNA folder (JSON only) next to it (same rule as Windows/Linux)
+PKG_ROOT="$INSTALLER_OUT/pkgroot"
+rm -rf "$PKG_ROOT"
+mkdir -p "$PKG_ROOT/usr/local/bin"
+cp "$STAR_BIN" "$PKG_ROOT/usr/local/bin/star"
+chmod 755 "$PKG_ROOT/usr/local/bin/star"
+if [ -d "$PUBLISH_DIR/$ARCH/DNA" ]; then
+  cp -R "$PUBLISH_DIR/$ARCH/DNA" "$PKG_ROOT/usr/local/bin/"
+fi
+
+# Build .pkg (flat package)
+OUTPUT_PKG="$INSTALLER_OUT/star-cli-${VERSION}-${ARCH}.pkg"
+pkgbuild --root "$PKG_ROOT" \
+  --identifier com.oasis.star.cli \
+  --version "$VERSION" \
+  --install-location / \
+  "$OUTPUT_PKG"
+
+rm -rf "$PKG_ROOT"
+echo "Installer: $OUTPUT_PKG"
+echo "Done."

STAR ODK/NextGenSoftware.OASIS.STAR.CLI/installers/windows/README.md

@@ -0,0 +1,7 @@
+# Windows installer (Inno Setup)
+
+- **Build:** Run `build-installer.bat` or `build-installer.ps1` from the STAR CLI project directory. This publishes `win-x64` and, if Inno Setup 6 is installed, produces an EXE installer.
+- **Prerequisites:** .NET 8 SDK; [Inno Setup 6](https://jrsoftware.org/isinfo.php) (optional; if missing, only the binary is published to `publish/win-x64/`).
+- **Output:** `publish/installers/star-cli-1.0.0-win-x64.exe`. The installer installs to `Program Files\OASIS STAR CLI` and can add it to the system PATH.
+
+To change the version, edit the `#define MyAppVersion` line in `star-cli.iss` (and/or pass version from the build script in a future update).

STAR ODK/NextGenSoftware.OASIS.STAR.CLI/installers/windows/build-installer.bat

@@ -0,0 +1,5 @@
+@echo off
+setlocal
+set "SCRIPT_DIR=%~dp0"
+powershell -NoProfile -ExecutionPolicy Bypass -File "%SCRIPT_DIR%build-installer.ps1"
+exit /b %ERRORLEVEL%

STAR ODK/NextGenSoftware.OASIS.STAR.CLI/installers/windows/build-installer.ps1

@@ -0,0 +1,54 @@
+# Build Windows installer for STAR CLI (Inno Setup).
+# Prerequisites:
+#   1. .NET 8 SDK
+#   2. Inno Setup 6 (https://jrsoftware.org/isinfo.php) - optional; if not installed, only publish step runs.
+# Run from: STAR ODK\NextGenSoftware.OASIS.STAR.CLI (or repo root).
+
+$ErrorActionPreference = "Stop"
+$ScriptDir = if ($PSScriptRoot) { $PSScriptRoot } else { "." }
+$ProjectDir = Resolve-Path (Join-Path $ScriptDir "..\..")
+$PublishDir = Join-Path $ProjectDir "publish"
+$WinPublishDir = Join-Path $PublishDir "win-x64"
+$InstallerOutputDir = Join-Path $PublishDir "installers"
+
+# 1. Publish win-x64 single-file executable
+Write-Host "Publishing STAR CLI for win-x64..." -ForegroundColor Cyan
+Push-Location $ProjectDir
+try {
+    dotnet publish (Join-Path $ProjectDir "NextGenSoftware.OASIS.STAR.CLI.csproj") `
+        -c Release `
+        -r win-x64 `
+        -p:PublishSingleFile=true `
+        -p:SelfContained=true `
+        -o $WinPublishDir
+    if ($LASTEXITCODE -ne 0) { throw "dotnet publish failed" }
+} finally {
+    Pop-Location
+}
+
+if (-not (Test-Path (Join-Path $WinPublishDir "star.exe"))) {
+    throw "Publish did not produce star.exe in $WinPublishDir"
+}
+
+# 2. Compile Inno Setup script if ISCC is available
+$iscc = $null
+$paths = @(
+    "${env:ProgramFiles(x86)}\Inno Setup 6\ISCC.exe",
+    "${env:ProgramFiles}\Inno Setup 6\ISCC.exe",
+    "${env:ProgramFiles(x86)}\Inno Setup 5\ISCC.exe"
+)
+foreach ($p in $paths) {
+    if (Test-Path $p) { $iscc = $p; break }
+}
+
+if ($iscc) {
+    Write-Host "Building installer with Inno Setup..." -ForegroundColor Cyan
+    New-Item -ItemType Directory -Force -Path $InstallerOutputDir | Out-Null
+    & $iscc (Join-Path $ScriptDir "star-cli.iss")
+    if ($LASTEXITCODE -ne 0) { throw "Inno Setup compilation failed" }
+    Write-Host "Installer created in: $InstallerOutputDir" -ForegroundColor Green
+} else {
+    Write-Host "Inno Setup not found. Install from https://jrsoftware.org/isinfo.php and re-run, or use: $WinPublishDir\star.exe" -ForegroundColor Yellow
+}
+
+Write-Host "Done." -ForegroundColor Green

STAR ODK/NextGenSoftware.OASIS.STAR.CLI/installers/windows/star-cli.iss

@@ -0,0 +1,55 @@
+; Inno Setup script for OASIS STAR CLI (Windows)
+; Build: Run publish-crossplatform.ps1 first, then compile this script with Inno Setup.
+; Requires: Inno Setup 6 (https://jrsoftware.org/isinfo.php)
+
+#define MyAppName "OASIS STAR CLI"
+#define MyAppId "OASIS.STAR.CLI"
+#define MyAppVersion "3.4.0"
+#define MyAppPublisher "NextGen Software Ltd"
+#define MyAppURL "https://github.com/NextGenSoftware/OASIS"
+#define MyAppExe "star.exe"
+; Publish output relative to this script (installers\windows): project dir is ..\..\
+#define PublishDir "..\..\publish\win-x64"
+
+[Setup]
+AppId={#MyAppId}
+AppName={#MyAppName}
+AppVersion={#MyAppVersion}
+AppPublisher={#MyAppPublisher}
+AppPublisherURL={#MyAppURL}
+AppSupportURL={#MyAppURL}
+AppUpdatesURL={#MyAppURL}
+DefaultDirName={autopf}\OASIS STAR CLI
+DefaultGroupName=OASIS STAR CLI
+DisableProgramGroupPage=yes
+; Add install dir to system PATH so "star" works from any terminal
+ChangesEnvironment=yes
+OutputDir=..\..\publish\installers
+OutputBaseFilename=star-cli-{#MyAppVersion}-win-x64
+SetupIconFile=
+Compression=lzma2/ultra64
+SolidCompression=yes
+WizardStyle=modern
+PrivilegesRequired=admin
+ArchitecturesAllowed=x64 arm64
+ArchitecturesInstallIn64BitMode=x64 arm64
+
+[Languages]
+Name: "english"; MessagesFile: "compiler:Default.isl"
+
+[Tasks]
+Name: "addpath"; Description: "Add STAR CLI to system PATH"; GroupDescription: "Options:"
+
+[Files]
+Source: "{#PublishDir}\{#MyAppExe}"; DestDir: "{app}"; Flags: ignoreversion
+; DNA folder next to star.exe (only JSON files; populated at publish by CLI csproj)
+Source: "{#PublishDir}\DNA\*"; DestDir: "{app}\DNA"; Flags: ignoreversion recursesubdirs createallsubdirs skipifsourcedoesntexist
+
+[Registry]
+; Add install dir to PATH (only if task selected). Uses {olddata} to append.
+Root: HKLM; Subkey: "SYSTEM\CurrentControlSet\Control\Session Manager\Environment"; ValueType: expandsz; ValueName: "Path"; ValueData: "{olddata};{app}"; Tasks: addpath
+; Note: Uninstall does not remove from PATH (safe; user can edit PATH if needed).
+
+[Icons]
+Name: "{group}\{#MyAppName}"; Filename: "{app}\{#MyAppExe}"; Comment: "OASIS STAR CLI"
+Name: "{group}\Uninstall {#MyAppName}"; Filename: "{uninstallexe}"