[ROADMAP] Specification Version 2.0 // UI5 CLI 2.0

[RandomByte]

This is a list of possible changes that might be implemented with UI5 CLI 2.0. It is not final. Feedback is appreciated.

Current master branches of all UI5 Tooling repositories (except UI5 Tooling) reflect v2.0 development.

Specification Version 2.0

specVersion: '2.0'

Breaking Changes

• Schema validation of ui5.yaml: UI5 Project will error out for unrecognized fields or wrong values ([FEATURE] Add Configuration Schema ui5-project#274)
• Require namespace for application and library projects: UI5 Project must be able to determine the projects namespace. E.g. through the manifest.json or .library file (https://github.com/SAP/ui5-builder/pull/430/files)
  • A manual configuration in the ui5.yaml is not allowed. This is to make sure that UI5 runtime also has access to it
• By default, .properties files are assumed to be UTF-8 encoded instead of ISO-8859-1 (documentation)

Features

• (possibly 3.0) Going forward, there are separate Specification Versions for Extensions and Projects as outlined here: https://github.com/SAP/ui5-project/issues/167
• New metadata attributes deprecated and restricted will display warnings when such a project is used as a direct dependency ([FEATURE] projectPreprocessor: Log warning when using a deprecated or restricted dependency ui5-project#268)

UI5 CLI 2.0

@ui5/[email protected]

Breaking changes

• Drop support for Node.js Version <10 (or possibly <12): Node.js 8 and 9 are EOL
  • Various dependencies require Node.js 10 now
• Remove export of all sub-modules from each UI5-modules index.js: Synchronous require of unneeded modules is bad for performance. Example
  • ~Alternative to be discussed~~
  • ➡️ Implemented lazy requires in all index.js
• Remove synchronous export of all tasks in UI5 Builder taskRepository
• Remove deprecated useNamespaces parameter from UI5 Project resourceFactory.createCollectionsForTree API ([BREAKING] Remove deprecated parameter useNamespaces ui5-fs#223)
• Bump Yargs

Features

• Support for Specification Version 2.0 ([FEATURE] Support for spec version 2.0 ui5-project#277)
• UI5 installer ([FEATURE] Add ui5Framework translator and resolvers ui5-project#265)
  • Required for consuming SAPUI5 libraries from npm. Blog post coming soon!
• builder: [FEATURE] buildThemes: Add filtering for available themes
• server: [FEATURE] Add test runner middleware

Bug Fixes

• UI5 Server: Node 12.8.0 and --h2 option leads to crash

[bd82]

I believe Node.js 10 support should be kept until 04/2021 to align with Node.js LTS schedule.

• https://nodejs.org/en/about/releases/

[cschuff]

Would love to see schema validation and json schemas for ui5.yaml. That could as well lead to more tooling support coming from the community :)

[RandomByte]

Everything that is ticked off has bee released with UI5 CLI v2.0.1 🎉

Resources:

• Migration Guide for UI5 Tooling v2
• SAPUI5 Consumption
  • Announcement Blog Post
  • Technical Blog Post
  • Documentation
• Updated Getting Started
• openui5-sample-app will be updated soon