From 355905df40285855f144cf66f95ff092abe45903 Mon Sep 17 00:00:00 2001
From: Nando Vieira <me@fnando.com>
Date: Fri, 15 Nov 2024 14:46:40 -0800
Subject: [PATCH] Generate windows installer. (#1726)

---
 .github/workflows/binaries.yml |  71 ++++++++++++++++++++++++-
 installer.iss                  |  94 +++++++++++++++++++++++++++++++++
 stellar.ico                    | Bin 0 -> 11166 bytes
 3 files changed, 163 insertions(+), 2 deletions(-)
 create mode 100644 installer.iss
 create mode 100644 stellar.ico

diff --git a/.github/workflows/binaries.yml b/.github/workflows/binaries.yml
index 25cea7366..985f91fa5 100644
--- a/.github/workflows/binaries.yml
+++ b/.github/workflows/binaries.yml
@@ -34,7 +34,7 @@ jobs:
             target: aarch64-unknown-linux-gnu
           - os: macos-14
             target: aarch64-apple-darwin
-          - os: macos-12
+          - os: macos-14
             target: x86_64-apple-darwin
           - os: windows-latest
             target: x86_64-pc-windows-msvc
@@ -44,41 +44,50 @@ jobs:
     - uses: actions/checkout@v4
     - run: rustup update
     - run: rustup target add ${{ matrix.sys.target }}
+
     - if: matrix.sys.target == 'aarch64-unknown-linux-gnu'
       run: sudo apt-get update && sudo apt-get -y install gcc-aarch64-linux-gnu g++-aarch64-linux-gnu libudev-dev
+
     - name: Setup vars
       run: |
         version="$(cargo metadata --format-version 1 --no-deps | jq -r '.packages[] | select(.name == "stellar-cli") | .version')"
         echo "VERSION=${version}" >> $GITHUB_ENV
         echo "NAME=${{ matrix.crate.name }}-${version}-${{ matrix.sys.target }}" >> $GITHUB_ENV
+
     - name: Package (release only)
       if: github.event_name == 'release'
       run: cargo package --no-verify --package ${{ matrix.crate.name }}
+
     - name: Package Extract (release only)
       if: github.event_name == 'release'
       run: |
         cd target/package
         tar xvfz ${{ matrix.crate.name }}-$VERSION.crate
         echo "BUILD_WORKING_DIR=target/package/${{ matrix.crate.name }}-$VERSION" >> $GITHUB_ENV
+
     - name: Build
       env:
         CARGO_TARGET_AARCH64_UNKNOWN_LINUX_GNU_LINKER: aarch64-linux-gnu-gcc
       working-directory: ${{ env.BUILD_WORKING_DIR }}
       run: cargo build --target-dir="$GITHUB_WORKSPACE/target" --package ${{ matrix.crate.name }} --features opt --release --target ${{ matrix.sys.target }}
+
     - name: Build provenance for attestation (release only)
       if: github.event_name == 'release'
       uses: actions/attest-build-provenance@v1
       with:
         subject-path: target/${{ matrix.sys.target }}/release/${{ matrix.crate.binary }}${{ matrix.sys.ext }}
+
     - name: Compress
       run: |
           cd target/${{ matrix.sys.target }}/release
           tar czvf $NAME.tar.gz ${{ matrix.crate.binary }}${{ matrix.sys.ext }}
+
     - name: Upload to Artifacts
       uses: actions/upload-artifact@v4
       with:
-        name: ${{ env.NAME }}
+        name: ${{ env.NAME }}.tar.gz
         path: 'target/${{ matrix.sys.target }}/release/${{ env.NAME }}.tar.gz'
+
     - name: Upload to Release (release only)
       if: github.event_name == 'release'
       uses: actions/github-script@v7
@@ -92,3 +101,61 @@ jobs:
             name: '${{ env.NAME }}.tar.gz',
             data: fs.readFileSync('target/${{ matrix.sys.target }}/release/${{ env.NAME }}.tar.gz'),
           });
+
+  installer:
+    needs: build
+    runs-on: windows-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup vars
+        run: |
+          version="$(cargo metadata --format-version 1 --no-deps | jq -r '.packages[] | select(.name == "stellar-cli") | .version')"
+          installer_basename="stellar-cli-installer-${version}-x86_64-pc-windows-msvc"
+          echo "VERSION=${version}" >> $GITHUB_ENV
+          echo "STELLAR_CLI_INSTALLER_BASENAME=${installer_basename}" >> $GITHUB_ENV
+          echo "STELLAR_CLI_INSTALLER=${installer_basename}.exe" >> $GITHUB_ENV
+          echo "ARTIFACT_NAME=stellar-cli-${version}-x86_64-pc-windows-msvc.tar.gz" >> $GITHUB_ENV
+
+      - name: Download Artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: ${{ env.ARTIFACT_NAME }}
+
+      - name: Uncompress Artifact
+        run: tar xvf ${{ env.ARTIFACT_NAME }}
+
+      - name: Build Installer
+        shell: powershell
+        run: |
+          $Env:Path += ";C:\Users\$Env:UserName\AppData\Local\Programs\Inno Setup 6"
+          $Env:STELLAR_CLI_VERSION = "${{ env.VERSION }}"
+          ISCC.exe installer.iss
+
+      - name: Build provenance for attestation (release only)
+        if: github.event_name == 'release'
+        uses: actions/attest-build-provenance@v1
+        with:
+          subject-path: ${{ env.STELLAR_CLI_INSTALLER }}
+
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ env.STELLAR_CLI_INSTALLER }}
+          path: Output/stellar-installer.exe
+
+      - name: Upload to Release (release only)
+        if: github.event_name == 'release'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            await github.rest.repos.uploadReleaseAsset({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              release_id: ${{ github.event.release.id }},
+              name: '${{ env.STELLAR_CLI_INSTALLER }}',
+              data: fs.readFileSync('Output/stellar-installer.exe'),
+            });
+
diff --git a/installer.iss b/installer.iss
new file mode 100644
index 000000000..895740ccb
--- /dev/null
+++ b/installer.iss
@@ -0,0 +1,94 @@
+#define STELLAR_CLI_VERSION GetEnv("STELLAR_CLI_VERSION")
+#define STELLAR_CLI_INSTALLER GetEnv("STELLAR_CLI_INSTALLER")
+
+[Setup]
+AppName=Stellar CLI
+AppVersion={#STELLAR_CLI_VERSION}
+DefaultDirName={commonpf}\Stellar CLI
+DefaultGroupName=Stellar CLI
+OutputBaseFilename=stellar-installer
+PrivilegesRequired=admin
+LicenseFile=LICENSE
+UninstallDisplayIcon={app}\stellar.ico
+Compression=lzma
+SolidCompression=yes
+ChangesEnvironment=yes
+
+[Files]
+Source: "stellar.exe"; DestDir: "{app}"
+Source: "stellar.ico"; DestDir: "{app}"
+Source: "LICENSE"; DestDir: "{app}"; Flags: ignoreversion
+
+[Icons]
+; Windows optimizes start menu, and removes the uninstall entry. Unless we
+; specify it twice. 🫠
+Name: "{group}\Uninstall Stellar CLI"; Filename: "{uninstallexe}"
+Name: "{group}\Uninstall Stellar CLI"; Filename: "{uninstallexe}"
+Name: "{group}\Stellar Developer Docs"; Filename: "https://stellar.org/docs"
+
+[Code]
+const EnvironmentKey = 'SYSTEM\CurrentControlSet\Control\Session Manager\Environment';
+
+procedure EnvAddPath(Path: string);
+var
+    Paths: string;
+begin
+    { Retrieve current path (use empty string if entry not exists) }
+    if not RegQueryStringValue(HKEY_LOCAL_MACHINE, EnvironmentKey, 'Path', Paths)
+    then Paths := '';
+
+    { Skip if string already found in path }
+    if Pos(';' + Uppercase(Path) + ';', ';' + Uppercase(Paths) + ';') > 0 then exit;
+
+    { App string to the end of the path variable }
+    Paths := Paths + ';'+ Path +';'
+
+    { Overwrite (or create if missing) path environment variable }
+    if RegWriteStringValue(HKEY_LOCAL_MACHINE, EnvironmentKey, 'Path', Paths)
+    then Log(Format('The [%s] added to PATH: [%s]', [Path, Paths]))
+    else Log(Format('Error while adding the [%s] to PATH: [%s]', [Path, Paths]));
+end;
+
+procedure EnvRemovePath(Path: string);
+var
+    Paths: string;
+    P: Integer;
+begin
+    { Skip if registry entry not exists }
+    if not RegQueryStringValue(HKEY_LOCAL_MACHINE, EnvironmentKey, 'Path', Paths) then
+        exit;
+
+    { Skip if string not found in path }
+    P := Pos(';' + Uppercase(Path) + ';', ';' + Uppercase(Paths) + ';');
+    if P = 0 then exit;
+
+    { Update path variable }
+    Delete(Paths, P - 1, Length(Path) + 1);
+
+    { Overwrite path environment variable }
+    if RegWriteStringValue(HKEY_LOCAL_MACHINE, EnvironmentKey, 'Path', Paths)
+    then Log(Format('The [%s] removed from PATH: [%s]', [Path, Paths]))
+    else Log(Format('Error while removing the [%s] from PATH: [%s]', [Path, Paths]));
+end;
+
+procedure CurStepChanged(CurStep: TSetupStep);
+begin
+    if CurStep = ssPostInstall
+     then EnvAddPath(ExpandConstant('{app}'));
+end;
+
+procedure CurUninstallStepChanged(CurUninstallStep: TUninstallStep);
+begin
+    if CurUninstallStep = usPostUninstall
+    then EnvRemovePath(ExpandConstant('{app}'));
+end;
+
+[UninstallDelete]
+; Remove the Start Menu group
+Type: filesandordirs; Name: "{group}"
+
+; Remove installed files and directory
+Type: files; Name: "{app}\stellar.exe"
+Type: files; Name: "{uninstallexe}"
+Type: files; Name: "{app}\stellar.ico"
+Type: dirifempty; Name: "{app}"
diff --git a/stellar.ico b/stellar.ico
new file mode 100644
index 0000000000000000000000000000000000000000..4bbfa5f04cc650d18b34a9d03d6c5c6193db2213
GIT binary patch
literal 11166
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

literal 0
HcmV?d00001