Building for Android

Version Requirements

Following are the minimum tested versions for the tools and libraries you need for building Pie Noon for Android:

• Android SDK: Android 5.0 (API Level 21)
• ADT: 20140702
• Android NDK: android-ndk-r10e
• NDK plugn for Eclipse: Bundled with ADT
• Google Play Games C++ SDK: 1.4 or above
• cmake: 2.8.12 or newer
• Python: 2.7.*
• cwebp: 0.4.0 or newer (download from the WebP Precompiled Utilities)
• Ragel: 6.9 or newer

Before Building

• Install prerequisites for the developer machine's operating system.
  • Linux prerequisites
  • OS X prerequisites
  • Windows prerequisites
• Install fplutil prerequisites
• Install the Android SDK.
• Install the Android NDK.
• Download the Google Play Games C++ SDK and unpack into Pie Noon's dependencies/gpg-cpp-sdk directory.
  • For example, if you've fetched Pie Noon to ~/pie_noon/, unpack the downloaded gpg-cpp-sdk.v1.4.zip to ~/pie_noon/dependencies/gpg-cpp-sdk.

Set up Google Play Games Services

Optionally, to use the Google Play Games Services features in the game, follow the steps below to set up Google Play Games Services IDs:

• Create an App ID with new package name in the Google Play Developer Console.
  • Replace app_id with the newly created one in res/values/strings.xml.
  • Update the package name in AndroidManifest.xml and java files.
    • For example, rename com.google.fpl.pie_noon to com.mystudio.coolgame.
• Create 5 achievement IDs and 14 leaderboards in the Google Play Developer Console.
  • Replace Google Play Games IDs in pie_noon_game.cpp (achievements[] and gpg_ids[]).

Building

The Pie Noon project has an AndroidManifest.xml file which contains details about how to build an Android package (apk).

To build the project:

• Open a command line window.
• Go to the Pie Noon directory.
• Run build_all_android to build the project.

For example:

cd pie_noon
./dependencies/fplutil/bin/build_all_android -E dependencies jni/libs

Installing and Running the Game.

build_all_android can also be used to install and run the game on a device. You will need to add several flags to the command line: -S, -i, and -r will tell it to sign, install, and run the generated APK, respectively.

For example:

cd pie_noon
./dependencies/fplutil/bin/build_all_android -E dependencies jni/libs -i -r -S

If you have multiple android devices connected to your workstation, you will also need to specify which one you want to deploy to. Running adb devices returns a list of all connected devices and serial numbers, and you can specify the serial number of the device you want to deploy to via the optional -d flag.

For more information, see Working with Multiple Devices.