gulp-angular

A collection of gulp tasks for developing angular applications and deploying them to the Web, Cordova and Node-Webkit containers.

Getting Started

To bootstrap a project using gulp-angular you need to take the following steps:

• initialize a your Project as a node-module with npm init
• install gulp and gulp-angular with npm install --save-dev gulp && npm install --save-dev antwerpes/gulp-angular
• create a minimal gulpfile.js with the following contents:

'use strict';

var gulp = require('gulp');

var gulpAngularConfig = {
    // the module name is the only required parameter.
    // For more see config/config.example.json or config/gulp-angular.conf.coffee
  "angularModuleName": 'MyApp'
}

require('gulp-angular')(gulp, gulpAngularConfig);

• run gulp create:project to generate the basic app structure
• run bower install to install angular.js

Most used Tasks.

Development

Build

Scaffolding

• For options in nwjs builder (/package.json/gulp-angular-config/webkit) see options in https://github.com/mllrsohn/node-webkit-builder

Cordova

Prerequisites

• If used together with the web module, make the cordova www directory a symlink to the dist directory.
• Your project needs to be a valid cordova project that has a config.xml file, www and hooks directories.
• Optionally a cordova hook script that runs 'after_platform_add' for configuring the android project to generate signed apk files (see below).

Setup the Cordova Project

cordova create path/to/cordova de.bundle.identifier appname

the '.' is important as it will make the current project a cordova app

/package.json (example)

{
    ...
    "gulp-angular": {
        "cordova": {
            "build": {
                "appName": "", /* same value as the <name> field inside config.xml */
                "ftp": { /* used to publish ipa and apk files to an FTP server */
                    "hostname": "",
                    "username": "",
                    "password": "",
                    "directory": ""
                },
                "ios": { /* used for building signed ipa files */
                    "provisioningProfile": "" /* name as it appears in Xcode build settings */
                },
                "android": { /* used for building signed apk files */
                    "sign": [ /* text will be copied into platforms/android/ant.properties */
                        "key.store=", /* path to exported keystore file */
                        "key.store.password=",
                        "key.alias=",
                        "key.alias.password="
                    ]
                }
            }
        },
        ...
    }
}

Tasks

Development

cd /path/to/projects/folder
git clone git+ssh://git@github.com/antwerpes/gulp-angular.git
cd gulp-angular
npm link
cd /path/to/project/using/gulp-angular
npm link gulp-angular