mirror of
https://github.com/microsoft/PowerToys.git
synced 2025-01-18 22:43:31 +08:00
Update README.md
This commit is contained in:
parent
571bceb386
commit
889360b5e4
@ -1,47 +1,3 @@
|
||||
# PowerToys installer instructions
|
||||
|
||||
## MSI installer instructions
|
||||
|
||||
1. Install the [WiX Toolset Visual Studio 2019 Extension](https://marketplace.visualstudio.com/items?itemName=RobMensching.WiXToolset).
|
||||
2. Install the [WiX Toolset build tools](https://wixtoolset.org/releases/) in the development machine.
|
||||
3. Open `powertoys.sln`, select the "Release" and "x64" configurations and build the `PowerToysSetup` project.
|
||||
4. The resulting installer will be built to `PowerToysSetup\bin\Release\PowerToysSetup.msi`.
|
||||
|
||||
## MSIX installer instructions
|
||||
|
||||
### One-time tasks
|
||||
|
||||
#### Create and install the 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).
|
||||
1. Open `Developer PowerShell for VS` as an Admin
|
||||
2. Navigate to your repo's `installer\MSIX`
|
||||
3. Run `.\generate_self_sign_cert.ps1`
|
||||
|
||||
**Note:** if you delete the folder, you will have to regenerate the key
|
||||
|
||||
#### Elevate `Developer PowerShell for VS` permissions due to unsigned file
|
||||
`reinstall_msix.ps1` is unsigned, you'll need to elevate your prompt.
|
||||
1. Open `Developer PowerShell for VS` as admin
|
||||
2. Run `Set-ExecutionPolicy -executionPolicy Unrestricted`
|
||||
|
||||
#### Allow Sideloaded apps
|
||||
In order to install the MSIX package without using the Microsoft Store, sideloading apps needs to be enabled. This can be done by enabling `Developer Options > Sideload apps` or `Developer Options > Developer mode`.
|
||||
|
||||
### Building the MSIX package
|
||||
1. Make sure you've built the `Release` configuration of `powertoys.sln`
|
||||
2. Open `Developer PowerShell for VS`
|
||||
3. Navigate to your repo's `installer\MSIX`
|
||||
4. Run `.\reinstall_msix.ps1` from the devenv powershell
|
||||
|
||||
### What reinstall_msix.ps1 does
|
||||
`reinstall_msix.ps1` removes the current PowerToys installation, restarts explorer.exe (to update PowerRename and ImageResizer shell extension), builds `PowerToys-x64.msix` package, signs it with a PowerToys_TemporaryKey.pfx, and finally installs it.
|
||||
|
||||
## Cleanup - Removing all .msi/.msix PowerToys installations
|
||||
```ps
|
||||
$name='PowerToys'
|
||||
Get-AppxPackage -Name $name | select -ExpandProperty "PackageFullName" | Remove-AppxPackage
|
||||
gwmi win32_product -filter "Name = '$name'" -namespace root/cimv2 | foreach {
|
||||
if ($_.uninstall().returnvalue -eq 0) { write-host "Successfully uninstalled $name " }
|
||||
else { write-warning "Failed to uninstall $name." }
|
||||
}
|
||||
```
|
||||
Please go to https://github.com/microsoft/PowerToys/tree/master/doc/devdocs#compile-the-installer for instructions
|
||||
|
Loading…
Reference in New Issue
Block a user