FreeGLUT 3.0 introduces support for the Android platform.
This platform is different than traditional desktop platforms, requiring cross-compilation, interfacing with a touchscreen, and ability for your application to be paused and resumed at any time.
Here's how:

Compiling

Note: at the moment, you need to chose between OpenGL ES 1.0 (FREEGLUT_GLES1) or 2.0 (FREEGLUT_GLES2) at compile time.
In the near future, we may implement a way to set this at run-time.

Use your own cross-compiler for Android, or export the one from the Android NDK:

        /usr/src/android-ndk-r7c/build/tools/make-standalone-toolchain.sh \
          --platform=android-9 \
          --install-dir=/usr/src/ndk-standalone-9

Compile FreeGLUT and install it in your Android cross-compiler path:

        PATH=/usr/src/ndk-standalone-9/bin:$PATH
        cd /usr/src/freeglut-x.x/
        mkdir cross-android-gles2/
        cd cross-android-gles2/
        cmake \
          -D CMAKE_TOOLCHAIN_FILE=../android_toolchain.cmake \
          -D CMAKE_INSTALL_PREFIX=/usr/src/ndk-standalone-9/sysroot/usr \
          -D CMAKE_BUILD_TYPE=Debug \
          -D FREEGLUT_GLES2=ON \
          -D FREEGLUT_BUILD_DEMOS=NO \
          ..
        make -j4
        make install
        # Only static for now:
        rm -f /usr/src/ndk-standalone-9/sysroot/usr/lib/libfreeglut-gles?.so*

Using in your projects

Compile your own project using common build systems

For instance if you use the autotools:

      PATH=/usr/src/ndk-standalone-9/bin:$PATH
      export PKG_CONFIG_PATH=/usr/src/ndk-standalone-9/sysroot/usr/share/pkgconfig
      ./configure --host=arm-linux-androideabi --prefix=/somewhere
      make
      make install

If you use CMake, you may want to copy our Android toolchain 'android_toolchain.cmake':

      PATH=/usr/src/ndk-standalone-9/bin:$PATH
      export PKG_CONFIG_PATH=/usr/src/ndk-standalone-9/sysroot/usr/share/pkgconfig
      cp .../freeglut-x.x/android_toolchain.cmake .
      mkdir cross-android/
      cd cross-android/
      cmake \
        -D CMAKE_TOOLCHAIN_FILE=../android_toolchain.cmake \
        -D CMAKE_INSTALL_PREFIX=/somewhere \
        -D CMAKE_BUILD_TYPE=Debug \
        -D MY_PROG_OPTION=something ... \
        ..
      make -j4
      make install

Check progs/test-shapes-gles1/ in the FreeGLUT source distribution for a complete, stand-alone example.

Compile your own project using the NDK build-system

Create a module hierarchy pointing to FreeGLUT, with our Android.mk:

        mkdir freeglut-gles2/
        cp .../freeglut-x.x/android/gles2/Android.mk freeglut-gles2/
        ln -s /usr/src/ndk-standalone-9/sysroot/usr/include freeglut-gles2/include
        ln -s /usr/src/ndk-standalone-9/sysroot/usr/lib freeglut-gles2/lib

Reference this module in your jni/Android.mk:

        LOCAL_STATIC_LIBRARIES := ... freeglut-gles2
        ...
        $(call import-module,freeglut-gles2)

You now can point your NDK_MODULE_PATH to the directory containing the module:
```
        ndk-build NDK_MODULE_PATH=.
      
```

Roadmap

Done:

Initialize context with EGL
Keyboard support
Mouse support
Virtual keypad (on touchscreen)
Extract assets in cache dir on start-up
Make EGL support reusable by Mesa X11
freeglut_std.h can be used with GLES1 or GLES2 or non-ES headers
(using -DFREEGLUT_GLES1 and -DFREEGLUT_GLES2)
GLES1 and GLES2 support for geometry
Pause/resume application support
Callback to reload OpenGL resources lost during a pause
Callback for pause/resume notifications

TODO:

Multi-touch support (glutMultiMotionFunc & al.)
Display translucent keys on virtual keypad
API to access raw JVM structure and raw Activity(ies?) structure
API to detect touchscreen presence
API (or configuration file?) to disable assets extraction
Accelerometer as a joystick input

Possibly implemented later:

Support for menus and basic fonts
Open new windows (if that's possible)
Joystick support (note: xperia play doesn't have a joystick, but a touchpad)

New API

These new callbacks were added :

glutInitContextFunc <- void : called when the context is initialized or re-initialized (e.g. after a pause)
glutPauseFunc <- void : called when the application goes on a pause (or a stop)
glutResumeFunc <- void : called when the application comes back from a pause (after glutInitContextFunc)

New functions will be necessary to :

detect touchscreen presence
disable assets extraction

(Work In Progress)

Notes

Android never truly kills an application, even when pressing the Back button, even when the application is onDestroy'd: the process is still running and ready to accept onCreate event to become active again.
By default, FreeGLUT exit()s when the last window is closed (without returning to your main). But this behavior can be changed with glutSetOption(GLUT_ACTION_ON_WINDOW_CLOSE, ...), in which case your have to either exit() yourself at the end of your main, or make sure your main can be called multiple times (in particular: beware of static variables that won't be reinitialized).
When a key is repeated, down and up events happen most often at the exact same time. This makes it impossible to animate based on key press time.
e.g. down/up/wait/down/up rather than down/wait/down/wait/up
This looks like a bug in the Android virtual keyboard system :/ Real buttons such as the Back button appear to work correctly (series of down events with proper getRepeatCount value).
To work around this, FreeGLUT provides its own minimal virtual keypad. It may be replaced by a virtual (touchscreen) joystick.