{"id":14063389,"url":"https://github.com/bovender/VstoAddinInstaller","last_synced_at":"2025-07-29T15:32:59.241Z","repository":{"id":54971172,"uuid":"44609834","full_name":"bovender/VstoAddinInstaller","owner":"bovender","description":"Generic InnoSetup script to install VSTO add-ins.","archived":false,"fork":false,"pushed_at":"2018-09-05T16:41:29.000Z","size":207,"stargazers_count":62,"open_issues_count":2,"forks_count":18,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-12-04T01:33:54.592Z","etag":null,"topics":["inno-setup","innosetup-preprocessor","office","visual-studio","vsto"],"latest_commit_sha":null,"homepage":null,"language":"Pascal","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bovender.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-10-20T13:56:03.000Z","updated_at":"2024-11-30T18:44:05.000Z","dependencies_parsed_at":"2022-08-14T07:50:23.818Z","dependency_job_id":null,"html_url":"https://github.com/bovender/VstoAddinInstaller","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/bovender/VstoAddinInstaller","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bovender%2FVstoAddinInstaller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bovender%2FVstoAddinInstaller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bovender%2FVstoAddinInstaller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bovender%2FVstoAddinInstaller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bovender","download_url":"https://codeload.github.com/bovender/VstoAddinInstaller/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bovender%2FVstoAddinInstaller/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267709609,"owners_count":24131922,"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","status":"online","status_checked_at":"2025-07-29T02:00:12.549Z","response_time":2574,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["inno-setup","innosetup-preprocessor","office","visual-studio","vsto"],"created_at":"2024-08-13T07:03:18.993Z","updated_at":"2025-07-29T15:32:58.878Z","avatar_url":"https://github.com/bovender.png","language":"Pascal","funding_links":[],"categories":["Pascal"],"sub_categories":[],"readme":"VstoAddinInstaller\r\n===================\r\n\r\n[InnoSetup][] script to install and activate Visual Studio Tools for\r\nOffice\u0026reg; (VSTO) addins. VstoAddinInstaller makes heavy use of the\r\nInnoSetup Preprocessor (ISPP).\r\n\r\nFeatures\r\n--------\r\n\r\n- Installs Word\u0026reg;, Excel\u0026reg;, PowerPoint\u0026reg;, or Outlook\u0026reg;\r\n  add-ins.\r\n- Downloads and installs .NET and VSTO runtimes if needed.\r\n- Checks if the target application is currently running and can\r\n  automatically shut it down before proceeding with the installation\r\n  process.\r\n- Can be used with an `/UPDATE` switch to silently shut down and\r\n  restart the target application after the installation.\r\n- Modular structure makes it easy to keep custom configuration\r\n  separate from the core functionality.\r\n\r\nThe script is based on the installer used by [Daniel's XL Toolbox][].\r\n\r\n\r\nRequirements\r\n------------\r\n\r\n- [InnoSetup][] with InnoSetup Preprocessor; ideally you would obtain\r\n  the InnoSetup QuickStart Pack.\r\n- [InnoSetup Download Plugin][isdp] (takes care of downloading the\r\n  .NET and VSTO runtime installers on the target system, if needed)\r\n- Visual Studio with Visual Studio Tools for Office (VSTO) (included\r\n  in the 'Professional' editions).\r\n\r\nSome of these requirements should be fairly obvious...\r\n\r\n\r\nInstructions for use\r\n--------------------\r\n\r\nVstoAddinInstaller is designed to keep itself out of your way: After\r\ndownloading and extracting the [archive][zip] (or cloning the [Git][]\r\nrepository), you should have a dedicated folder 'VstoAddinInstaller'\r\nin your solution directory. You won't have to edit anything inside the\r\nVstoAddinInstaller directory. A configuration file can be copied from\r\nan example file `make-installer.dist.iss` from the `config-dist`\r\nsubdirectory to your solution's directory, where you may want to\r\ninclude it in your own version control system.\r\n\r\nA recommended folder structure is as follows:\r\n\r\n        YourSolutionFolder\r\n        ├── deploy                  \u003c-- custom folder, name it whatever you like\r\n        │   ├── make-installer.iss  \u003c-- your custom config file for VstoAddinInstaller\r\n        │   ├── VstoAddinInstaller  \u003c-- VstoAddinInstaller, e.g. as Git submodule\r\n        │   │   ├── config-dist\r\n        │   │   │   ├── make-installer.dist.iss  \u003c-- template for your make-installer.iss\r\n        │   │   │   └── ...\r\n        │   │   └── ...\r\n        │   ├── setup-files         \u003c-- additional files, such as a license file\r\n        │   │   └── ...\r\n        │   └── releases            \u003c-- where the installer will be written to\r\n        │       └── ...\r\n        ├── YourProject\r\n        │   ├── bin\r\n        │   │   ├── Debug\r\n        │   │   │   ├── YourProject.vsto   \u003c-- generated by Visual Studio\r\n        │   │   │   └── ...\r\n        │   │   └── Release\r\n        │   │       ├── YourProject.vsto   \u003c-- generated by Visual Studio\r\n        │   │       └── ...\r\n        │   ├── YourProject.csproj\r\n        │   └── ...\r\n        ├── VERSION.TXT             \u003c-- text file containing the version number (optional)\r\n        └── ...\r\n\r\n\r\n### Cloning as Git submodule\r\n\r\nIf you use [Git][] as your version control, you can clone the\r\nVstoAddinInstaller respository into a submodule of your project\r\nrepository:\r\n\r\n    git submodule add git@github.com:bovender/VstoAddinInstaller.git\r\n\r\nYou can then easily update the VstoAddinInstaller module by *changing\r\ninto the directory* and issuing\r\n\r\n    git pull\r\n\r\nBecause the entire VstoAddinInstaller repository is contained in the\r\nsubmodule, you can switch between branches and use the `develop`\r\nbranch rather than the `master` branch if you wish to do so.\r\n\r\n\r\n### Configuring\r\n\r\nYou need to make a copy of `config-dist\\make-installer.dist.iss` and\r\nedit the contents. Ideally you would keep your copy of this file\r\noutside the `VstoAddinInstaller` directory, as shown above, so it does\r\nnot get overwritten when you update VstoAddinInstaller.\r\n\r\nYou can rename the file to `make-installer.iss` or whatever you wish;\r\nthe `.dist` part in the original file only serves to indicate that\r\nthis is the distributed example file.\r\n\r\nFollow along the instructions in your copy of\r\n`make-installer.dist.iss`.\r\n\r\n**Important**: Each installer produced with InnoSetup must have its\r\nown global unique identifier (GUID). Please insert your own GUID where\r\nindicated. You can generate a GUID using the corresponding command\r\nfrom the `Tools` menu in InnoSetup Studio, for example.\r\n\r\n\r\n### Compiling the installer\r\n\r\nTo compile the installer, simply run your copy of `make-installer.iss`\r\nthrough InnoSetup.\r\n\r\n\r\n### Extending\r\n\r\nIf you wish to add additional capabilities to your installer (e.g.\r\nInnoSetup tasks), have a look in the `config-dist` directory where you\r\nwill find some example files.\r\n\r\nCurrently it is not possible to run additonal code during\r\ninitialization of setup (`InitializeSetup`) or initialization of the\r\nwizard (`InitializeWizard`). I have been thinking about how to provide\r\nthis capability, but have not yet have the time to implement it.\r\n\r\n\r\nDemos\r\n-----\r\n\r\nDemo projects are contained in the [demo](demo/) directory.\r\n\r\nIn order to try out these demo installers, you must first build the\r\ncorresponding projects in Visual Studio. The binaries are not contained\r\nin this repository!\r\n\r\n\r\nFurther information\r\n-------------------\r\n\r\nFor background information on the prerequisites of a VSTO add-in, see\r\n\u003chttps://www.xltoolbox.net/blog/2015-01-30-net-vsto-add-ins-getting-prerequisites-right.html\u003e.\r\n\r\n\r\nRelated\r\n-------\r\n\r\nThis script is based on the related [ExcelAddinInstaller][eai].\r\n\r\n\r\nVersioning\r\n----------\r\n\r\nVstoAddinInstaller is [semantically versioned][semver] using Git tags.\r\n\r\nIn short: The version number follows the scheme `MAJOR.MINOR.PATCH`.\r\n\r\n- An increase in the `MAJOR` version number signifies API-breaking\r\n  changes, i.e., if you decide to upgrade, you *must* adjust your local\r\n  copy of `make-install.iss`.\r\n- An increase in the `MINOR` version number denotes new or improved\r\n  features. You can upgrade without adjusting your `make-install.iss`.\r\n- The `PATCH` number is increased with bug fixes. Again, no need to edit\r\n  your copy of `make-install.iss`.\r\n\r\n \r\nContributing\r\n------------\r\n\r\nYou are welcome to submit pull requests for this project. I like to \r\nfollow [Vincent Drieessen's Git branching model][nvie] where development \r\ntakes place on the `develop` branch, and the `master` branch always \r\npoints to the latest stable release.\r\n\r\nTherefore, I would like to ask you to issue your pull request against \r\nthe `develop` branch.\r\n\r\n\r\nLicense\r\n-------\r\n\r\nPublished under the [Apache License, Version 2.0](LICENSE).\r\n\r\n        Copyright (C) 2016-2018 Daniel Kraus (bovender) \u003chttps://github.com/bovender\u003e\r\n\r\n        Licensed under the Apache License, Version 2.0 (the \"License\");\r\n        you may not use this file except in compliance with the License.\r\n        You may obtain a copy of the License at\r\n\r\n        http://www.apache.org/licenses/LICENSE-2.0\r\n\r\n        Unless required by applicable law or agreed to in writing, software\r\n        distributed under the License is distributed on an \"AS IS\" BASIS,\r\n        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\n        See the License for the specific language governing permissions and\r\n        limitations under the License.\r\n\r\nMicrosoft®, Windows®, Office, and Excel\u0026reg;, PowerPoint\u0026reg;, and\r\nOutlook\u0026reg; are either registered trademarks or trademarks of Microsoft\r\nCorporation in the United States and/or other countries.  \r\n\r\n[InnoSetup]: http://www.jrsoftware.org/isinfo.php\r\n[isdp]: http://mitrichsoftware.wordpress.com\r\n[Daniel's XL Toolbox]: https://www.xltoolbox.net\r\n[ZIP]: https://github.com/bovender/VstoAddinInstaller/archive/master.zip\r\n[Git]: http://git-scm.com/downloads\r\n[eai]: https://github.com/bovender/ExcelAddinInstaller\r\n[semver]: http://semver.org\r\n[nvie]: http://nvie.com/posts/a-successful-git-branching-model\r\n\r\n\u003c!-- vim: set tw=72 ts=4 :--\u003e\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbovender%2FVstoAddinInstaller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbovender%2FVstoAddinInstaller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbovender%2FVstoAddinInstaller/lists"}