webpack-target-titanium

Titanium target for Webpack, based on the built-in Node target.

Getting started

First install the Titanium target for Webpack.

npm i webpack-target-titanium --save-dev

Now you can use the Titanium target in your Webpack configuration.

const { GenerateAppJsPlugin, titaniumTarget } = require('webpack-target-titanium');

module.exports = {
  target: titaniumTarget,
  entry: {
    bundle:'./src/main.js',
  },
  plugins: [ new GenerateAppJsPlugin([ 'bundle' ]) ]
};

The GenerateAppJsPlugin will generate the app.js and insert require calls to all specified chunks. Splitting your code between multiple chunks is not yet supported, so make sure to always set it to the entry chunk name.

Plugins

The Titanium target comes with two other plugins that improve the devolpment experience when using Webpack and Titanium together.

Platform plugin

The PlatformAwareFileSystemPlugin tells Webpack to prefer platform specific files if they are present. A require to ./utils.js, for example, checks for ./utils.<platform>.js and uses that path if the files exists. The current platform to check for needs to be specified via the platform option.

The following example uses Webpack's environment variables to set the current platform:

const { PlatformAwareFileSystemPlugin } = require('webpack-target-titanium');

module.exports = (env, args) => ({
  plugins: [
    new PlatformAwareFileSystemPlugin({ platform: env.platform })
  ]
});

Appc Daemon support plugin

The WatchStateNotifierPlugin is used to communicate build status updates between Webpack and the @appcd/plugin-webpack. Make sure to include it if you use the appcd plugin.

const { WatchStateNotifierPlugin } = require('webpack-target-titanium');

module.exports = (env, args) => {
  const config = {
    // ...
  }
  
  if (!env.production) {
    config.plugins.push(new WatchStateNotifierPlugin());
  }
  
  return config;
}

Contributing

Open source contributions are greatly appreciated! If you have a bugfix, improvement or new feature, please create an issue first and submit a pull request against master.

Getting Help

If you have questions about bundling apps for Titanium with Webpack, feel free to reach out on Stackoverflow or the #helpme channel on TiSlack. In case you find a bug, create a new issue or open a new JIRA ticket.

License

Apache License. Version 2.0