ac

appc-compat

Intermediator for the new Appcelerator "appc" CLI and the old "ti", "alloy" and "acs" CLI.

Showing:

Popularity

Downloads/wk

9

GitHub Stars

4

Maintenance

Last Commit

6yrs ago

Contributors

2

Package

Dependencies

1

Size (min+gzip)

2.4KB

License

Apache-2.0

Type Definitions

Tree-Shakeable

No?

Categories

Readme

Appcelerator CLI Compatibility

Since 4.0, the Appcelerator Platform has a single appc CLI that bundles local versions of the former ti, alloy and acs CLI. You can still use the embedded CLIs by calling appc ti instead of ti. You can also still install the other three CLIs directly from NPM, in particular to work on projects that you have not (yet) migrated from the OSS software to the Appcelerator Platform.

Some community tools like TiNy and TiShadow relied on these old CLIs and will now have to work in environments where either or both the new unified and old global CLIs are installed. This module and CLI takes care of that.

Module API

The primary use of this package is to be used as a module, which will try to use the former global CLIs and fall back to the unified.

var compat = require('appc-compat');

compat.ti(['info', '-t', 'ios'], {
    // options
}, function(err, out, code) {
    // do something
});

Other available methods are:

  • compat.spawn(cmd, args, opts, cb);
  • compat.spawnSync(cmd, args, opts);
  • compat.tiSync(args, opts);
  • compat.titanium(args, opts, cb);
  • compat.titaniumSync(args, opts);
  • compat.alloy(args, opts, cb);
  • compat.alloySync(args, opts);
  • compat.acs(args, opts, cb);
  • compat.acsSync(args, opts);

You can pass preferAppc:true in the opts argument to first try the unified CLI and fall back to the former global CLIs.

Finally, you can check the existence of various CLIs via these boolean properties:

  • compat.hasAppc;
  • compat.hasTi;, compat.hasTitanium;
  • compat.hasAlloy;
  • compat.hasAcs;

CLI

The package also installs a new appc-compat CLI, which will try to use the former global CLIs and fall back to the unified.

$ appc-compat ti info

Or pass the --prefer-appc option to first try the unified CLI and fall back to the former global CLIs:

$ appc-compat ti info --prefer-appc

Alias

If you want the convenience of the former shorter CLIs for those embeded in the new unified CLI just use a bash alias in your ~/.bash_profile:

alias ti='appc ti'
alias alloy='appc alloy'
alias acs='appc acs'

Don't forget to:

source ~/.bash_profile

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100