Installing#
If the HIP-VS package is already installed, its repeated installation is possible only after the uninstallation of HIP-VS from the target Visual Studio.
Installing by the wizard#
1. Run an appropriate HIPExtension .vsix package for your target Visual Studio and follow the VSIX installer’s instructions. Any of the Visual Studio instances must not be running during the HIP-VS installation process.
Installing in shell#
Before starting an installation process, all instances of Visual Studio should be closed, and all msbuild or devenv building or testing processes should be stopped.
1. Change the current directory to the Release subfolder of the target HIPExtension:
cd %HIP-VS%\extension\HIPExtension.20XX\bin\Release
where XX is 17, 19, or 22.
2. Run installation of the target *.vsix from the command line.
Installing in shell for VS 2017#
"c:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\VSIXInstaller.exe" /a /q HIPExtension2017.vsix
Installing in shell for VS 2019#
"c:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\VSIXInstaller.exe" /a /q HIPExtension2019.vsix
Installing in shell for VS 2022#
"c:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\VSIXInstaller.exe" /a /q HIPExtension2022.vsix
The installation process lasts from a few seconds to a few minutes depending on the system’s hardware and environment.
For a successful installation, the return code of the VSIXInstaller.exe should be equal to 0.
The return code might be checked by the %errorlevel% variable directly after one of the above commands for VSIXInstaller.exe launching.
The main reason why vsix is not installed (the return code doesn’t equal 0) is the former process blocking the installation.
It might be msbuild.exe, devenv.exe, and some dependent processes. They should be stopped; restarting the system is also a solution.