projects / xscreensaver / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
From http://www.jwz.org/xscreensaver/xscreensaver-5.38.tar.gz
[xscreensaver] / android / README
diff --git a/android/README b/android/README
index 74b8097ccfcece2d5151f72bd992a9eca251b4d8..0a2081f16fec2714ff91037f9cef74d4aca13211 100644 (file)
--- a/android/README
+++ b/android/README
@@ -19,9 +19,9 @@ To set up your Android development environment:
       "build-tools/", etc.)  That is, it should be "sdk/ndk/".
 
     set $ANDROID_HOME to where your SDK is installed, or
       "build-tools/", etc.)  That is, it should be "sdk/ndk/".
 
     set $ANDROID_HOME to where your SDK is installed, or
-    set "sdk.dir" in project/local.properties.
+    set "sdk.dir" in the file local.properties.
     On MacOS, the value you want is probably ~/Library/Android/sdk/
     On MacOS, the value you want is probably ~/Library/Android/sdk/
-    Also set "ndk.dir" in project/local.properties.
+    Also set "ndk.dir" in local.properties.
 
 To build:
 
 
 To build:
 
@@ -30,7 +30,7 @@ To build:
     make
 
     Hopefully an "xscreensaver-debug.apk" file will appear in
     make
 
     Hopefully an "xscreensaver-debug.apk" file will appear in
-    android/project/xscreensaver/build/outputs/apk/.
+    android/xscreensaver/build/outputs/apk/.
 
     Load that onto your device and go to:
       Settings / Display / Daydream
 
     Load that onto your device and go to:
       Settings / Display / Daydream
@@ -41,6 +41,9 @@ To build:
 
       $ANDROID_HOME/sdk/tools/android avd
 
 
       $ANDROID_HOME/sdk/tools/android avd
 
+      E.g.: Nexus 5, Android 5, Intel Atom x86_64, RAM 2048 VM 64,
+        storage 200, use host GPU.
+
     Configuration options are in $HOME/.android/avd/*.avd/config.ini
 
     To launch it:
     Configuration options are in $HOME/.android/avd/*.avd/config.ini
 
     To launch it:
@@ -57,7 +60,7 @@ To build:
 
     To load it into the currently-running emulator or device:
       $ANDROID_HOME/platform-tools/adb install -r \
 
     To load it into the currently-running emulator or device:
       $ANDROID_HOME/platform-tools/adb install -r \
-        project/xscreensaver/build/outputs/apk/xscreensaver-debug.apk
+        xscreensaver/build/outputs/apk/xscreensaver-debug.apk
 
     Extremely verbose log output, including stack traces:
         $ANDROID_HOME/platform-tools/adb logcat
 
     Extremely verbose log output, including stack traces:
         $ANDROID_HOME/platform-tools/adb logcat
@@ -76,50 +79,50 @@ To build:
 Directory structure:
 
     Boilerplate for the Java version of "make":
 Directory structure:
 
     Boilerplate for the Java version of "make":
-        project/*gradle*
-        project/*.properties
-        project/xscreensaver/*gradle*
-        project/xscreensaver/build.*
-        project/xscreensaver/*.properties
+        *gradle*
+        *.properties
+        xscreensaver/*gradle*
+        xscreensaver/build.*
+        xscreensaver/*.properties
 
     The other half of the Makefile:
 
     The other half of the Makefile:
-        project/xscreensaver/jni/*.mk
+        xscreensaver/jni/*.mk
 
     Source code:
 
     Source code:
-        project/xscreensaver/src/org/jwz/xscreensaver/*.java
-        project/xscreensaver/res/layout/*.xml
+        xscreensaver/src/org/jwz/xscreensaver/*.java
+        xscreensaver/res/layout/*.xml
 
     Other relevant source code is in ../jwxyz/ and ../hacks/.
 
     Icons:
 
     Other relevant source code is in ../jwxyz/ and ../hacks/.
 
     Icons:
-        project/xscreensaver/res/drawable-ldpi/
-        project/xscreensaver/res/drawable-mdpi/
-        project/xscreensaver/res/drawable/
+        xscreensaver/res/drawable-ldpi/
+        xscreensaver/res/drawable-mdpi/
+        xscreensaver/res/drawable/
 
     Files that we generate:
 
         gen/function-table.h
 
     Files that we generate:
 
         gen/function-table.h
-        project/xscreensaver/AndroidManifest.xml
-        project/xscreensaver/res/drawable/*.png
-        project/xscreensaver/res/values/settings.xml
-        project/xscreensaver/res/values/strings.xml
-        project/xscreensaver/res/xml/*.xml
-        project/xscreensaver/src/org/jwz/xscreensaver/gen/*.java
+        xscreensaver/AndroidManifest.xml
+        xscreensaver/res/drawable/*.png
+        xscreensaver/res/values/settings.xml
+        xscreensaver/res/values/strings.xml
+        xscreensaver/res/xml/*.xml
+        xscreensaver/src/org/jwz/xscreensaver/gen/*.java
 
     Other files generated as a part of the build process:
 
         gen/
 
     Other files generated as a part of the build process:
 
         gen/
-        project/.gradle/
-        project/xscreensaver/build/
-        project/xscreensaver/build/outputs/apk/  -- app appears here
-        project/xscreensaver/jni/
-        project/xscreensaver/libs/
-        project/xscreensaver/obj/
-        project/xscreensaver/res/
-        project/xscreensaver/res/drawable/
-        project/xscreensaver/res/values/
-        project/xscreensaver/res/xml/
-        project/xscreensaver/src/org/jwz/xscreensaver/gen/
+        .gradle/
+        xscreensaver/build/
+        xscreensaver/build/outputs/apk/  -- app appears here
+        xscreensaver/jni/
+        xscreensaver/libs/
+        xscreensaver/obj/
+        xscreensaver/res/
+        xscreensaver/res/drawable/
+        xscreensaver/res/values/
+        xscreensaver/res/xml/
+        xscreensaver/src/org/jwz/xscreensaver/gen/
 
 When adding a new hack, edit android/Makefile, then "make clean" and "make".
 
 
 When adding a new hack, edit android/Makefile, then "make clean" and "make".
 
@@ -147,8 +150,6 @@ TODO list, and known bugs:
     display the error message in a dialog.  The catch works, but the dialog
     box does not.
 
     display the error message in a dialog.  The catch works, but the dialog
     box does not.
 
-  anemone      needs thick lines
-  anemotaxis    needs thick lines
   antinspect    crashes emulator, sometimes
   antmaze       crashes emulator, sometimes
   antspotlight crashes emulator, sometimes
   antinspect    crashes emulator, sometimes
   antmaze       crashes emulator, sometimes
   antspotlight crashes emulator, sometimes
@@ -158,36 +159,30 @@ TODO list, and known bugs:
   binaryring    pixmaps
   blitspin      images
   bouboule      ?
   binaryring    pixmaps
   blitspin      images
   bouboule      ?
-  braid         thick lines
   bsod          pixmaps, XCopyArea problems
   bumps         XPutImage
   carousel      blank
   bsod          pixmaps, XCopyArea problems
   bumps         XPutImage
   carousel      blank
-  celtic        thick lines
   circuit      crashes emulator
   cityflow     crashes emulator, sometimes
   circuit      crashes emulator
   cityflow     crashes emulator, sometimes
-  compass       thick lines
   crackberg    crashes emulator, sometimes
   cube21       crashes emulator, sometimes
   cubenetic    crashes emulator, sometimes
   cubicgrid    crashes emulator, sometimes
   crackberg    crashes emulator, sometimes
   cube21       crashes emulator, sometimes
   cubenetic    crashes emulator, sometimes
   cubicgrid    crashes emulator, sometimes
-  deluxe        thick lines
   dnalogo       codeword is blank
   dymaxionmap  crashes emulator
   endgame      crashes emulator
   engine        text
   dnalogo       codeword is blank
   dymaxionmap  crashes emulator
   endgame      crashes emulator
   engine        text
-  epicycle      thick lines
+  esper         text
   flipflop      images
   flipscreen3d  images
   fliptext      text
   fontglide     text
   flipflop      images
   flipscreen3d  images
   fliptext      text
   fontglide     text
-  fuzzyflakes   thick lines
   gflux         images
   glblur        crashes emulator, sometimes
   gleidescope   images
   glhanoi       crashes emulator, but a few seconds in
   glplanet      crashes emulator
   glslideshow   images
   gflux         images
   glblur        crashes emulator, sometimes
   gleidescope   images
   glhanoi       crashes emulator, but a few seconds in
   glplanet      crashes emulator
   glslideshow   images
-  goop          polygons
   halftone      XFillArc crash
   halo          XOR
   hypertorus    crashes emulator
   halftone      XFillArc crash
   halo          XOR
   hypertorus    crashes emulator
@@ -203,7 +198,7 @@ TODO list, and known bugs:
   mountain      polygons
   munch         XOR
   noseguy       pixmaps
   mountain      polygons
   munch         XOR
   noseguy       pixmaps
-  pacman       launches really slowly; fails at loading XPMs
+  pacman       launches really slowly
   pedal         polygons
   phosphor      pixmaps
   photopile     pixmaps
   pedal         polygons
   phosphor      pixmaps
   photopile     pixmaps
@@ -214,7 +209,6 @@ TODO list, and known bugs:
   pulsar        crashes emulator
   qix           polygons
   queens       crashes emulator
   pulsar        crashes emulator
   qix           polygons
   queens       crashes emulator
-  rocks         polygons
   skytentacles  crashes emulator
   slip          pixmaps
   sonar                crashes emulator
   skytentacles  crashes emulator
   slip          pixmaps
   sonar                crashes emulator
@@ -227,11 +221,9 @@ TODO list, and known bugs:
   substrate     background should be white
   surfaces      crashes emulator
   tessellimage  pixmaps
   substrate     background should be white
   surfaces      crashes emulator
   tessellimage  pixmaps
-  truchet       thick lines
   twang         background should be black
   unicrud       pixmaps
   xanalogtv     pixmaps
   xjack         blank
   xmatrix       pixmaps
   twang         background should be black
   unicrud       pixmaps
   xanalogtv     pixmaps
   xjack         blank
   xmatrix       pixmaps
-  xrayswarm     thick lines
   zoom          pixmaps
   zoom          pixmaps
Archive of old xscreensaver versions (http://www.jwz.org/xscreensaver/)