kinito 0.1.4

[Alpha] Mobile framework & build tools for Android / iOS

Kinito

Cross-platform Mobile build tool for Rust based Apps — Supporting Android / iOS

Installing

$ cargo install kinito

Usage

# Compile your app into a APK
$ kinito build

# Load the appropriate APK onto your emulator / device
$ kinito device-install

Android Overview

Kinito let's you build native Android apps with Rust while not having to write any Java.

The entire build process is wrapped up into a simple command. This is achieved by embedding your rust app as a shared library within a NativeActivity.

A shell project is provided automatically, with your own app injected inside, then built using Gradle to produce runnable APKs.

Getting Started (Android)

1. Download Android NDK

  • Create standalone toolchains for each cpu arch you wish to build for.

    (ie. arm, x86, mips)

  • Use $ANDROID_NDK/build/tools/make_standalone_toolchain.py to create the standalone toolchains.

2. Setup your Cargo.toml

  • Add a dylib section in your Cargo.toml

    [lib]
    crate-type = ["dylib"]
    
  • Place a .cargo/config to specify the linkers for each CPU ABI you wish to compile for.

    [target.x86_64-linux-android] linker = "/android/standalone-x86_64/bin/x86_64-linux-android-gcc"

    [target.arm-linux-androideabi] linker = "/android/standalone-arm/bin/arm-linux-androideabi-gcc"

  • Setup your android_main() entry point inside your app code. (ie. Setup OpenGL context)

See the examples for more details.

3. You can now run kinito build which will produce Android APKs (arm-linux-androideabi) in your ./project/target directory.

  • You can now achieve fast iterative development on the Desktop (x86) while building for mobile at the same time.

  • Use cross platform toolkits (ie. glutin) which supports Android/iOS/PC