Provide and document options to reduce content of build result

[matz3]

Expected Behavior

When executing a build, a lot of files are written to the dist folder that might not be required at runtime, such as:

• All locale/language-specific files (CLDR, messagebundle_*.properties)
• All themes (incl. RTL-variants)
• Individual JS files that are part of a bundle (e.g. sap-ui-custom.js / library-preload.js / Component-preload.js)

This is relevant when packaging the app e.g. with Cordova, as the application bundle can become quite large. It also speeds up deployment e.g. when uploading the files to a server.

It would be helpful if a project could declare/define which locales/languages/themes should be supported. By default all variants should be used.

Current Behavior

It is currently only possible to exclude -dbg.js files

• via API excludedTasks: ["createDebugFiles"]
• or via CLI option --exclude-task=createDebugFiles

Context

• UI5 Module Version (output of ui5 --version when using the CLI): 0.2.6

Affected components (if known)

• [x] ui5-builder
• [ ] ui5-server
• [x] ui5-cli
• [ ] ui5-fs
• [ ] ui5-project
• [ ] ui5-logger

[miffels]

Background is a Cordova build I made using the basic template app as web content. These are the results of ui5 build self-contained --dest www --all --exclude-task=createDebugFiles

This is an overview by file type - you can see that 65% of the build is just JSON, CSS and .properties files.

Digging deeper it becomes apparent that most of this is related to localization, themes and RTL/LTR layouts.

The other thing is that many of the js files are redundant with the sap-ui-custom.js built this way, and ideally those bundled files would be removed. Files not bundled this way are probably dead weight, too, if the intention is to bundle everything declared by the app.

[jrondorf]

@matz3 Hi Matthias, is it possible to specify excludedTasks: ["createDebugFiles"] in ui5.yaml file ?

This does not work:

specVersion: '1.0'
metadata:
  name: ui5_compile
type: application
builder:
  excludedTasks: 
    - createDebugFiles

[matz3]

@jrondorf my example was related to the API. When using the CLI this needs to be passed as option on the command line (--exclude-task=createDebugFiles), e.g:

ui5 build self-contained --all --exclude-task=createDebugFiles

[jrondorf]

@matz3 Thanks, this works fine. Grüße, Jannis

[RandomByte]

Possible task for us: Document options to reduce size of build results

[gregorwolf]

Hi @RandomByte,

was the Documentation improved already in this direction?

CU Gregor