protoform
A protoform is a building block, a starting point for building androidy things. This little gem generates an application skeleton for a Mirah Android application. Because Android is exciting, but Java is still kinda painful.
Installation Prereqs
If you don't already have the Android SDK, download it from
http://developer.android.com/sdk/index.html and follow the quick-start
instructions. You'll need to create an Android Virtual Device (AVD) using the
Android Manager (android
) found in the SDK.
You'll also want to have Mirah installed of course. You can get it from GitHub: https://github.com/mirah/mirah
Make sure that jruby, mirah and mirahc are in your PATH as well as the Android SDK tools directory.
Usage
Install the gem and run the generator, specifying the package name you want to use and the Android SDK location:
gem install protoform
protoform -S ~/android/sdk -T "Hello Android" -P org.zerosum.android HelloWorld
This should generate an app skeleton in the directory HelloWorld
. Change to
that directory and run the ant debug task:
ant debug
Assuming that your prerequisites are all set and the task succeeds, you should
now have a .apk file in your bin/ directory. Fire up the Android AVD Manager
(android
) to launch the emulator, and install the APK using the adb tool:
adb install bin/HelloWorld-debug.apk
You should now be able to navigate to the applications list in the emulator and launch your application.
Alternatively, you can use the ant install
target to install / reinstall the
debug package.
Thanks
This work is based on / inspired by Technomancy's Android / Mirah experiments.
If you'd like to help out, contributions are definitely welcome. Mirah is very slick, and with a little work we can make it a great alternative to Java for Android development. Transform and roll out!
Copyright (c) 2010 Nick Plante. See LICENSE.txt for further details.