Android build standup

[a1studmuffin]

Hey team, I've spent the last few weeks burning the midnight oil standing up the Android build in mainline. With this PR you can now compile and run Cataclysm DDA on an Android device. See my additions to COMPILING.md for an overview and instructions on how to build an Android APK under Linux.

There is a new folder in the root of the repository android/ which contains the Android project files.

The rest of the changes are to game C++ files in src/ (as well as an Android.mk file). Almost all of the C++ changes are guarded for __ANDROID__ so they won't affect other platforms, with the exception of one or two minor additions.

I'd appreciate if anyone wants to skim over the changes and offer feedback. If you're attempting to get this running under Windows with Android Studio (I've got it building under Ubuntu and Windows here), ensure your git supports creation of symlinks.

Most of the C++ changes to random game files are just setting up input_contexts specifically for Android, often with manually registered buttons + descriptions to match the existing UI code. This is so that the Android quick shortcuts along the bottom of the touchscreen work even in cases where the game's UI code hasn't been refactored to use an input_context yet. I considered rewriting each of these UI screens to use input_contexts for all platforms, but that's a reasonably big job and I was hoping we could tackle it later on.

There's also a big hunk of Android-specific code sitting in sdltiles.cpp. Let me know if this is unpalatable and I can look at merging some of it into a separate C++ file containing Android-specific code, perhaps android.cpp/h.

Things that are still outstanding (but can happen after this PR):

• Crash reporting (would be very useful to improve game reliability across devices)
• Release APK signing with a keystore (though this shouldn't live in the public repository anyway)
• Gradle project build steps for auto-generation of version.h and catabindings.cpp
• SDL software renderer is still unreliable on a lot of devices
• No Android-specific welcome screen. In my original port (https://github.com/a1studmuffin/Cataclysm-DDA-Android) I had a welcome screen explaining the Android touch controls. I've removed this to minimize C++ changes, but we may want to add something like this back in.
• Custom data folder support (allowing more flexible user-control over save game locations, syncing with desktop versions via Dropbox/Google Drive synced folders on their device etc.)

Completed:

• APKs can be thinned out as they currently contain lang files other than lang/mo (which aren't needed and take up about 25% of APK size) (175fc2d25d03c46cca95c5043f7217c93e2740e9)

[Inglonias]

I'm a little confused as to what this PR does. Does this add an automagical Android build of the game whenever it updates, or just provide instructions for compiling my own APK and the resources to do so?

[a1studmuffin]

The latter. With this change you can manually compile and run Cataclysm DDA on an Android device. If/when this PR is accepted, I'll work on getting nightly experimental Android builds up and running alongside the other desktop builds. This PR is the first step to making that happen.

…

On Tue., 7 Aug. 2018, 10:24 pm Inglonias, ***@***.***> wrote: I'm a little confused as to what this PR does. Does this add an automagical Android build of the game whenever it updates, or just provide instructions for compiling my own APK and the resources to do so? — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub <#24674 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AGAQSW_A3wJaRb9cMExeosZE275ZA304ks5uOYcGgaJpZM4VxriX> .

[ZhilkinSerg]

Sorry for waiting for too long in the PR queue. I have Linux VM ready now, so I will try to compile this next week.

[a1studmuffin]

No problem at all, it's a decent chunk of code so I figured it'd be a while before someone had the time to check it out - thanks for having a look! I'll continue keeping the PR updated to latest to ensure there's no merge conflicts. Let me know if you run into any issues.

[ZhilkinSerg]

zhilkin@ubuntu:~$ ~/android-sdk/tools/bin/sdkmanager --update
Warning: File /home/zhilkin/.android/repositories.cfg could not be loaded.      
[=======================================] 100% Computing updates...             

[a1studmuffin]

I believe this warning is "normal" for this Android toolchain version. It appears if the file it's looking for doesn't exist locally, but doesn't impact anything after that: https://askubuntu.com/questions/885658/android-sdk-repositories-cfg-could-not-be-loaded

[ZhilkinSerg]

I guess it is working, but my VM hung up on 53% :(

[ZhilkinSerg]

I believe we should switch to Cataclysm-DDA folder before cloning.

[a1studmuffin]

Ah thanks, that's what I meant to say with "From the root folder of the CDDA repository run:". I've updated it in 583c4b6.

[ZhilkinSerg]

Should I make Linux version with languages first?

[ZhilkinSerg]

Didn't test it on the phone yet, but apk was built:

[Dyrewulfe]

@a1studmuffin

I've built a branch off of this PR that uses precompiled dependencies(easier end user builds, and likely easier for the CI machinery to deal with), and adds some per build type flags for optimization. I'll PR it at your repo once I've finished testing everything out, if you're interested?(I felt I should say something early, before you rebase again.)

[ZhilkinSerg]

Successfully created, installed and run Release version. Initially had some troubles with signing apk, but read the instructions and everything went smooth.

[Dyrewulfe]

@a1studmuffin
Sent ya a PR. a1studmuffin#1

Turns the build process into a one step operation(build environment not included.)

[a1studmuffin]

Woohoo! Thanks to everyone who tested this out, much appreciated.