projects / xscreensaver / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
From http://www.jwz.org/xscreensaver/xscreensaver-5.39.tar.gz
[xscreensaver] / android / README
diff --git a/android/README b/android/README
index 74b8097ccfcece2d5151f72bd992a9eca251b4d8..c5b00c18401b255a8111a372b1a964e1a99615ff 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,91 +150,59 @@ 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
+  antinspect   renders incorrectly
+  antmaze      crashes emulator, sometimes
   antspotlight crashes emulator, sometimes
   apple2       text, images into pixmaps doesn't work
   atlantis     crashes emulator, sometimes
   antspotlight crashes emulator, sometimes
   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
-  goop          polygons
-  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; fails at loading XPMs
-  pedal         polygons
-  phosphor      pixmaps
-  photopile     pixmaps
-  pipes         blank
-  polyhedra    crashes emulator
-  polyominoes   pixmaps
-  projectiveplane       crashes emulator
-  pulsar        crashes emulator
-  qix           polygons
-  queens       crashes emulator
-  rocks         polygons
-  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
+  blitspin     images
+  bsod         pixmaps, XCopyArea problems
+  bumps                images
+  carousel     images
+  cityflow     shading is wrong
+  endgame      insanely slow
+  engine       text
+  esper                images, text
+  flipflop     images
+  flipscreen3d images
+  fliptext     text
+  fontglide    text
+  gflux                images
+  glblur       grayscale instead of color
+  gleidescope  images
+  glslideshow  images
+  halftone     XFillArc crash
+  halo         some extra triangles show up
+  jigglypuff   incredibly slow
+  jigsaw       images
+  juggler3d    blank
+  maze         lines are not the same thickness (aliased?)
+  mirrorblob   images
+  molecule     blank
+  mountain     polygons
+  munch                XOR
+  noseguy      text; images flicker to black and white
+  pacman       launches really slowly
+  pedal                polygons
+  phosphor     text; pixmaps
+  photopile    images; pixmaps
+  polyhedra    text
+  polyominoes  pixmaps
+  qix          polygons
+  queens       blank
+  slip         images
+  sonar                does icmp work?
+  speedmine    polygons
+  splitflap    super slow
+  spotlight    pixmaps
+  starfish     polygons
+  starwars     text
+  tessellimage pixmaps
+  twang                background should be black
+  unicrud      pixmaps
+  winduprobot  dome is not transparent
+  xanalogtv    pixmaps
+  xflame       draws only upper left corner
+  xmatrix      super slow, glitch on first screen
+  zoom         pixmaps
Archive of old xscreensaver versions (http://www.jwz.org/xscreensaver/)