kiwix/kiwix-android
1
0
Fork 0
mirror of https://github.com/kiwix/kiwix-android.git synced 2025-09-08 14:52:13 -04:00
Code Issues Packages Projects Releases Wiki Activity

Light simplification

Browse Source
This commit is contained in:
Emmanuel Engelhart 2025-01-19 16:13:22 +01:00
parent 1f322aa1f9
commit aedfb8dae8
No known key found for this signature in database
GPG Key ID: 120B30D020B553D3
1 changed files with 38 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

71
README.md
View File

@ -69,50 +69,53 @@ available on our website to access the complete set of features.
## App variants ## App variants
Starting from version `3.12.0`, Kiwix now offers two variants of the application: Starting from version `3.12.0`, Kiwix is available in two variants which are slightly different:
1. **PlayStore version:** App ID: `org.kiwix.kiwixmobile`. - [Google Play version](https://android.kiwix.org/) using application id `org.kiwix.kiwixmobile`
2. **Full version:** App ID: `org.kiwix.kiwixmobile.standalone` available on our [official - [Full version](https://download.kiwix.org/release/kiwix-android/) using application id `org.kiwix.kiwixmobile.standalone`
repository](https://download.kiwix.org/release/kiwix-android/).
Both variants have the different app id meaning these are two different apps. ### What are the difference between the two variants?
**What are the difference between these 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 Play Store version has a limitation when it comes to scanning ZIM files from your storage, The Google Play version has a limitation when it comes to scan and
as mentioned in the [Important Notes](https://github.com/kiwix/kiwix-android?tab=readme-ov-file#important-notes). open ZIM files from anywhere in your device storage, as mentioned in
In contrast, the full version of the application can scan storage and load ZIM files directly from the [Important Notes](#important-notes).
other storage locations via the file picker, without requiring them to be copied or moved
to the app-specific directory. While the core functionality of both versions remains the same,
the primary difference lies in the ability to access ZIM files from outside the app-specific directory.
**Why two variants** 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.
To avoid confusion between the Play Store version and the full version, we introduced separate app ### Why two variants?
IDs for each variant.
Using the same app ID for both versions caused conflicts with the Play Store, as it treated them as
the same app. This resulted in scenarios where the Play Store 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. 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).
**How previous full version users move their content in this new app** This separation ensures clarity for users and prevents undesirable
behavior.
For user who are using the previous full version of the application can download the new version of ### How to move content between two variants?
application from our [official repository](https://download.kiwix.org/release/kiwix-android/), and
move the bookmarks by exporting them from the previous version and importing them into new version of the app, the
options are available in the "Settings" screen.
For the already downloaded library move the ZIM files from
"Android/media/org.kiwix.kiwixmobile/" or "Android/data/org.kiwix.kiwixmobile/" from both internal
and SD card to other storage locations before uninstalling the previous full version of the app,
the new version of the application can load your all ZIM files available in your storage location.
You just need to swipe down on the "Library" screen and it will scan your storage and load your all
ZIM files in the application.
The migration is a one-time process. After completing it, you can directly download the new version You can move the bookmarks by exporting and reimporting them. The
of the application from our [official repository](https://download.kiwix.org/release/kiwix-android/), feature is available in the "Settings".
and it will update your current full version of the app when you install it.
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 ## Android permissions needed