grunt-tdevopsui5

UI5 tools for build/deploy/version managment of ui5 applicaton


Keywords
gruntplugin, sapui5tooling, buildtools, ui5
License
MIT
Install
npm install grunt-tdevopsui5@0.1.11

Documentation

grunt-tdevopsui5

Grunt tasks for build/deploy/version management of ui5 application It's just small workaround to reduce gruntfile in project the tasks:

  • build (preload, js/css mini, resources, cachebooster-file, dbg files);

  • deploy (to ABAP server via grunt-nwabap-ui5uploader + version + git tag for production);

  • version (custom file to manage version in ABAP server);

  • server (simple HTTP server to run webapp (UI5) with proxy to SAP Backend)

// version file example
{
  "current": {
    "version": "2.0.1",
    "user": "*****",
    "system": "XPF",
    "tr": "XPF*****",
    "date": "2019-10-03T07:38:03.593Z",
    "note": "Develop version (not stable)",
    "hash": "e1900bd8880a3113aacad0f88903b8ba23d3541e"
  },
  "history": []
}

Getting Started

This plugin requires Grunt ~1.0.4

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-tdevopsui5 --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-tdevopsui5');

The "grunt-tdevopsui5" task

Overview

In your project's Gruntfile, add a section to the data object passed into grunt.initConfig().

grunt.initConfig({
  // config example for using tasks
  tdevopsui5_build: {
    test: {
      options: {
        // folders
        appName: 'Test application',
        src: 'test/src',
        dest: 'test/dist',
        tmp: 'test/tmp',
        ui5Resource: 'C:/SAPUI5/1.52.13/resources',
        // options
        babel: false,
        // preload
        appIndex: 'test',
        ui5version: '1.52',
        library: false,
        lib_comp: false,
        lib_to_resources: false,
        customOptions: {}, // not used for now
      },
    },
  },
  tdevopsui5_version: {
    test: {
      options: {
        type: 'M',
        dest: 'test/src',
        user: 'Test',
        transport: 'SYSNONE',
        tag: false,
        tagText: '',
        note: 'Test note M',
      },
    },
  },
  tdevopsui5_deploy: {
    gus: {
      options: {
        // abap options
        package: 'ZTESTADAN',
        bspcontainer: 'ZTEST_UI5',
        bspcontainer_text: 'UI5 Application',
        transportno: 'GUSK900018',
        calc_appindex: true,
        // folder
        dest: 'test/dist',
        src: 'test/src',
        // server info
        server: 'https://***:4443',
        client: '200',
        useStrictSSL: false,
        // credential
        user: '*********',

        pwd: '*********',

        // version
        version: 'P', // 'D', 'P', 'M'
      },
    },
  },

  tdevopsui5_server: {
    test: {
      options: {
        remoteServer: 'https://*****',
        remoteUrlPrefix: '/sap',
        user: '***',
        pwd: '***',
        localPort: '3025',
        // resources
        ui5resources: 'C:\\SAPUI5\\1.52.13\\resources',
        appSource: 'test/source',
      },
    },
  },
});

Options

in process

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Release History

  • 0.1.9: Version task - history is deprecated; added changing manifest.json (sap.app - applicationVersion)