mirror of
https://github.com/kiwix/kiwix-android.git
synced 2025-09-08 23:07:26 -04:00
Merge pull request #4172 from kiwix/Fixes#4146
Added a section in the README file to showcase the two variants of our application.
This commit is contained in:
commit
1ec8f2cd00
50
README.md
50
README.md
@ -67,6 +67,56 @@ necessary to comply with the Play Store policies and ensure a smooth
|
||||
user experience. We recommend using the official version of the app
|
||||
available on our website to access the complete set of features.
|
||||
|
||||
## App variants
|
||||
|
||||
Starting from version `3.12.0`, Kiwix is available in two variants which are slightly different:
|
||||
|
||||
- [Google Play version](https://android.kiwix.org/) using application id `org.kiwix.kiwixmobile`
|
||||
- [Full version](https://download.kiwix.org/release/kiwix-android/) using application id `org.kiwix.kiwixmobile.standalone`
|
||||
|
||||
### What are the difference between the two variants?
|
||||
|
||||
While the core functionalities remain the same, the primary difference
|
||||
lies in the ability to access ZIM files located outside the (Kiwix)
|
||||
reserved app directories.
|
||||
|
||||
The Google Play version has a limitation when it comes to scan and
|
||||
open ZIM files from anywhere in your device storage, as mentioned in
|
||||
the [Important Notes](#important-notes).
|
||||
|
||||
In contrast, the full version of the application can load (and scan
|
||||
for) ZIM files directly from other storage locations via the file
|
||||
picker... without requiring them to be copied or moved to the reserved
|
||||
app directories.
|
||||
|
||||
### Why two variants?
|
||||
|
||||
To avoid confusion between the Google Play version and the full
|
||||
version, we introduced dedicated application ids (one for each
|
||||
variant). Using the same application id for both versions caused
|
||||
conflicts with the Google Play Store, as it treated them as the same
|
||||
app. This resulted in scenarios where Google Play would prompt updates
|
||||
for the full version. If users updated through the Play Store, they
|
||||
would lose advanced file management capabilities (such as scanning
|
||||
storage or directly opening ZIM files using the file picker).
|
||||
|
||||
This separation ensures clarity for users and prevents undesirable
|
||||
behavior.
|
||||
|
||||
### How to move content between two variants?
|
||||
|
||||
You can move the bookmarks by exporting and reimporting them. The
|
||||
feature is available in the "Settings".
|
||||
|
||||
Regarding ZIM files, you should move them to - or from - the reserved
|
||||
app directories `Android/media/org.kiwix.kiwixmobile/` or
|
||||
`Android/data/org.kiwix.kiwixmobile/`. This might have to be done for
|
||||
both internal storage and SD card.
|
||||
|
||||
Kiwix can detect automatically all ZIM files available in your
|
||||
storage. You just need to swipe down in the local "Library" screen and
|
||||
it will scan your storage and recognize all your ZIM files.
|
||||
|
||||
## Android permissions needed
|
||||
|
||||
Kiwix requires the following permissions to fully work:
|
||||
|
Loading…
x
Reference in New Issue
Block a user