tobiashofmann / generator-ui5-flp-plugin

Generator for Fiori Launchpad plugin which uses the official UI5 tooling. This generator built as a plug-in for the community project Easy-UI5 by SAP.

Generator for SAPUI5 Fiori Launchpad Plugin

Generator for UI5 Fiori Launchpad Plugin using UI5 Tooling. (based on the Easy UI5 Generator)
Includes

• Fiori Launchpad Plugin Component
• Shell Extension Code Samples
• Opa5 Test enabled

Usage with easy-ui5

$> npm i -g yo
$> yo easy-ui5 flp-plugin

     _-----_
    |       |    ╭──────────────────────────╮
    |--(o)--|    │  Welcome to the easy-ui5 │
   `---------´   │        generator!        │
    ( _´U`_ )    ╰──────────────────────────╯
    /___A___\   /
     |  ~  |
   __'.___.'__
 ´   `  |° ´ Y `

Run you can use npm start (or yarn start) to start the local server for development.

Standalone usage

Note the different greeting when the generator starts.

$> npm i -g yo
$> yo ./generator-ui5-project

     _-----_     ╭──────────────────────────╮
    |       |    │      Welcome to the      │
    |--(o)--|    │    generator-flp-plugin  │
   `---------´   │        generator!        │
    ( _´U`_ )    ╰──────────────────────────╯
    /___A___\   /
     |  ~  |
   __'.___.'__
 ´   `  |° ´ Y `

Target platforms

During the prompting phase, the generator will ask on which target platform your app should run. Currently, the following options are available:

Static webserver

This is the most basic option. Choose this option if you want to deploy the web app in your custom environment or host it on an arbitrary server.

SAP Launchpad service

Use this option if you would like to develop a Fiori Launchpad application that should run on Cloud Foundry. The generator will install a module that adds Fiori Launchpad resources to the HTML5 application repository.

SAP NetWeaver

Use this option if you want to deploy your application(s) to the SAP NetWeaver ABAP Repository.

Test Application

npm run test

Deployment

Depending on your target platform you'll need to install additional tools:

Cloud Foundry

Required tools:

1. Create a free account on SAP BTP Trial
2. Install the Cloud Foundry Command Line Interface

   cf login

3. Install the MultiApps CF CLI Plugin

Deployment steps:

Call this command from the root directory to deploy the application to Cloud Foundry

npm run deploy

SAP NetWeaver

Deployment steps:

Update the ui5.yaml file with your system settings (user, password & server) and ABAP repository settings (package, BSP Container & Transport). Run following command to deploy the application to SAP NetWeaver

npm run deploy

Support

Please use the GitHub bug tracking system to post questions, bug reports or to create pull requests.