Kivy/Android

- project metadata updates

README.android

@@ -1,12 +1,10 @@
 
-Prerequisites (needs root):
+Build Prerequisites (needs root):
+---------------------------------
 
-  IMPORTANT:
+  You need a linux workstation (either native or virtual). It needs
-  Scripts and instruction in directory 'android' are OUTDATED and
+  x86 hardware (either intel or amd). No graphic desktop is needed,
-  not maintained any more. Instead refer to directory 'buildozer'.
+  cmdline only is sufficient.
-
-  You need a linux workstation (either native or virtual). No graphic
-  desktop is needed, cmdline only is sufficient.
 
   On freshly installed systems you will need to add about the
   following packages:
@@ -37,7 +35,7 @@ Prerequisites (needs root):
   - dev-vcs/git
   - dev-java/ant
 
-  For further instructions consult buildozer/build-instruction.txt.
+  For detailed instructions consult buildozer/build-instruction.txt.
 
   NOTES:
   1) This information is supplied to give you a hint, when running into
@@ -46,44 +44,27 @@ Prerequisites (needs root):
      6 GB of free disk space.
 
 Cardsets:
+---------
 
   The Apk includes a minimal set of cards for playing.
 
-  On Android 9 and lower you can also add additional cardsets:
+Additional user supplied data:
+------------------------------
 
-  Additional cardsets can be installed in ${HOME}/.PySolFC/cardsets/.
+  NOTE:
-  On an android device this is equivalent to /sdcard/.PySolFC/cardsets/.
+  To be able to add additional resources to your app, you need to
-  Cardsets must use the 'png' image format. Use scripts/cardconv
+  enable storage access in the android settings for the app. Go to
-  (on a linux system) to convert them, before copying them to the device.
+  Settings/Apps/PySolFC/Permissions.
 
-  IMPORTANT: This can only be supported for Android Version 9 and lower.
+  Resources are stored in ~/.PySolFC/. On an android device this is
-  Android as of Version 10 and later restricts access to so called
+  equivalent to /sdcard/.PySolFC/.
-  'external-storage' drasitcally. There is currently no way around it
-  with the given application.
 
-LB230301.
+  Additional cardsets can be installed in ~/.PySolFC/cardsets/.
+  Important: Cardsets must use the 'png' image format. Use
+  scripts/cardconv (on a gnu/linux system) to convert, before copying
+  them to the device.
   
-  Allow external storage access for Android 10 and later.
+  Byond cardsets you may also wish to add your own backgrounds. You can
-
+  add them to ~/.PySolFC/data/tiles (patterns) and to
-  - on Android 10 it ist still possible to write to the extenal storage. A
+  ~/.PySolFC/data/tiles/save-aspect/ (images). 'png' and 'jpg' image
-    user has to manually allow at least access to media files in the
+  formats are supported.
-    settings for the app.
-  - For later Versions the MANAGE_EXTERNAL_STORAGE permission was added
-    to the Android Manifest. If the Android 12 user wants to store
-    and read Files from /sdcard/.PySolFC directory he/she can enable
-    'Allow management of all Files' in the settings.
-    NOTE:
-      This is actually against the policies of Google and such an app
-    would fairliy get published on Play Store - but its the simplest
-    way to get this working again. Only users that need this (e.g. because
-    they want to install additional Cardsets) need to do that. The app will
-    never query you for that. You may do it on your own.
-
-LB230327.
-
-  Scheduled for the next Android release:
-  - Screen rotation lock.
-  - Toolbar actualised
-  - Protection from accidental reset or redeal.
-
-LB230919.

README.kivy

@@ -2,7 +2,7 @@
 Introduction
 ------------
 
-This is a version of the PySol FC open source project
+This is a version of the PySolFC open source project
 (http://pysolfc.sourceforge.net)
 
 Early investigations of the code showed, that it would not be
@@ -25,24 +25,18 @@ Images
 The original images supplied by the collection are of type
 gif. In kivy, that image type loads very slowly. Moreover, many
 cards cannot be loaded, because of decoding errors.
-To prevent these problems, the kivy version was
+To prevent these problems, the kivy version was modified to not read
-modified to not read any gif images.
+any gif images.
 
-Some cardsets have been translated to PNG, a format
+For all GIF images in the directories data/images and data/tiles,
-that is processed by both the tk and the kivy versions.
+corresponding images in the PNG format have been added.
 
-Some others, for which transparency information is not
+To convert the cardsets to png format, a shell script, 'cardconv' , has been
-processed correctly even from the PBF images, have been translated
+added to the scripts directory. It requires Bash and ImageMagick
-to the BMP image format (while keeping their GIF variant for
+to be installed.
-the tk version). BMP format is only processed by the
-kivy version.
 
-Additional cardsets are available from the SourceForge
+Additional cardsets are available from the SourceForge project. To use
-project. To use them with kivy, they need to be converted to
+them with kivy, make sure they to also convert them to the png format if
-the BMP format. A shell script, 'cardconv' , has been added
+needed.
-to the scripts directory (it requires Bash and ImageMagick).
 
-For all GIF images in the directories data/images and data/tiles ,
+LB230126.
-corresponding images in the PNG format have been added too.
-
-LB170321.

buildozer/build-instructions.txt

@@ -13,6 +13,8 @@ and through pip.
 Prepare
 -------
 
+Move to directory buildozer.
+
 First create and enter a virtualenv and load all
 required python modules using pip install.
 

fastlane/metadata/android/de/full_description.txt

@@ -5,7 +5,7 @@ Mahjongg, shishensho, memories und andere. Das Originalprojekt läuft unter
 Linux, Windows und MacOS und wurde ursprünglich auf Sourceforge publiziert.
 <a href="https://pysolfc.sourceforge.io/">https://pysolfc.sourceforge.io/</a>.
 
-Das ursprüngliche Projekt war in weiser Voraussicht so konzipiert, dass
+Das Projekt war in weiser Voraussicht so konzipiert, dass
-es unterschiedliche Grafik Systeme unterstützen in der Lage war. Auf diesem
+es unterschiedliche Grafik Systeme zu unterstützen in der Lage war. Auf diesem
 Ansatz wurde eine neue Grafikoberfläche mit dem Kivy Framework realisiert,
 welches auch auf Android lauffähig ist.

fastlane/metadata/android/en-US/changelogs/102122100.txt

@@ -1,19 +1,24 @@
 Android specific:
-- Temporary screen orientation lock added. While playing a game screen
+- Temporary screen orientation lock added. When the app starts (or
-  rotation is locked with the first card move, unlocked when selecting
+  restarts) the screen will rotate according to the device orientation.
-  menu or pause.
+  While playing a game screen rotation is locked with the first
-- Toolbar: configuration of displayed toolbar buttons added to the options
+  card selection. Screen rotation lock can be disabled by a double click to
-  menu.
+  the free game area.
+- Toolbar: general toolbar show/hide for inividual buttons added to the
+  options menu.
 - Toolbar: dynamic updates on Toolbar and Options settings.
-- Toolbar buttons for 'new deal' and 'restart' now display a
+- Toolbar: To prevent occasional restarts or redeals due to 'fat fingers'
-	toast. Tap to it to accept.
+    a toast has been added to buttons for 'new deal' and 'restart'. To
-- Implementation of full picture hint for the new puzzle type games.
+    accept the command tap onto it.
+- Implementation of full picture preview for the new puzzle type games.
 - Background images from the save-aspect folder now are preserving
   correct aspect ratio (bug fix).
-- Mahjongg tile overlapping (3d simulation) implemented
+- Mahjongg tile overlapping (3d simulation) is now implemented.
-- Animation synchronised (so as the tk version does)- This prevents
+- Animation of card moves reworked. This fixes some stacking order corruptions
-  some stacking order corruptions reported earlier.
+  reported earlier.
-- libraries updated to kivy v2.2.1 and python v3.10
+- Display of html-text (game rules, licence etc): Black windows fixed.
+- Upstream libraries updated to kivy v2.2.1 and python v3.10
 Main version:
-- consult NEWS.asscidoc or html-src/news.html on
+- many new games.
-  github for more change informations.
+- consult NEWS.asscidoc or html-src/news.html on the github repo for more
+  change informations.