From 215f338812227553874d84b9c5296c985343d80b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martina=20Posp=C3=AD=C5=A1ilov=C3=A1?= Date: Sun, 25 Apr 2021 17:12:26 +0200 Subject: [PATCH 1/3] Reformulate prerequisites to bullet points Bullet points are easier to read. It's also better to start with the info which Android version the user needs and then tell them why (or additional info). --- odkx-src/basics-install.rst | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/odkx-src/basics-install.rst b/odkx-src/basics-install.rst index 46c83536..9a532203 100644 --- a/odkx-src/basics-install.rst +++ b/odkx-src/basics-install.rst @@ -8,15 +8,10 @@ These instructions describe the steps to install the ODK-X basic tools on a tabl Prerequisites ------------------- -You must have an Android tablet with an operating system version 4.4 or higher. - -If you are working on a Windows/Mac/Linux machine, you can use `Android Studio `_ to launch an Android emulator for testing purposes. - -Please note that ODK-X Services version 2.1.7 doesn't work on Android 11. You will need Android 10 with API level less than 30 for version 2.1.7. - -Before installing any of the ODK-X tools, you will need the following third party app: - - - `OI File Manager `_ +- An Android tablet with an operating system version 4.4 or higher. If you are working on a Windows/Mac/Linux machine, you can use `Android Studio `_ to launch an Android emulator for testing purposes. +- Android 10 with API level less than 30 for version 2.1.7. + Please note that ODK-X Services version 2.1.7 doesn't work on Android 11. +- The following third party app: `OI File Manager `_. Required ~~~~~~~~~~~~~~~ From 88e5f6136498972b505019039070b450da697102 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martina=20Posp=C3=AD=C5=A1ilov=C3=A1?= Date: Sun, 25 Apr 2021 17:13:06 +0200 Subject: [PATCH 2/3] Capitalise Android --- odkx-src/basics-install.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/odkx-src/basics-install.rst b/odkx-src/basics-install.rst index 9a532203..715712f0 100644 --- a/odkx-src/basics-install.rst +++ b/odkx-src/basics-install.rst @@ -29,7 +29,7 @@ We also recommend installing both ODK-X Survey and ODK-X Tables. Having both is Installing Services -------------------------------- - 1. From your device's :guilabel:`Settings`, choose :menuselection:`Apps & notifications`. (On older versions of Android, this setting maybe in :menuselection:`Applications` or :menuselection:`Security` depending upon your android version.) + 1. From your device's :guilabel:`Settings`, choose :menuselection:`Apps & notifications`. (On older versions of Android, this setting maybe in :menuselection:`Applications` or :menuselection:`Security` depending upon your Android version.) - Go to :guilabel:`Special app access` in :guilabel:`Advanced` and choose :guilabel:`Install unknown apps` - From the list of applications, select a browser of your choice and check :guilabel:`Allow from this source`. From 30b708eac257cb87078fe2598e09f036809db3ed Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Martina=20Posp=C3=AD=C5=A1ilov=C3=A1?= Date: Sun, 25 Apr 2021 17:16:49 +0200 Subject: [PATCH 3/3] Unify the procedure for installation Delete the first repetetive step in Survey and Tables installation, because is already mentioned in Services. Services are a prerequisite for all other apps. By the time the user installs Survey or Tables, they have already performed this step. --- odkx-src/basics-install.rst | 25 ++++++------------------- 1 file changed, 6 insertions(+), 19 deletions(-) diff --git a/odkx-src/basics-install.rst b/odkx-src/basics-install.rst index 715712f0..c9840444 100644 --- a/odkx-src/basics-install.rst +++ b/odkx-src/basics-install.rst @@ -55,15 +55,9 @@ Installing Services Installing the ODK-X Survey App ----------------------------------- - 1. From your device's :guilabel:`Settings`, choose :menuselection:`Apps & notifications`. (On older versions of Android, this setting maybe in :menuselection:`Applications` or :menuselection:`Security` depending upon your android version.) - - - Go to :guilabel:`Special app access` in :guilabel:`Advanced` and choose :guilabel:`Install unknown apps` - - From the list of applications, select a browser of your choice and check :guilabel:`Allow from this source`. - - (On older versions of Android, above two steps are not required, make sure installation from *Unknown Sources* is checked.) - - 2. Open the same web browser that you authorized to install unknown apps on your Android device. (For older versions of Android any web browser can be used since you do not need to specifically authorize the web browser's ability to install.) - 3. Navigate to https://github.com/odk-x/survey/releases/latest and download the latest ODK-X Survey APK. - 4. In the download window, you will see ODK_Survey.N.N.apk. - Select it to download the file. + 1. Open the same web browser that you authorized to install unknown apps on your Android device. (For older versions of Android any web browser can be used since you do not need to specifically authorize the web browser's ability to install.) + 2. Navigate to https://github.com/odk-x/survey/releases/latest and download the latest ODK-X Survey APK. + 3. In the download window, you will see ODK_Survey.N.N.apk. - Select it to download the file. - On older devices, the APK will automatically install after you approve the security settings. - On newer devices, you must go to the download list, rename the file to restore the .apk extension (the extension will have been renamed to .man during the download process), then click on it to install it. @@ -82,16 +76,9 @@ Installing the ODK-X Survey App Installing the ODK-X Tables App ----------------------------------- - - 1. From your device's :guilabel:`Settings`, choose :menuselection:`Apps & notifications`. (On older versions of Android, this setting maybe in :menuselection:`Applications` or :menuselection:`Security` depending upon your android version.) - - - Go to :guilabel:`Special app access` in :guilabel:`Advanced` and choose :guilabel:`Install unknown apps` - - From the list of applications, select a browser of your choice and check :guilabel:`Allow from this source`. - - (On older versions of Android, above two steps are not required, make sure installation from *Unknown Sources* is checked.) - - 2. Open the same web browser that you authorized to install unknown apps on your Android device. (For older versions of Android any web browser can be used since you do not need to specifically authorize the web browser's ability to install.) - 3. Navigate to https://github.com/odk-x/tables/releases/latest and download the latest ODK-X Tables APK. - 4. In the download window, you will see ODK_Tables.N.N.apk. - Select it to download the file. + 1. Open the same web browser that you authorized to install unknown apps on your Android device. (For older versions of Android any web browser can be used since you do not need to specifically authorize the web browser's ability to install.) + 2. Navigate to https://github.com/odk-x/tables/releases/latest and download the latest ODK-X Tables APK. + 3. In the download window, you will see ODK_Tables.N.N.apk. - Select it to download the file. - On older devices, the APK will automatically install after you approve the security settings. - On newer devices, you must go to the download list, rename the file to restore the .apk extension (the extension will have been renamed to .man during the download process), then click on it to install it.