The document describes the updates and features of Titanium CLI 3.2, detailing improvements such as a complete overhaul, better SDK handling, and faster build processes for both Android and iOS. It outlines new commands, plugin architecture, and packaging options for CLI plugins, along with enhancements to the user experience and environment configurations. The author, Chris Barber, offers insights into the CLI's capabilities and encourages feedback through contact information.

1. Titanium 3.2 CLI
Chris Barber
Titanium Engineer Extraordinaire
TiAppCamp 2 / Nov 2, 2013

2. About Me
• Been with Appc 3 ½ years
• Stuff I've done
– Early versions of www site
– Dev center Q&A
– Titanium Mobile Web
platform
– Titanium CLI
– Titanium platform build
scripts
• JavaScript Guru

3. What's New in 3.2
Titanium 3.0.0,
3.0.1, 3.0.2, 3.0.3
Titanium 3.1.0,
3.1.1, 3.1.2, 3.1.3
Titanium 3.2.0
778
816
1717+

4. Titanium CLI

5. Titanium CLI
•
•
•
•
Complete overhaul
Better selected SDK handling
New setup wizard
New prompting library
– http://npmjs.org/package/fields
• Command improvments
– info, module, plugin, sdk, setup
• More config settings
• Unit tests

6. Setup Command
• New menu design
• Improved quick setup
• New check environment

7. Info Command
• node-appc versions
• Mac OS X command line
tools
• Intel HAXM (Hardware
Accelerated Execution
Manager)
• Xcode support
• Improved iOS cert and
provisioning profile detection
• Android & iOS Devices &
Emulators/Simulators
• Environment Issues

8. Config Settings
•
•
•
•
•
•
•
•
•
•
cli.ignoreDirs
cli.ignoreFiles
cli.progressBars (true)
cli.width (100)
paths.hooks
paths.modules
paths.plugins
paths.sdks
sdk.defaultInstallLocation
sdk.selected (formerly
app.sdk)

9. Android Build

10. Android Build
•
•
•
•
•
•
Complete rewrite from Python to Node.js
Support for CLI plugins
Android 2.3.3 no longer required
Builds are about 13% faster
Nearly 100 bug fixes
Distribution builds much, much faster thanks
to UglifyJS
• Support for multiple emulators AND devices
• No longer creates AVDs, you manage your
own

11. •
•
•
•
•
Fast x86 Android emulator
Built on top of VirtualBox
Beta support with Titanium
http://www.genymotion.com/
titanium config
genymotion.enabled true

12. iOS Build

13. iOS Build
•
•
•
•
•
•
•
•
Builds are about 20% faster
Xcode 5.0.1 and iOS 7.0.3 support
64-bit iOS Simulator support
iOS Simulator profiles
Fixed several bugs
Improved validation
Improved symbol detection
Certificate and provisioning profile
selection

14. No More iTunes Sync
• Direct install to iOS device
• Insanely fast
• Supports install to multiple devices
simultaneously
• https://npmjs.org/package/node-ios-device

15. CLI Plugins

16. CLI Plugins
• Contains commands, event hooks, &
function hooks
• Global and per-project
• Global and Module hooks

17. Anatomy of a CLI Command
• /some/dir/mycommand.js
• ti config -a paths.commands /some/dir
• ti mycommand -baz wow

18. Anatomy of a CLI Hook
• /some/dir/myhook.js
• ti config -a paths.hooks /some/dir

19. Packaging a CLI Plugin
• Global plugins go in ~/Library/Application
Support/Titanium/plugins
– Can contain commands and hooks
– Automatically loaded for every Titanium
command

20. Packaging a CLI Plugin
• Project plugins go in <project dir>/plugins
• Can contain hooks only
– Loaded by "build" and "clean" commands
• Must be enabled in tiapp.xml

21. Available Plugin Hooks
Event Hooks
Function Hooks
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
cli:command-not-found
cli:command-loaded
cli:pre-validate
cli:post-validate
cli:pre-execute
cli:post-execute
help:header
build.pre.construct
build.pre.compile
build.post.compile
build.finalize
build.config
build.android.config
build.android.copyResource
build.android.compileJsFile
build.android.dexerArgs
build.android.javacArgs
build.android.writeBuildManifest
build.android.startEmulator
build.ios.config
build.ios.writeBuildManifest
build.ios.copyResource
build.ios.compileJsFile
build.mobileweb.config
clean.config

22. How to get it:
npm install -g
git://github.com/appcelerator/titaniu
m.git
ti sdk install -b master -d
DISCLAIMER: This is not fully tested. This is not stable code. Use at your own risk.

23. Future Ideas

24. Build Profiles
• Controls build settings
– JavaScript minification
– JavaScript encryption
– Debugging
– etc
• Global or per-project
• Project-level defined in
tiapp.xml
– Can contain any tag

25. Build Profiles

26. Export Command
• Generate standalone Xcode (iOS) or
Eclipse (Android) projects
• No dependency on Titanium
• Replaces transport.py

27. Improved Logging
•
•
•
•
•
Console-only today
File logging, especially for builds
Destination specific logging
Timestamps
Force specific locale

28. Titanium Daemon
• Server that runs in background
• Plugin architecture
• Device notifications
– Connected devices
• Environment caching
• Check for Titanium updates
• Web server plugin w/ interface
– Environment info (same as "ti info")
– Debug proxy
– Serve Titanium Mobile Web apps
• Run similar to "adb"
– Do not require root priviledges

29. ?
Questions?

30. Thank you!
cbarber@appcelerator.com
Twitter: @cb1kenobi