From http://www.jwz.org/xscreensaver/xscreensaver-5.40.tar.gz
[xscreensaver] / android / README
index fb7a4da9c5a24e0ea97e938e2991ca5702010bb3..2843296548b6cae41058a01b737c578e0f4ca360 100644 (file)
@@ -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
-    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/
-    Also set "ndk.dir" in project/local.properties.
+    Also set "ndk.dir" in local.properties.
 
 To build:
 
@@ -30,7 +30,7 @@ To build:
     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
@@ -60,7 +60,7 @@ To build:
 
     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
@@ -79,50 +79,50 @@ To build:
 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:
-        project/xscreensaver/jni/*.mk
+        xscreensaver/jni/*.mk
 
     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:
-        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
-        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/
-        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".
 
@@ -150,89 +150,40 @@ TODO list, and known bugs:
     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   renders incorrectly
   apple2       text, images into pixmaps doesn't work
-  atlantis     crashes emulator, sometimes
-  barcode       pixmaps
-  binaryring    pixmaps
-  blitspin      images
-  bouboule      ?
-  braid         thick lines
-  bsod          pixmaps, XCopyArea problems
-  bumps         XPutImage
-  carousel      blank
-  celtic        thick lines
-  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
-  deluxe        thick lines
-  dnalogo       codeword is blank
-  dymaxionmap  crashes emulator
-  endgame      crashes emulator
-  engine        text
-  epicycle      thick lines
-  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
-  halftone      XFillArc crash
-  halo          XOR
-  hypertorus    crashes emulator
-  interaggregate        window background should be white
-  jigglypuff    incredibly slow
-  jigsaw        crashes emulator
-  juggler3d    crashes emulator
-  maze          no logo, lines look weird
-  mirrorblob    images
-  moebius       crashes emulator
-  moire2        pixmaps
-  molecule     crashes emulator
-  mountain      polygons
-  munch         XOR
-  noseguy       pixmaps
-  pacman       launches really slowly
-  pedal         polygons
-  phosphor      pixmaps
-  photopile     pixmaps
-  pipes         blank
-  polyhedra    crashes emulator
-  polyominoes   pixmaps
-  projectiveplane       crashes emulator
-  pulsar        crashes emulator
-  qix           polygons
-  queens       crashes emulator
-  skytentacles  crashes emulator
-  slip          pixmaps
-  sonar                crashes emulator
-  speedmine     polygons
-  spheremonics  crashes emulator
-  splitflap     text
-  spotlight     pixmaps
-  starfish      polygons
-  starwars     crashes emulator
-  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
-  xrayswarm     thick lines
-  zoom          pixmaps
+  barcode      pixmaps
+  bsod         pixmaps, XCopyArea problems
+  carousel     images are corrupted
+  cityflow     shading is wrong
+  endgame      insanely slow
+  engine       text
+  esper                images don't load, no text
+  fliptext     text
+  fontglide    text
+  glblur       grayscale instead of color
+  halftone     XFillArc crash
+  jigglypuff   incredibly slow
+  juggler3d    blank
+  maze         lines are not the same thickness (aliased?)
+  molecule     blank
+  noseguy      text; images
+  pacman       images; launches really slowly
+  pedal                polygons
+  phosphor     text; pixmaps
+  photopile    text; images don't display
+  polyhedra    text
+  polyominoes  pixmaps
+  qix          polygons
+  queens       insanely slow
+  sonar                does icmp work?
+  speedmine    polygons
+  splitflap    super slow
+  spotlight    blank
+  starfish     polygons
+  starwars     text
+  unicrud      pixmaps
+  winduprobot  dome is not transparent
+  xanalogtv    pixmaps
+  xflame       draws only upper left corner
+  xmatrix      pretty slow