Skip to content

Latest commit

 

History

History
72 lines (42 loc) · 2.34 KB

README.md

File metadata and controls

72 lines (42 loc) · 2.34 KB
Raw

Scripts to build Epidemic for Android

THIS REPO IS DEPRECATED

**WHILE THESE INSTRUCTIONS WORK I NOW SUGGEST YOU USE THE INSTRUCTIONS IN android-build-game-apk. **

This is particularly relevant advice for those who are attending the "Writing Games for Android in Haskell" workshop at LambdaJam 2016 in Brisbane on 28/29 April 2016.

Old instructions below this line...

Introduction

Epidemic is a game written for mobile devices in Haskell. (Want to help beta test? Please subscribe.)

This repo contains a script called build-epidemic-apk.sh to build the game for Android devices using ARMv7 (or compatible) chipsets. The repo contains a thin Java wrapper that calls into the natively compiled code of the game.

Setting up a development environment

This won't just work out of the box. You will require a GHC cross compiler targetting ARMv7 and will need to build all the associated libraries. This isn't straightforward at all!

However, I've done all the work for you with the help of Docker. Please see the repo docker-epidemic-build-env for more details.

Setting up the build script

You will need to create a file called build-vars.rc. See build-vars-rc.example

You will need to set paths for:

  • The Epidemic repo
  • The Android NDK
  • the directory containing static C libraries that Epidemic requires.

If you have used the Dockerfile in the repo docker-epidemic-build-env (mentioned above), then you can just

$ cp build-vars.rc.example build-vars.rc

Build

Now you can build it:

$ ./build-android-apk.sh

Installing the APK on Android devices

Once you have run the build script you should find the file:

bin/com.declarative.games.epidemic.beta-debug.apk

You can install this file on your Android device with adb.

adb install -r com.declarative.games.epidemic.beta-debug.apk

On your device you will need to tick "Unknown Sources" in "Settings -> Security".