mirror of
https://github.com/microsoft/PowerToys
synced 2024-11-22 00:03:48 +00:00
[Docs] Add msix embedding instructions (#13489)
This commit is contained in:
parent
5696f22951
commit
34e81fdf87
30
doc/devdocs/embedded-msix.md
Normal file
30
doc/devdocs/embedded-msix.md
Normal file
@ -0,0 +1,30 @@
|
|||||||
|
# How to integrate new MSIX module with PowerToys Settings and WiX installer
|
||||||
|
[`issue_11705_with_example` branch](https://github.com/microsoft/PowerToys/tree/issue_11705_with_example) contains HelloWorld UWP C# MSIX application which reads its module settings and is installed along PowerToys.
|
||||||
|
|
||||||
|
## Steps
|
||||||
|
- uncomment everything near "TODO: Use to activate embedded MSIX" comments
|
||||||
|
- build PowerToys solution
|
||||||
|
- deploy HelloModule module and sign it with a self-signed certificate (don't forget to put it into a trusted store)
|
||||||
|
- build PowerToysSetup solution and install it
|
||||||
|
|
||||||
|
Type HelloModule into start search and observe that it was installed:
|
||||||
|
|
||||||
|
<img src="../images/msix/hello-module-start.png">
|
||||||
|
|
||||||
|
Open PowerToys settings and change the stub setting to something:
|
||||||
|
|
||||||
|
<img src="../images/msix/hello-module-settings-page.png">
|
||||||
|
|
||||||
|
Open HelloModule:
|
||||||
|
|
||||||
|
<img src="../images/msix/hello-module-screen.png">
|
||||||
|
|
||||||
|
First time you press "Load Settings", it'll detect that it doesn't have permissions to access local file system and open its system settings window, toggle it there:
|
||||||
|
|
||||||
|
<img src="../images/msix/hello-module-app-permissions.png">
|
||||||
|
|
||||||
|
(it's a known uwp limitation, see https://stackoverflow.com/a/53533414/657390)
|
||||||
|
|
||||||
|
HelloModule will close then, restart it, press "Load Settings" and you should see that the application was able to load the setting string which was set by the settings app:
|
||||||
|
|
||||||
|
<img src="../images/msix/hello-module-loaded-settings.png">
|
BIN
doc/images/msix/hello-module-app-permissions.png
Normal file
BIN
doc/images/msix/hello-module-app-permissions.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 18 KiB |
BIN
doc/images/msix/hello-module-loaded-settings.png
Normal file
BIN
doc/images/msix/hello-module-loaded-settings.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 33 KiB |
BIN
doc/images/msix/hello-module-screen.png
Normal file
BIN
doc/images/msix/hello-module-screen.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 29 KiB |
BIN
doc/images/msix/hello-module-settings-page.png
Normal file
BIN
doc/images/msix/hello-module-settings-page.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 67 KiB |
BIN
doc/images/msix/hello-module-start.png
Normal file
BIN
doc/images/msix/hello-module-start.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 9.9 KiB |
Loading…
Reference in New Issue
Block a user