kiwix/kiwix-js-pwa
1
0
Fork 0
mirror of https://github.com/kiwix/kiwix-js-pwa.git synced 2025-09-16 07:46:58 -04:00
Code Issues Packages Projects Releases Wiki Activity

Update sideloading instructions

Browse Source 
Former-commit-id: 37a072c262fd31e292f8de5c206ee4bf3211cc8c [formerly 22e12040fed6f30396a2d0d5c55bf3d974ea3b0f] [formerly 8d743288e6ac62f5d656a58e7905941fe74db1d7] [formerly b9d6af6daf4e96eb1ad1820a90be6295d859df1a [formerly c78d7669e9c0750ec36fc46c8126b6a4eda79887 [formerly 08c265bddb44d40f0bd8f5587c2f8d811d87c95e]]]
Former-commit-id: e8d70baeaa2b4e2faefcaf089602ff42037fb1f3 [formerly 8ace9b3bcc3a7074f85c38af14ea34c7d3cbe924 [formerly 452ab3fcace02352176739dd4bac15972e613f62]]
Former-commit-id: 92ca16016ff79ee03a944a712748a34e1aef2c79 [formerly 5a5113c0efd052d17977fbd48a9dbd1fb57d834c]
Former-commit-id: 31f93fea894042325c01f99b28a4fc1094c9b1c5
This commit is contained in:
Jaifroid 2021-02-27 10:21:49 +00:00
parent 7cf6e78f9e
commit 8c8892c30c
1 changed files with 4 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
AppPackages/README.md
View File

@ -11,8 +11,9 @@ If you prefer not to (or cannot) use the Microsoft Store or wish to test a diffe
Starting in Windows 10 version 2004, **sideloading is enabled by default** and you can install apps by double-clicking signed app packages. Starting in Windows 10 version 2004, **sideloading is enabled by default** and you can install apps by double-clicking signed app packages.
On Windows 10 version 1909 and earlier, sideloading requires some additional configuration. On Windows 10 version 1909 and earlier, sideloading requires some additional configuration.
* **Simple procedure**: Just launch your package! The Kiwix JS Windows packages are signed: you can download an `.appxbundle` above inside `AppPackages/KiwixWebApp_0.x.x.x_[AnyCPU]_Test/` folders, and launch it by double-clicking. * **Simple procedure**: Just launch your package! The Kiwix JS Windows packages downloadable from [Releases](https://github.com/kiwix/kiwix-js-windows/releases/) are signed. Download the `.appxbundle` from the Assets section of a Release and launch it by double-clicking.
* You may be prompted to allow sideloading, or you may need to enable it first on version 1909 or earlier: go to Settings -> Update and security -> For developers. * If you wish to test an unsigned package, find an `.appxbundle` above inside `AppPackages/KiwixWebApp_x.x.x.x_[AnyCPU]_Test/` folders, and try to launch it by double-clicking.
* You may be prompted to allow sideloading, or you may need to enable it first on version 1909 or earlier: go to Settings -> Update and security -> For developers. If this doesn't work, follow procedure below.
* **You will need a ZIM archive to use the full features of this app** - [see below](#download-a-zim-archive-all-platforms). * **You will need a ZIM archive to use the full features of this app** - [see below](#download-a-zim-archive-all-platforms).
**_If above procedure fails_**, the package may not be a signed one, or else you have an even older version of Windows 10. In this case, follow the more complex procedure below: **_If above procedure fails_**, the package may not be a signed one, or else you have an even older version of Windows 10. In this case, follow the more complex procedure below:
@ -21,7 +22,7 @@ On Windows 10 version 1909 and earlier, sideloading requires some additional con
* Then, launch a PowerShell command window: press Windows key and type PowerShell, right-click and "Run as Administrator". * Then, launch a PowerShell command window: press Windows key and type PowerShell, right-click and "Run as Administrator".
* Type the following command: `Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser` * Type the following command: `Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser`
* Accept the warnings and ensure the script finished correctly. (The above steps are one-time only: you shouldn't need to repeat them to install future builds.) * Accept the warnings and ensure the script finished correctly. (The above steps are one-time only: you shouldn't need to repeat them to install future builds.)
* Now go to the latest `AppPackages/KiwixWebApp_0.x.x.x_[AnyCPU]_Test/` folder above and download **all** the files in the folder and subfolder. You can either do this by cloning the repository, or you can use https://minhaskamal.github.io/DownGit to download a zipped version of the folder (recommended). * Now go to the latest `AppPackages/KiwixWebApp_x.x.x.x_[AnyCPU]_Test/` folder above and download **all** the files in the folder and subfolder. You can either do this by cloning the repository, or you can use https://minhaskamal.github.io/DownGit to download a zipped version of the folder (recommended).
* Unzip in your downloads folder, or other accessible folder. Ensure the directory structure is intact. * Unzip in your downloads folder, or other accessible folder. Ensure the directory structure is intact.
* Now you can right-click `Add-AppDevPackage.ps1` and select `Run with PowerShell`. This is the simplest method to install the certificate and the app at the same time. * Now you can right-click `Add-AppDevPackage.ps1` and select `Run with PowerShell`. This is the simplest method to install the certificate and the app at the same time.
* If you see a red message flash, and the window closes, then go to your PowerShell terminal, navigate to the folder containing the script, and type `.\Add-AppDevPackage.ps1` (NB the `.\` is important). Observe and follow instructions to address the issue. * If you see a red message flash, and the window closes, then go to your PowerShell terminal, navigate to the folder containing the script, and type `.\Add-AppDevPackage.ps1` (NB the `.\` is important). Observe and follow instructions to address the issue.