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

Merge branch 'master' of https://github.com/kiwix/kiwix-js-windows

Browse Source 
Former-commit-id: b653a56dd3c8487d771432010c2690e9d7b627c2 [formerly 5a2465c4011f37fde0c9c54c4bd258c847944711]
Former-commit-id: 9f89cbb5237ad1865869de0785cbc449103c986e
This commit is contained in:
Jaifroid 2019-08-17 16:57:39 +01:00
commit 4d3795fddf
1 changed files with 22 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
AppPackages/README.md
View File

@ -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.