diff --git a/AppPackages/README.md b/AppPackages/README.md index 1524eccf..f2830bfb 100644 --- a/AppPackages/README.md +++ b/AppPackages/README.md @@ -9,7 +9,8 @@ procedure: ## Windows 10 Mobile Download the .appx or .appxbundle under AppPackages/KiwixWebApp_0.x.x.x_[AnyCPU]_Test/ and save it in -your downloads folder, or other accessible folder, on the phone. Instead of one of the packages above, +your downloads folder, or other accessible folder, on the phone. NB DO NOT DOWNLOAD the .appxupload files +you see above, as these are useless for installation. Instead of one of the packages above, you may prefer to use an .appxbundle from https://github.com/kiwix/kiwix-js-windows/releases (they are the same). Enable Developer mode on your device (Settings / Updates and security / For developers). Open the File Explorer on the phone, navigate to the downloads folder and tap the KiwixWebApp bundle. @@ -18,19 +19,27 @@ it can take a minute or so for the Kiwix icon to appear in the All Apps list. Yo a ZIM file to use with the app (see below). ## Windows 10 Tablet / PC -You may be able to use the built-in App Installer. If the build is signed (builds intended for the -Microsoft Store) and you have Windows 10 Fall Creators Update, then download the .appx or .appxbundle -under AppPackages/KiwixWebApp_0.x.x.x_[AnyCPU]_Test/ and save it in your downloads folder, or other -accessible folder. Instead of one of the packages above, you may prefer to use an .appxbundle from -https://github.com/kiwix/kiwix-js-windows/releases (they are the same). Open the folder, right-click the -file and select "Open". The installer should load and allow you to install the app. +You must first put your PC in Developer mode: Settings / Update and security / For developers. It is not enough +to select "Sideload", as these packages require "Developer mode". Your device may need to download a developer +package, install it, and restart. -If the above procedure fails, or for unsigned builds, then you will need to sideload with the PowerShell -script. First turn on Developer mode: Settings / Update and security / For developers. Download the full -AppPackages/KiwixWebApp_0.x.x.x[_AnyCPU]_Test/ folder that you wish to test to your PC (you can use -https://minhaskamal.github.io/DownGit to do this). Open the folder in File Explorer, Right-click the -Add-AppDevPackage.ps1 inside the folder and choose to run with PowerShell. You may be prompted to install -the developer's certificate. +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` + +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). 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. 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. ## Download a ZIM archive (all platforms) You will need a ZIM file to work with this app. For testing, it comes packaged with the Ray Charles ZIM.