{"id":21189913,"url":"https://github.com/caphyon/advinst-github-action","last_synced_at":"2025-07-10T02:32:20.576Z","repository":{"id":48745728,"uuid":"439016542","full_name":"Caphyon/advinst-github-action","owner":"Caphyon","description":"GitHub action for Advanced Installer tool","archived":false,"fork":false,"pushed_at":"2024-05-24T05:55:07.000Z","size":918,"stargazers_count":25,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-18T06:35:09.434Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Caphyon.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-16T14:22:21.000Z","updated_at":"2024-05-26T12:58:19.000Z","dependencies_parsed_at":"2023-12-18T10:25:01.336Z","dependency_job_id":"faeed926-a8bc-4b9a-813d-7a995149823d","html_url":"https://github.com/Caphyon/advinst-github-action","commit_stats":{"total_commits":38,"total_committers":1,"mean_commits":38.0,"dds":0.0,"last_synced_commit":"674e4212c6c9c62c8e27bf0bdb4d886a9a41ddd8"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Caphyon%2Fadvinst-github-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Caphyon%2Fadvinst-github-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Caphyon%2Fadvinst-github-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Caphyon%2Fadvinst-github-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Caphyon","download_url":"https://codeload.github.com/Caphyon/advinst-github-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225615230,"owners_count":17496942,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-20T18:57:25.836Z","updated_at":"2024-11-20T18:57:26.517Z","avatar_url":"https://github.com/Caphyon.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Advanced Installer GitHub Action\n\nThis action will integrate [Advanced Installer Tool](https://www.advancedinstaller.com) in the GitHub CI/CD workflow. It has the following capabilities:\n\n* Deploy Advanced Installer on the GitHub runner.\n* Build an Advanced Installer project (.AIP)\n\n## Usage\n\nSee [action.yml](action.yml).\n\n```yml\nuses: caphyon/advinst-github-action@main\nwith:\n  advinst-version: '\u003cversion\u003e'\n  advinst-license: '\u003clicense_id\u003e'\n  advinst-enable-automation: '\u003ctrue|false\u003e'\n  aip-path: '\u003caip_project_path\u003e'\n  aip-build-name: '\u003caip_project_build\u003e'\n  aip-package-name: '\u003coutput_package_name\u003e'\n  aip-output-dir: '\u003coutput_package_dir\u003e'\n  aip-commands: |\n    \u003ccommand_1\u003e\n    \u003ccommand_2\u003e\n```\n\nThe input parameters are of two categories:\n\n* Tool Deploy Parameters - their names have format: **advinst-***\n* AIP Project Parameters - their names have format: **aip-***\n\n***IMPORTANT: By specifying only the Tool Parameters you can restrict the action usage to deploy only. You can use it when you plan on using Advanced Installer from  a [PowerShell script](https://www.advancedinstaller.com/user-guide/powershell-automation.html) or build a [Visual Studio project](https://www.advancedinstaller.com/user-guide/ai-ext-vs-project.html).***\n\n### advinst-version\n\nAdvanced Installer version to deploy. If not specified the latest version will be used. For a list of valid versions please see the [versions history](http://www.advancedinstaller.com/version-history.html)\n\nYou can specify a custom download location by using the ***advancedinstaller_url*** environment variable.\n\n### advinst-license\n\nAdvanced Installer license ID. This parameter is optional if you are using a [simple](https://www.advancedinstaller.com/user-guide/tutorial-simple.html) project type.\n\n### advinst-enable-automation\n\nEnable Advanced Installer [PowerShell automation](https://www.advancedinstaller.com/user-guide/powershell-automation.html). This capability needs [Advanced Installer 16.1](https://www.advancedinstaller.com/release-16.1.html) or higher.\n\n### aip-path\n\nThe Advanced Installer project (.AIP) to be built. This is mandatory if for all the other **aip-*** parameters.\n\n### aip-build-name\n\nAdvanced Installer project build to use. E.g. DefaultBuild.\n\n### aip-package-name\n\nOutput package name. Since this option is related to a build, it requires **aip-build-name** to be specified.\n\n### aip-output-dir\n\nResult package location. Since this option is related to a build, it requires **aip-build-name** to be specified.\n\n### aip-commands\n\nAdditional Advanced Installer arguments passed along with the package build command. E.g. SetVersion 1.2.3. For a complete list of supported commands see the [edit commands](https://www.advancedinstaller.com/user-guide/command-line-editing.html).\n\n***IMPORTANT: The the changes made to the AIP file through the edit commands are available only during the pipeline. They will not be stored.***\n\n## Examples\n\n### 1. Deploy tool and build an aip project\n\n```yml\nname: Build Advanced Installer Project (.AIP)  Demo\non: [workflow_dispatch]\njobs:\n  advinst-aip-build-demo:\n    runs-on: windows-latest\n    name: Build Aip Demo\n    steps:\n      - name: Check out repository code\n        uses: actions/checkout@v2\n      - name: Build AIP\n        uses: caphyon/advinst-github-action@main\n        with:\n          advinst-version: '19.0'\n          advinst-license: ${{ secrets.ADVINST_LICENSE_KEY }}\n          advinst-enable-automation: 'true'\n          aip-path: ${{ github.workspace }}\\arhitect.aip\n          aip-build-name: DefaultBuild\n          aip-package-name: setup.msi\n          aip-output-dir:  ${{ github.workspace }}\\setup\n          aip-commands: |\n            SetProperty FOO=\"foo\"\n            SetVersion 1.2.0\n      - name: Publish setup artifact\n        uses: actions/upload-artifact@v2\n        with:\n          name: setup\n          path: ${{ github.workspace }}\\setup\\setup.msi\n```\n\n### 2. Deploy tool and build aip project using PowerShell commands\n\n```yml\nname: Powershell Automation Demo\non: [workflow_dispatch]\njobs:\n  advinst-com-demo:\n    runs-on: windows-latest\n    name: Advinst Automation Demo\n    steps:\n      - name: Check out repository code\n        uses: actions/checkout@v2\n      - name: Deploy Advinst\n        uses: caphyon/advinst-github-action@main\n        with:\n          advinst-version: '19.0'\n          advinst-license: ${{ secrets.ADVINST_LICENSE_KEY }}\n          advinst-enable-automation: 'true'\n      - name: Use Advinst Automation\n        shell: pwsh\n        run: |\n          # Load the AIP project from checkout location\n          $aipPath = join-path $env:GITHUB_WORKSPACE \"simple.aip\";\n          Write-Host \"AIP: $aipPath\";\n          $advinst = new-object -com advancedinstaller;\n          $project = $advinst.LoadProject($aipPath);\n          $productDetails = $project.ProductDetails;\n          # Bump the ProductVersion\n          $productDetails.Version = \"1.2.0\";\n          Write-Host \"Version: $productDetails.Version\";\n          # Build the project\n          $project.Build();\n```\n\n### 3. Deploy tool and build an Advanced Installer Visual Studio project (.AIPROJ)\n\n```yml\nname: Build AIPROJ Demo\non: [workflow_dispatch]\njobs:\n  aiproj-demo:\n    runs-on: windows-latest\n    name: Build Visual Studio Project (aiproj)\n    steps:\n      - name: Check out repository code\n        uses: actions/checkout@v2\n      - name: Deploy Advinst\n        uses: caphyon/advinst-github-action@main\n        with:\n          advinst-version: '19.0'\n          advinst-license: ${{ secrets.ADVINST_LICENSE_KEY }}\n      - name: Add msbuild to PATH\n        uses: microsoft/setup-msbuild@v1.1\n      - name: Build app for release\n        run: msbuild ${{ github.workspace }}\\MyAwesomeApp\\MyAwesomeApp.sln\n```\n\n### How To Use\n\nFor more examples on how to use this action in various scenarios checkout our [actions playground repo](https://github.com/Caphyon/github-actions-playground/tree/main/.github/workflows).\n\n### Contact us\n\nWe would love to hear your feedback! Tell us how to improve this action at ***support at advancedinstaller dot com***, or\nopen a [Github Issue](https://github.com/Caphyon/advinst-github-action/issues).\n\nOn our website you can find a list with all the [CI/CD integrations for Advanced Installer](https://www.advancedinstaller.com/installer-continuous-integration.html).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaphyon%2Fadvinst-github-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaphyon%2Fadvinst-github-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaphyon%2Fadvinst-github-action/lists"}