CLI Toolbelt for Titanium Mobile 2.x development on Mac OS X.
Ruby
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib
spec
.gitignore
CHANGELOG.md
Gemfile
LICENSE
README.md
Rakefile
alloy.gemspec

README.md

alloy

Code Climate

CLI Toolbelt for Titanium Mobile development on Mac OS X.

Prerequisite

  • Mac OS X 10.7
  • Titanium Studio 2.0
  • Ruby 1.9.3
  • CoffeeScript

Usage

Setup

$ cd /path/to/titanium-workspace/HelloWorld
$ alloy init
      create  alloy.json

Compiling CoffeeScript into JavaScript

You should place *.coffee files under the directory named app.

$ mkdir app
$ echo "Ti.API.console 'Hello'" > app/hello.coffee

Then, run coffee task.

$ alloy coffee
Compiling CoffeeScript
Successfully compiled CoffeeScript

JavaScript files generated under the Resources directory.

$ cat Resources/hello.js
// Generated by CoffeeScript 1.3.1

Ti.API.console('Hello');

Cleaning up build directory

Run clean task to clean up intermediate files (build/iphone/* or build/android/*).

$ alloy clean iphone
$ alloy clean android

Building app and run in iPhone simulator

$ alloy build iphone

Building app and run in Android emulator

Before using alloy, you need to create and setup a AVD (Android Virtual Devices) for rapid development process.

AVD setup

  1. Launch Android SDK Manager. Install SDK Platform and Google APIs of any Android versions (at least greater than Android 2.2)`

    $ ANDROID_SDK_HOME/tools/android &
    
  2. Check what Android target availables

    $ ANDROID_SDK_HOME/tools/android list targets
    Available Android targets:
    ----------
    id: 1 or "android-15"
         Name: Android 4.0.3
         Type: Platform
         API level: 15
         Revision: 3
         Skins: HVGA, QVGA, WQVGA400, WQVGA432, WSVGA, WVGA800 (default), WVGA854, WXGA720, WXGA800
         ABIs : armeabi-v7a, x86
    ----------
    id: 2 or "Google Inc.:Google APIs:15"
         Name: Google APIs
         Type: Add-On
         Vendor: Google Inc.
         Revision: 2
         Description: Android + Google APIs
         Based on Android 4.0.3 (API level 15)
         Libraries:
          * com.google.android.media.effects (effects.jar)
              Collection of video effects
          * com.android.future.usb.accessory (usb.jar)
              API for USB Accessories
          * com.google.android.maps (maps.jar)
              API for Google Maps
         Skins: WVGA854, WQVGA400, WSVGA, WXGA720, HVGA, WQVGA432, WVGA800 (default), QVGA, WXGA800
         ABIs : armeabi-v7a
    
  3. Create a new AVD

    $ ANDROID_SDK_HOME/tools/android create avd \
      -n my_android-4.0.3 \
      -t 1 \
      --abi armeabi-v7a \
      --skin WVGA800
    

    my_android-4.0.3 is AVD name, 1 is ID of Android target.

    AVD created under ~/.android/avd.

    $ ls -la ~/.android/avd
    total 8
    drwxr-xr-x  4 juno  staff  136  6  1 00:56 .
    drwxr-xr-x  6 juno  staff  204  6  1 00:51 ..
    drwxr-xr-x  4 juno  staff  136  6  1 00:56 my_android-4.0.3.avd
    -rw-r--r--  1 juno  staff   69  6  1 00:56 my_android-4.0.3.ini
    
    $ ANDROID_SDK_HOME/tools/android list avd
    Available Android Virtual Devices:
        Name: my_android-4.0.3
        Path: /Users/juno/.android/avd/my_android-4.0.3.avd
      Target: Android 4.0.3 (API level 15)
         ABI: armeabi-v7a
        Skin: WVGA800
    

    Yay!

  4. Enable SD Card support to install application

    $ echo "sdcard.size=256M" >> ~/.android/avd/my_android-4.0.3.avd/config.ini
    

Running Android emulator

  1. Start adb server

    $ ANDROID_SDK_HOME/platform-tools/adb start-server
    
  2. Launch Android emulator

    $ ANDROID_SDK_HOME/tools/emulator -avd my_android-4.0.3
    

    After Android launch, emulator instance appears as a device.

    $ ANDROID_SDK_HOME/platform-tools/adb devices
    List of devices attached
    emulator-5554   device
    

Build and install application to emulator

$ alloy build android

Shutting down Android emulator

  1. Exit Android emulator app

  2. Kill adb server

    $ ANDROID_SDK_HOME/platform-tools/adb kill-server
    

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request