This package provides the following services:
Atom plugin for Titanium
This is a fork of the official plugin at https://github.com/appcelerator/atom-appcelerator-titanium
Offers the following additional features:
- Fastbuild - rather than building from scratch each time, a filewatcher copies changed files into the existing apk
- Automatically opens the debugger within atom (requires Titanium 7 build)
- Enhanced console
Getting Started
- Only supports windows
- Add the android build-tools to your path - C:\Users{user.name}\AppData\Local\Android\Sdk\build-tools\27.0.3
- Debug builds require Titanium 7
- By default runs builds via
ti build
if you useappc run
there is an option in the settting menu to customize this
Features
Run
- Run (alt-f9)
- Debug (alt-f10) add debug flags to build, requires Titanium 7, will allow you to debug your application within atom using the Chrome Dev tools.
- Fastbuild (alt-f11) see below
Debugging
As long as the debug flag is present in the build, the extension scans logs look for the developer tools link and automatically opens it up within atom. By default Titanium 7 breaks on the first execution line, however this plugin will skip that. There is an option in the settings menu if you want to return to the default behavior. The dev tools slightly more limited than what is present in Chrome, but will give you access to the source and console - use ctrl-p to search for a file.
Fastbuild
This consists of two parts a) a file watcher that observes all changes to your /Resources directory and copies the changes into the unsigned apk in the build directory. b) the fastbuild button, this re-signs the apk and redeploys it to your device, hooking up logcat and the debugger.
Notes:
- this only looks for JavaScript files
- this will only work for changed files, added and deleted files will need a new build, this is because the Titanium build process indexes JavaScript files so you'll need to rebuild to have them included in the index.
- Even if nothing has changed, fastbuild serves as a useful way of re-deploying a previous build to your device in a way that hooks up logcat and the debugger.
Console
This displays android logcat logs filtered to the pid of your deployed app. This does not log app crashes, so if you want to investigate a crash you'll need Android Studios logcat open.
It also comes with a couple of features over the official Titanium atom plugin:
- Filter lines by regular expression
- Set minimum log level to show, this can be changed while the app is running (the official plugin sets the build log level)
- Automatically scrolls to bottom
- Clear logs (ctrl-l), by default the console will also clear build logs after a successful build
Additional Configuration
Addtional settings are available via the cog in the top right-hand corner