From 75a3fc04761b4df9c13c73c7af51882739e31491 Mon Sep 17 00:00:00 2001 From: Jaifroid Date: Sat, 17 Aug 2019 16:34:20 +0100 Subject: [PATCH] Update README.md Clearer instructions for installing with PowerShell script. Former-commit-id: 36445631154beb529d4f40111c145ba45ea8016a [formerly bfa4561d6b79a8c35297c00d2762a240673f27e7] Former-commit-id: 7e1861525948822d2f816104ae6101cae45d725e --- AppPackages/README.md | 35 ++++++++++++++++++++++------------- 1 file changed, 22 insertions(+), 13 deletions(-) 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.