Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zapnap/protoform

A Mirah Android app generator - also check out Pindah http://github.com/mirah/pindah
https://github.com/zapnap/protoform

Last synced: about 2 months ago
JSON representation

A Mirah Android app generator - also check out Pindah http://github.com/mirah/pindah

Host: GitHub
URL: https://github.com/zapnap/protoform
Owner: zapnap
License: mit
Created: 2010-11-28T16:02:12.000Z (about 14 years ago)
Default Branch: master
Last Pushed: 2011-02-01T17:48:01.000Z (almost 14 years ago)
Last Synced: 2024-10-19T03:42:53.130Z (3 months ago)
Language: Ruby
Homepage:
Size: 113 KB
Stars: 14
Watchers: 1
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md
- Changelog: History.txt
- License: LICENSE.txt

Awesome Lists containing this project

README

# 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!