build: add android target

.gitignore

@@ -1,5 +1,6 @@
 zig-out/
 zig-cache/
+.build_config/
 .zigmod/
 kcov-output/
 macos-sdk/

android/.gitattributes

@@ -0,0 +1 @@
+*.zig text=auto eol=lf

android/.gitignore

@@ -0,0 +1,6 @@
+zig-cache
+*.apk
+*.keystore
+.build_config
+zig-out
+*.apk.idsig

android/LICENSE

@@ -0,0 +1,8 @@
+Copyright (c) 2020 Felix "xq" Queißner
+https://github.com/MasterQ32/ZigAndroidTemplate
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

android/README.md

@@ -0,0 +1,64 @@
+# Android Apps in Zig
+
+![Project banner](design/logo.png)
+
+This repository contains a example on how to create a minimal Android app in Zig.
+
+## State of the project
+
+This project contains a really small app skeleton in `example/main.zig` which initializes OpenGL and renders a color cycle. Touchscreen events will be displayed as small circles beneath the fingers that will fade as soon as no event for the same finger will happen again.
+
+The code contains some commented examples on how to interface with the JNI to use advanced features of the `ANativeActivity`.
+
+It has no dependencies to C code except for the android libraries, so it can be considered a pure Zig app.
+
+We're running a CI that will verify the build for Windows, macOS and Linux:
+
+[![CI](https://github.com/MasterQ32/ZigAndroidTemplate/actions/workflows/main-ci.yml/badge.svg)](https://github.com/MasterQ32/ZigAndroidTemplate/actions/workflows/main-ci.yml)
+
+## Presentation
+
+There is a [FOSDEM Talk](https://fosdem.org/2021/schedule/event/zig_android/) you can watch here:
+
+- [MP4 Video](https://video.fosdem.org/2021/D.zig/zig_android.mp4)
+- [WebM Video](https://video.fosdem.org/2021/D.zig/zig_android.webm)
+
+## What's missing
+
+- Configuration management example
+- Save/load app state example
+
+## Requirements & Build
+
+You need the [Android SDK](https://developer.android.com/studio#command-tools) installed together with the [Android NDK](https://developer.android.com/ndk).
+
+You also need [adb](https://developer.android.com/studio/command-line/adb) and a Java SDK installed (required for `jarsigner`).
+
+Now you need to generate yourself a keystore to sign your apps. For debugging purposes, the build script contains a helper. Just invoke `zig build keystore` to generate yourself a debug keystore that can be used with later build invocations.
+
+**Note** that the build file might ask you to configure some paths. Do as requested and just run the build again, it should work then.
+
+If all of the above is done, you should be able to build the app by running `zig build`.
+
+There are convenience options with `zig build push` (installs the app on a connected phone) and `zig build run` (which installs, then runs the app).
+
+### Quick Start
+
+Install the [`sdkmanager`](https://developer.android.com/studio/command-line/sdkmanager) and invoke the following command line:
+
+```
+sdkmanager --install "platforms;android-21" # Min version: Android 5
+sdkmanager --install "build-tools;33.0.0"
+sdkmanager --install "ndk;25.1.8937393"
+zig build keystore install run
+```
+
+This should build an APK and install it on your connected phone if possible.
+
+## Getting started
+
+Check out the [`build.zig`](build.zig) to see how to build a new android app, and [`example/main.zig`](example/main.zig) to see how to create a basic application. All of this is still very rough, though.
+
+## Credits
+
+Huge thanks to [@cnlohr](https://github.com/cnlohr) to create [rawdrawandroid](https://github.com/cnlohr/rawdrawandroid) and making this project possible!