cds-launchpad-plugin

Launchpad Plugin for demo / development / testing SAP Cloud Application Programming Model-based projects

Installation

In your project, run following command:

1npm install --save-dev cds-launchpad-plugin

Usage

SAP Cloud Application Programming (CAP) Model 6.7.0 or higher

The cds-launchpad-plugin is using the SAP Cloud Application Programming Model plugin technique. Installing the plugin as a dev dependency (see installation) is sufficient to enable the plugin automatically.

Configuration

Optionally you can configure the cds-launchpad-plugin by adding following configuration to your package.json file.

1"cds": {
2  "launchpad": {
3    "theme":"sap_horizon", // SAPUI5 Theme
4    "version": "1.120.1", // SAPUI5 Version
5    "basePath": "", // Path under which you want the sandbox to be served
6    "appConfigPath": "", // External sandbox appconfig json file to be merged with generated appconfig
7    "locale": "", // Language to be used for the sandbox environment
8    "template": "" ,// 'legacy' (non-async launchpad, default) or 'async' (async launchpad),
9    "modulePaths": "" // object with module paths to be used in the launchpad.html file for "sap-ushell-config"
10  }
11}

The sandbox launchpad will be served on /$launchpad, like http://localhost:4004/$launchpad

SAP Cloud Application Programming (CAP) Model 6.7.0 or lower

Have this in your server.js:

1const cds = require ('@sap/cds');
2
3/* For releases before cds 7:
4replace:
5cds.env.production === false
6with:
7process.env.NODE_ENV !== 'production'
8*/
9if (cds.env.production === false){
10    const {cds_launchpad_plugin} = require('cds-launchpad-plugin');
11
12    // Enable launchpad plugin
13    cds.once('bootstrap',(app)=>{
14        const handler = new cds_launchpad_plugin();
15        app.use(handler.setup({theme:'sap_horizon', version: '1.120.1'}));
16    });
17}

The sandbox launchpad will be served on /$launchpad, like http://localhost:4004/$launchpad

Configuration

Call setup({...}) method with the following object (configuration object can be omitted):

1{
2  theme:'sap_horizon', // SAPUI5 Theme
3  version: '1.99.0', // SAPUI5 Version
4  basePath: '', // Path under which you want the sandbox to be served
5  appConfigPath: '', // External sandbox appconfig json file to be merged with generated appconfig
6  locale: '', // Language to be used for the sandbox environment
7  template: '', // 'legacy' (non-async launchpad) or 'async' (async launchpad)
8  modulePaths: '' // object with module paths to be used in the launchpad.html file for "sap-ushell-config"
9}

External references

Solution overview: https://blogs.sap.com/2022/03/14/a-fiori-launchpad-sandbox-for-all-your-cap-based-projects-overview/

Sample project setup: https://blogs.sap.com/2022/03/14/a-fiori-launchpad-sandbox-for-all-your-cap-based-projects-sample-project-setup/

Development

Prerequisites

• node 18
• pnpm

Setup

1git clone https://github.com/geert-janklaps/cds-launchpad-plugin
2cd cds-launchpad-plugin
3pnpm install
4pnpm watch
5# run cds server
6pnpm dev:sapux
7# go to http://localhost:4004/$launchpad