Noonian

A tool for building Android apps. Inspired by a man who had some success in building androids.

Installation

Clone or Download the latest release
cd Noonian
Swift 3+ is installed
- macOS: Included in Xcode 8+
- Linux: available at Swift. make linux_swift will create a local installation of Swift in the source directory if you are using Ubuntu 14.04
Run make install

Android SDK Requirements

Java 7+ installed and set in $JAVA_HOME
$ANDROID_HOME is set to an Android SDK directory
The target and build_tools that you intend to use have been downloaded
Your build tools contain the jack build chain and your source is compatible
You have a valid Android debug key located at ~/.android/debug.keystore
To install your app, you must have a simulator running

Usage

Use noonian help and noonian help <action> to display command line help.

init can be run from any directory, but all other commands must be run from your project directory.

Initialize A Project

noonian init <Project Name>

Options

--path <path for project
--package <package name>
--target <android api target>
--activity <name of activity to create>

Build Your Project

noonian build

Package, Sign, Zipalign APK

noonian package

Install On Active simulator

noonian install

Build, Package, and Install

noonian all

Configuration

Noonian is configured via a .noonian.yml file. noonian init will create a basic configuration file for you with the minimum necessary settings, but you can modify it to further suit your needs.

Project Settings

app_name: <app name> specifies the name of your app for packaging and installation purposes.
target: <target name> specified which APIs to build against and package.
build_tools: <tools version> specifies which version of the SDK build tools to use.

Before/After Commands

All actions other than init can be configured with shell commands to run before and after the action by using the before_<action> and after_<action> keys. The value can either be a single command or an array of commands.

Example Configuration

## You can use comments to annotate your configuration
app_name: AndroidApp
target: android-25
build_tools: 25.0.0

## Build
before_build: echo running a command
after_build:
  - echo running command 1
  - echo running command 2

## Package
after_install:
  - echo we finished!

Troubleshooting

`make install` fails:

Make sure you have Swift 3+ installed
- macOS: via Xcode 8+ or a manually installed toolchain from swift.org
- Linux: via make linux_swift or a manually installed toolchain from swift.org. Additionally, you must have clang installed (available via sudo apt-get install clang)
The binary is installed to /usr/local/bin
The resources are installed to /usr/local/share/noonian
If you don't have write permissions to these directories, installation will fail.
The binary can still be copied anywhere from .build/release/noonian, but it will be unable to create an initial configuration for you. You can manually copy example.noonian.yml to your project directory.

`noonian <action>` fails:

Check $ANDROID_HOME is defined
Check $JAVA_HOME is defined
Update your Android SDK
for build, package, install and all make sure you have a valid configuration:
- defining taget: <target name> is required
- defining build_tools: <tools version> is recommended

scottrhoyt/Noonian