Mirrors/PowerToys
1
0
Fork 0
mirror of https://github.com/microsoft/PowerToys.git synced 2025-12-16 11:48:06 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md (#1198)

Browse Source
This commit is contained in:
Clint Rutkas
2020-01-31 18:17:07 -08:00
committed by GitHub
parent b00ce8789f
commit 4ef8f3da2b
1 changed files with 14 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
installer/README.md
View File

@@ -1,30 +1,30 @@
# PowerToys Setup Project # PowerToys MSIX installer instructions
## MSIX instructions ## One-time tasks
### 1-time Run ### Create and install the self-sign certificate
#### Create Self-sign certificate
For the first-time installation, you'll need to generate a self-signed certificate. The script below will generate and add a cert to your [TRCA store](https://docs.microsoft.com/en-us/windows-hardware/drivers/install/trusted-root-certification-authorities-certificate-store). For the first-time installation, you'll need to generate a self-signed certificate. The script below will generate and add a cert to your [TRCA store](https://docs.microsoft.com/en-us/windows-hardware/drivers/install/trusted-root-certification-authorities-certificate-store).
1. Open `Developer PowerShell for VS` as an Admin 1. Open `Developer PowerShell for VS` as an Admin
2. Navigate to your repo's `installer\MSIX` 2. Navigate to your repo's `installer\MSIX`
3. Run `.\generate_self_sign_cert.ps1` 3. Run `.\generate_self_sign_cert.ps1`
#### Elevate `Developer PowerShell for VS` permissions **Note:** if you delete the folder, you will have to regenerate the key
### Elevate `Developer PowerShell for VS` permissions due to unsigned file
`msix_reinstall.ps1` is unsigned, you'll need to elevate your prompt. `msix_reinstall.ps1` is unsigned, you'll need to elevate your prompt.
1. Open `Developer PowerShell for VS` as admin 1. Open `Developer PowerShell for VS` as admin
2. Run `Set-ExecutionPolicy -executionPolicy Unrestricted` 2. Run `Set-ExecutionPolicy -executionPolicy Unrestricted`
### To Build MSIX ## To Build MSIX
1. Make sure you've built the `Release` configuration of `powertoys.sln` 1. Make sure you've built the `Release` configuration of `powertoys.sln`
2. Open `Developer PowerShell for VS` 2. Open `Developer PowerShell for VS`
3. Navigate to your repo's `installer\MSIX` 3. Navigate to your repo's `installer\MSIX`
4. Run `.\msix_reinstall.ps1` from the devenv powershell 4. Run `.\msix_reinstall.ps1` from the devenv powershell
#### What msix_reinstall.ps1 does ### What msix_reinstall.ps1 does
`msix_reinstall.ps1` removes the current PowerToys installation, restarts explorer.exe (to update PowerRename shell extension), builds `PowerToys-x64.msix` package, signs it with a PowerToys_TemporaryKey.pfx, and finally installs it. `msix_reinstall.ps1` removes the current PowerToys installation, restarts explorer.exe (to update PowerRename shell extension), builds `PowerToys-x64.msix` package, signs it with a PowerToys_TemporaryKey.pfx, and finally installs it.
#### Removing all .msi/.msix PowerToys installations ### Removing all .msi/.msix PowerToys installations
```ps ```ps
$name='PowerToys' $name='PowerToys'
Get-AppxPackage -Name $name | select -ExpandProperty "PackageFullName" | Remove-AppxPackage Get-AppxPackage -Name $name | select -ExpandProperty "PackageFullName" | Remove-AppxPackage
@@ -34,8 +34,8 @@ gwmi win32_product -filter "Name = '$name'" -namespace root/cimv2 | foreach {
} }
``` ```
## MSI Build instructions (Deprecated) # MSI Build instructions (Deprecated)
* Install the [WiX Toolset Visual Studio 2019 Extension](https://marketplace.visualstudio.com/items?itemName=RobMensching.WiXToolset). 1. Install the [WiX Toolset Visual Studio 2019 Extension](https://marketplace.visualstudio.com/items?itemName=RobMensching.WiXToolset).
* Install the [WiX Toolset build tools](https://wixtoolset.org/releases/) in the development machine. 2. Install the [WiX Toolset build tools](https://wixtoolset.org/releases/) in the development machine.
* Open `powertoys.sln`, select the "Release" and "x64" configurations and build the `PowerToysSetup` project. 3. Open `powertoys.sln`, select the "Release" and "x64" configurations and build the `PowerToysSetup` project.
* The resulting installer will be built to `PowerToysSetup\bin\Release\PowerToysSetup.msi`. 4. The resulting installer will be built to `PowerToysSetup\bin\Release\PowerToysSetup.msi`.