External Lib Definition Test

This is an example of library definition where:

• It is encapsulated an external library: babel polyfills (support for async/await).
• It is defined a custom control.

The important parts here, are the following:

• webapp/library.js: Basically defines and initialize the library:

/*eslint no-unused-vars: ["error", { "varsIgnorePattern": "polyfill" }]*/
import polyfill from "./lib/polyfill"; // Here is where are imported the babel polyfills resources.

let oLibrary = sap.ui.getCore().initLibrary({
    name: "iamsoft.libs.external.polyfill",
    noLibraryCSS: true,
});

export default oLibrary;

• manifest.json: Here we tell to UI5 that we are defining a library.

    "sap.app": {
        "id": "iamsoft.libs.external.polyfill",
        "type": "library"
    }

• Gruntfile.js: Here we tell to openui5_preload task that we are defining a library (this is for the library-preload.js bundle creation).

    openui5_preload: {
        component: {
            options: {
                resources: {
                    cwd: "transp",
                    prefix: "iamsoft/libs/external/polyfill"
                },
                dest: "<%= dir.dist %>",
                compatVersion: "1.52",
            },
            libraries: true
        }
    },

Getting started

1.Install node.js (get it from nodejs.org).

• If working behind a proxy, you need to configure it properly (HTTP_PROXY / HTTPS_PROXY / NO_PROXY environment variables)

2.Install grunt-cli globally

npm install grunt-cli -g

3.Clone the repository and navigate into it

git clone https://github.com/sebasgoldberg/external-libs.git
cd external-libs

4.Install all npm dependencies

npm install

5.Run grunt to lint, build and run a local server (have a look into Gruntfile.js to see all the tasks).

grunt

7.Open the app in your browser: http://localhost:7081

Some notes

1.You can code using ES8.

2.Is possible to use async/await (babel-polyfills already imported in Component).

3.Transpiled version and Dist version use different ports (see grunt file).

4.UI5 preload compatible version was set for the current LTS version: 1.52.

5.Remember to change to your own namespace.