@sapui5/sap.ushell 1.139.0 → 1.141.0

package/src/main/js/sap/ushell/appRuntime/ui5/libsPreload.js

@@ -1,4 +1,4 @@
 // Copyright (c) 2009-2025 SAP SE, All Rights Reserved
 /* eslint-disable */
-try {document.getElementById('sap-ui-bootstrap').setAttribute("data-sap-ui-libs","sap.ui.core,sap.m,sap.ui.fl");} catch (e) {}
-try {document.getElementById('sap-ui-bootstrap').setAttribute("data-sap-ui-compatVersion","edge");} catch (e) {}
+try {document.getElementById('sap-ui-bootstrap').setAttribute("data-sap-ui-libs","sap.ui.core,sap.m,sap.ui.fl");} catch {}
+try {document.getElementById('sap-ui-bootstrap').setAttribute("data-sap-ui-compatVersion","edge");} catch {}

package/src/main/js/sap/ushell/appRuntime/ui5/performance/FesrEnhancer.js

@@ -101,7 +101,7 @@ sap.ui.define([
                     } else {
                         this._currentAppShortId = undefined;
                     }
-                } catch (e) {
+                } catch {
                     this._currentAppShortId = undefined;
                 }
             }

package/src/main/js/sap/ushell/appRuntime/ui5/plugins/baseRta/AppLifeCycleUtils.js

@@ -2,7 +2,15 @@
  * Copyright (c) 2009-2025 SAP SE, All Rights Reserved
  */
 
-sap.ui.define([], () => {
+sap.ui.define([
+    /*
+     * Be careful with new dependencies.
+     * Only include dependencies that are already bundled in
+     * core-min/core-ext, appruntime or the flex-plugins bundle
+     * otherwise load the library lazily before use.
+     */
+], (
+) => {
     "use strict";
 
     const AppLifeCycleUtils = {
@@ -15,8 +23,8 @@ sap.ui.define([], () => {
             const oContainer = AppLifeCycleUtils.getContainer();
             return oContainer.getServiceAsync("AppLifeCycle")
                 .catch((vError) => {
-                    const sError = `Error getting AppLifeCycle service from ushell container: ${vError}`;
-                    throw new Error(sError);
+                    const sErrorMessage = `Error getting AppLifeCycle service from ushell container: ${vError}`;
+                    throw new Error(sErrorMessage);
                 });
         },
 

package/src/main/js/sap/ushell/appRuntime/ui5/plugins/baseRta/BaseRTAPluginStatus.js

@@ -2,7 +2,15 @@
  * Copyright (c) 2009-2025 SAP SE, All Rights Reserved
  */
 
-sap.ui.define(() => {
+sap.ui.define([
+    /*
+     * Be careful with new dependencies.
+     * Only include dependencies that are already bundled in
+     * core-min/core-ext, appruntime or the flex-plugins bundle
+     * otherwise load the library lazily before use.
+     */
+], (
+) => {
     "use strict";
 
     return {

package/src/main/js/sap/ushell/appRuntime/ui5/plugins/baseRta/CheckConditions.js

@@ -3,12 +3,18 @@
  */
 
 sap.ui.define([
+    "sap/ui/core/Lib",
     "sap/ui/Device",
-    "sap/ui/fl/initial/api/InitialFlexAPI",
     "sap/ushell/appRuntime/ui5/plugins/baseRta/AppLifeCycleUtils"
+    /*
+     * Be careful with new dependencies.
+     * Only include dependencies that are already bundled in
+     * core-min/core-ext, appruntime or the flex-plugins bundle
+     * otherwise load the library lazily before use.
+     */
 ], (
+    Lib,
     Device,
-    InitialFlexAPI,
     AppLifeCycleUtils
 ) => {
     "use strict";
@@ -27,13 +33,13 @@ sap.ui.define([
         },
 
         /**
-		 * Checks if RTA needs to be restarted, e.g after 'Reset to default'.
-		 * The sap.ui.fl library also reacts on the session storage entry and may start RTA
-		 * as well as remove the entry before this function is called.
-		 * @param {string} sLayer - Object with information about the current application
-		 * @returns {boolean} Returns <code>true</code> if RTA restart is required.
-		 * @private
-		 */
+         * Checks if RTA needs to be restarted, e.g after 'Reset to default'.
+         * The sap.ui.fl library also reacts on the session storage entry and may start RTA
+         * as well as remove the entry before this function is called.
+         * @param {string} sLayer - Object with information about the current application
+         * @returns {boolean} Returns <code>true</code> if RTA restart is required.
+         * @private
+         */
         checkRestartRTA: function (sLayer) {
             const oUriParams = new URLSearchParams(window.location.search);
             const sUriLayer = oUriParams.get("sap-ui-layer");
@@ -44,10 +50,20 @@ sap.ui.define([
         },
 
         /**
-		 * Checks if the prerequisites for starting RTA are met
-		 * @returns {boolean} returns true if all checks are resolved with true
-		 */
+         * Checks if the prerequisites for starting RTA are met
+         * @returns {boolean} returns true if all checks are resolved with true
+         */
         checkRtaPrerequisites: async function () {
+            // require InitialFlexAPI lazily to ensure that the library is loaded properly
+            // in theory the library should already be preloaded by the Component.create of the plugin
+            await Lib.load("sap/ui/fl");
+
+            const { promise, resolve, reject } = Promise.withResolvers();
+            sap.ui.require(["sap/ui/fl/initial/api/InitialFlexAPI"], (...modules) => {
+                resolve(modules);
+            }, reject);
+            const [InitialFlexAPI] = await promise;
+
             const aCheckRtaPrerequisites = await Promise.all([
                 this.checkUI5App(),
                 InitialFlexAPI.isKeyUser(),
@@ -57,28 +73,31 @@ sap.ui.define([
         },
 
         /**
-		 * Check if we are in a SAPUI5 application.
-		 * @returns {Promise<boolean>} Resolves to <code>true</code> if we are in a SAPUI5 application.
-		 * @private
-		 */
-        checkUI5App: function () {
-            return AppLifeCycleUtils.getCurrentRunningApplication()
-                .then((oCurrentApplication) => {
-                    if (oCurrentApplication) {
-                        const bIsUI5App = oCurrentApplication.applicationType === "UI5";
-                        const bIsApplication = oCurrentApplication.componentInstance && oCurrentApplication.componentInstance.getManifestEntry
-							&& oCurrentApplication.componentInstance.getManifestEntry("sap.app").type === "application";
-                        return bIsUI5App && bIsApplication;
-                    }
-                    return false;
-                });
+         * Check if we are in a SAPUI5 application that supports key user adaptation.
+         * The app must have application type "UI5", be of type "application" and not have flexEnabled set to false.
+         * @returns {Promise<boolean>} Resolves to <code>true</code> if the conditions are met.
+         * @private
+         */
+        checkUI5App: async function () {
+            const oCurrentApplication = await AppLifeCycleUtils.getCurrentRunningApplication();
+            if (oCurrentApplication) {
+                const bIsUI5App = oCurrentApplication.applicationType === "UI5";
+                if (bIsUI5App && oCurrentApplication.componentInstance && oCurrentApplication.componentInstance.getManifestEntry) {
+                    const bIsApplication = oCurrentApplication.componentInstance.getManifestEntry("sap.app").type === "application";
+                    // Home applications that explicitly want to disable the RTA plugin can set flexEnabled to false in their manifest.
+                    // The standard FLP Home application is of type "component", so it does not need this manifest entry.
+                    const bFlexEnabledFalse = oCurrentApplication.componentInstance.getManifestEntry("sap.ui5")?.flexEnabled === false;
+                    return bIsApplication && !bFlexEnabledFalse;
+                }
+            }
+            return false;
         },
 
         /**
-		 * Check if we are runninng on a desktop device.
-		 * @returns {boolean} Returns <code>true</code> if we are on a desktop device
-		 * @private
-		 */
+         * Check if we are runninng on a desktop device.
+         * @returns {boolean} Returns <code>true</code> if we are on a desktop device
+         * @private
+         */
         checkDesktopDevice: function () {
             return Device.system.desktop;
         }

package/src/main/js/sap/ushell/appRuntime/ui5/plugins/baseRta/Renderer.js

@@ -5,6 +5,12 @@
 sap.ui.define([
     "sap/base/Log",
     "sap/ushell/appRuntime/ui5/plugins/baseRta/AppLifeCycleUtils"
+    /*
+     * Be careful with new dependencies.
+     * Only include dependencies that are already bundled in
+     * core-min/core-ext, appruntime or the flex-plugins bundle
+     * otherwise load the library lazily before use.
+     */
 ], (
     Log,
     AppLifeCycleUtils
@@ -28,8 +34,10 @@ sap.ui.define([
                 });
                 if (bIsVisible) {
                     oUserAction.showForAllApps();
+                    oUserAction.showOnHome();
                 } else {
                     oUserAction.hideForAllApps();
+                    oUserAction.hideOnHome();
                 }
                 return oUserAction;
             } catch (sErrorMessage) {

package/src/main/js/sap/ushell/appRuntime/ui5/plugins/baseRta/Trigger.js

@@ -9,6 +9,12 @@ sap.ui.define([
     "sap/ui/core/Lib",
     "sap/ushell/appRuntime/ui5/plugins/baseRta/BaseRTAPluginStatus",
     "sap/ushell/appRuntime/ui5/plugins/baseRta/AppLifeCycleUtils"
+    /*
+     * Be careful with new dependencies.
+     * Only include dependencies that are already bundled in
+     * core-min/core-ext, appruntime or the flex-plugins bundle
+     * otherwise load the library lazily before use.
+     */
 ], (
     hasher,
     BusyIndicator,

package/src/main/js/sap/ushell/appRuntime/ui5/plugins/rtaAgent/Component.js

@@ -140,15 +140,15 @@ sap.ui.define([
                 "user.postapi.rtaPlugin": {
                     inCalls: {
                         startUIAdaptation: {
-                            executeServiceCallFn: function () {
+                            executeServiceCallFn: async function () {
                                 EventBus.getInstance().subscribe(
                                     "sap.ushell",
                                     "appClosed",
                                     onAppClosed.bind(this)
                                 );
                                 RtaApi.addTopHeaderPlaceHolder();
-                                this.oTrigger.triggerStartRta(this);
-                                return oPostMessageInterface.createPostMessageResult();
+                                await this.oTrigger.triggerStartRta(this);
+                                return oPostMessageInterface.createPostMessageResult(this.oTrigger.sStatus);
                             }.bind(this)
                         }
                     },

package/src/main/js/sap/ushell/appRuntime/ui5/plugins/rtaAgent/i18n/i18n_vi.properties

@@ -1,7 +1,7 @@
 
 APP_TITLE=Plug-in ta\u0301c nh\u00E2n cFLP RTA
 
-ERROR_TITLE=Kh\u00F4ng th\u00EA\u0309 b\u0103\u0301t \u0111\u00E2\u0300u thi\u0301ch \u01B0\u0301ng UI
+ERROR_TITLE=Kh\u00F4ng th\u00EA\u0309 b\u0103\u0301t \u0111\u00E2\u0300u \u0111i\u1EC1u ch\u1EC9nh UI
 
 TECHNICAL_ERROR=L\u00F4\u0303i ky\u0303 thu\u00E2\u0323t. Vui lo\u0300ng li\u00EAn h\u00EA\u0323 \u0111\u00F4\u0323i ngu\u0303 h\u00F4\u0303 tr\u01A1\u0323.
 

package/src/main/js/sap/ushell/appRuntime/ui5/plugins/rtaShell/Component.js

@@ -1,14 +1,12 @@
 // Copyright (c) 2009-2025 SAP SE, All Rights Reserved
 sap.ui.define([
     "sap/ui/core/Component",
-    "sap/ui/core/Element",
     "sap/ui/thirdparty/jquery",
     "sap/ushell/api/RTA",
     "sap/ushell/appRuntime/ui5/plugins/baseRta/AppLifeCycleUtils",
     "sap/ushell/appRuntime/ui5/plugins/baseRta/Renderer"
 ], (
     Component,
-    Element,
     jQuery,
     RtaApi,
     AppLifeCycleUtils,
@@ -39,7 +37,16 @@ sap.ui.define([
             oPostMessageInterface.postMessageToApp(
                 "user.postapi.rtaPlugin",
                 "startUIAdaptation"
-            ).done(resolve).fail(reject);
+            ).done((sRtaStatus) => {
+                // If RTA is stopped, the toolbar should be visible again
+                if (sRtaStatus === "stopped") {
+                    switchToolbarVisibility(true);
+                }
+                resolve(sRtaStatus);
+            }).fail(() => {
+                switchToolbarVisibility(true);
+                reject();
+            });
         });
     }
 
@@ -113,7 +120,8 @@ sap.ui.define([
                         this.bIsInitialized = false;
                         return Promise.reject(vError);
                     })
-                    .then(oDeferred.resolve, oDeferred.reject);
+                    .then(oDeferred.resolve)
+                    .catch(oDeferred.reject);
             }).promise();
         },
 

package/src/main/js/sap/ushell/appRuntime/ui5/renderers/fiori2/AccessKeysAgent.js

@@ -1,7 +1,9 @@
 // Copyright (c) 2009-2025 SAP SE, All Rights Reserved
 sap.ui.define([
-    "sap/ushell/appRuntime/ui5/AppRuntimeService"
-], (AppRuntimeService) => {
+    "sap/ushell/appRuntime/ui5/AppCommunicationMgr"
+], (
+    AppCommunicationMgr
+) => {
     "use strict";
 
     function AccessKeysAgent () {
@@ -43,7 +45,7 @@ sap.ui.define([
                         postBody.key = ",";
                     }
 
-                    AppRuntimeService.postMessageToFLP(
+                    AppCommunicationMgr.postMessageToFLP(
                         "sap.ushell.services.ShellUIService.processHotKey",
                         postBody
                     );

package/src/main/js/sap/ushell/appRuntime/ui5/renderers/fiori2/Renderer.js

@@ -3,14 +3,14 @@
 sap.ui.define([
     "sap/base/util/uid",
     "sap/base/util/ObjectPath",
-    "sap/ushell/appRuntime/ui5/AppRuntimeService",
+    "sap/ushell/appRuntime/ui5/AppCommunicationMgr",
     "sap/base/Log",
     "sap/ui/thirdparty/jquery",
     "sap/ushell/appRuntime/ui5/renderers/fiori2/RendererExtensions"
 ], (
     uid,
     ObjectPath,
-    AppRuntimeService,
+    AppCommunicationMgr,
     Log,
     jQuery,
     RendererExtensions
@@ -155,7 +155,7 @@ sap.ui.define([
         };
 
         this.showHeaderItem = function (aIds/* , bCurrentState, aStates */) {
-            AppRuntimeService.postMessageToFLP("sap.ushell.services.Renderer.showHeaderItem", {
+            AppCommunicationMgr.postMessageToFLP("sap.ushell.services.Renderer.showHeaderItem", {
                 aIds: aIds,
                 bCurrentState: true,
                 aStates: ""
@@ -163,7 +163,7 @@ sap.ui.define([
         };
 
         this.showHeaderEndItem = function (aIds/* , bCurrentState, aStates */) {
-            AppRuntimeService.postMessageToFLP("sap.ushell.services.Renderer.showHeaderEndItem", {
+            AppCommunicationMgr.postMessageToFLP("sap.ushell.services.Renderer.showHeaderEndItem", {
                 aIds: aIds,
                 bCurrentState: true,
                 aStates: ""
@@ -171,7 +171,7 @@ sap.ui.define([
         };
 
         this.hideHeaderItem = function (aIds/* , bCurrentState, aStates */) {
-            AppRuntimeService.postMessageToFLP("sap.ushell.services.Renderer.hideHeaderItem", {
+            AppCommunicationMgr.postMessageToFLP("sap.ushell.services.Renderer.hideHeaderItem", {
                 aIds: aIds,
                 bCurrentState: true,
                 aStates: ""
@@ -179,7 +179,7 @@ sap.ui.define([
         };
 
         this.hideHeaderEndItem = function (aIds/* , bCurrentState, aStates */) {
-            AppRuntimeService.postMessageToFLP("sap.ushell.services.Renderer.hideHeaderEndItem", {
+            AppCommunicationMgr.postMessageToFLP("sap.ushell.services.Renderer.hideHeaderEndItem", {
                 aIds: aIds,
                 bCurrentState: true,
                 aStates: ""
@@ -199,7 +199,7 @@ sap.ui.define([
                 this._addButtonHandler(oControlProperties.id, oControlProperties.press);
             }
 
-            return AppRuntimeService.postMessageToFLP(sAPI, {
+            return AppCommunicationMgr.postMessageToFLP(sAPI, {
                 sId: oControlProperties.id,
                 sTooltip: oControlProperties.tooltip,
                 sIcon: oControlProperties.icon,
@@ -210,14 +210,14 @@ sap.ui.define([
         };
 
         this.setHeaderTitle = function (sTitle) {
-            AppRuntimeService.postMessageToFLP(
+            AppCommunicationMgr.postMessageToFLP(
                 "sap.ushell.services.Renderer.setHeaderTitle",
                 { sTitle: sTitle }
             );
         };
 
         this.setHeaderVisibility = function (bVisible, bCurrentState, aStates) {
-            AppRuntimeService.postMessageToFLP("sap.ushell.services.Renderer.setHeaderVisibility", {
+            AppCommunicationMgr.postMessageToFLP("sap.ushell.services.Renderer.setHeaderVisibility", {
                 bVisible: bVisible,
                 bCurrentState: bCurrentState,
                 aStates: aStates
@@ -234,13 +234,13 @@ sap.ui.define([
                 this._addButtonHandler(params.id, params.press);
                 delete params.press;
             }
-            return AppRuntimeService.postMessageToFLP("sap.ushell.services.Renderer.createShellHeadItem", {
+            return AppCommunicationMgr.postMessageToFLP("sap.ushell.services.Renderer.createShellHeadItem", {
                 params: params
             });
         };
 
         this.showActionButton = function (aIds, bCurrentState, aStates) {
-            AppRuntimeService.postMessageToFLP("sap.ushell.services.Renderer.showActionButton", {
+            AppCommunicationMgr.postMessageToFLP("sap.ushell.services.Renderer.showActionButton", {
                 aIds: aIds,
                 bCurrentState: bCurrentState,
                 aStates: aStates
@@ -248,7 +248,7 @@ sap.ui.define([
         };
 
         this.hideActionButton = function (aIds, bCurrentState, aStates) {
-            AppRuntimeService.postMessageToFLP("sap.ushell.services.Renderer.hideActionButton", {
+            AppCommunicationMgr.postMessageToFLP("sap.ushell.services.Renderer.hideActionButton", {
                 aIds: aIds,
                 bCurrentState: bCurrentState,
                 aStates: aStates
@@ -266,7 +266,7 @@ sap.ui.define([
                 delete oParameters.oControlProperties.press;
             }
 
-            return AppRuntimeService.postMessageToFLP("sap.ushell.services.Renderer.addUserAction", {
+            return AppCommunicationMgr.postMessageToFLP("sap.ushell.services.Renderer.addUserAction", {
                 oParameters: oParameters
             });
         };
@@ -284,14 +284,14 @@ sap.ui.define([
         };
 
         this.updateHeaderItem = function (sId, oControlProperties) {
-            AppRuntimeService.postMessageToFLP("sap.ushell.services.Renderer.updateHeaderItem", {
+            AppCommunicationMgr.postMessageToFLP("sap.ushell.services.Renderer.updateHeaderItem", {
                 sId: sId,
                 oControlProperties: oControlProperties
             });
         };
 
         this.destroyButton = function (aIds) {
-            AppRuntimeService.postMessageToFLP("sap.ushell.services.Renderer.destroyButton", {
+            AppCommunicationMgr.postMessageToFLP("sap.ushell.services.Renderer.destroyButton", {
                 aIds: aIds
             });
         };

package/src/main/js/sap/ushell/appRuntime/ui5/renderers/fiori2/RendererExtensions.js

@@ -3,15 +3,15 @@
 /**
  * @fileOverview This module enables a RendererExtensions like API.
  * This module is NOT a wrapper for the outer shell API and has to be required explicitly.
- * @version 1.139.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/base/util/uid",
-    "sap/ushell/appRuntime/ui5/AppRuntimeService",
+    "sap/ushell/appRuntime/ui5/AppCommunicationMgr",
     "sap/ushell/appRuntime/ui5/AppRuntimeContext"
 ], (
     fnGetUid,
-    AppRuntimeService,
+    AppCommunicationMgr,
     AppRuntimeContext
 ) => {
     "use strict";
@@ -58,7 +58,7 @@ sap.ui.define([
             });
         });
 
-        return AppRuntimeService.postMessageToFLP("sap.ushell.services.Renderer.addOptionsActionSheetButton", aButtonsDesc);
+        return AppCommunicationMgr.postMessageToFLP("sap.ushell.services.Renderer.addOptionsActionSheetButton", aButtonsDesc);
     }
 
     function _removeOptionsActionSheetButton (oButton, sLaunchpadState1, sLaunchpadState2) {
@@ -77,7 +77,7 @@ sap.ui.define([
             });
         });
 
-        return AppRuntimeService.postMessageToFLP("sap.ushell.services.Renderer.removeOptionsActionSheetButton", aButtonIds);
+        return AppCommunicationMgr.postMessageToFLP("sap.ushell.services.Renderer.removeOptionsActionSheetButton", aButtonIds);
     }
 
     function _setLeftPaneContent (oContent, sLaunchpadState1, sLaunchpadState2) {

package/src/main/js/sap/ushell/appRuntime/ui5/services/AppConfiguration.js

@@ -4,13 +4,13 @@
  * @fileOverview This module is a iframe safe version of the AppConfiguration service.
  * The inner frame service has to be required explicitly or accessed via the global on the original path.
  * The require calls to the original file will NOT be replaced.
- * @version 1.139.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/base/util/ObjectPath",
     "sap/m/library",
     "sap/ui/core/IconPool",
-    "sap/ushell/appRuntime/ui5/AppRuntimeService",
+    "sap/ushell/appRuntime/ui5/AppCommunicationMgr",
     "sap/ushell/EventHub",
     "sap/ushell/appRuntime/ui5/renderers/fiori2/RendererExtensions",
     "sap/ushell/resources",
@@ -19,7 +19,7 @@ sap.ui.define([
     ObjectPath,
     mobileLibrary,
     IconPool,
-    AppRuntimeService,
+    AppCommunicationMgr,
     EventHub,
     RendererExtensions,
     resources,
@@ -48,7 +48,6 @@ sap.ui.define([
 
         EventHub.on("appWidthChange").do((bValue) => {
             const oBody = document.body;
-            oBody.classList.toggle("sapUiSizeCompact", bValue);
             oBody.classList.toggle("sapUShellApplicationContainerLimitedWidth", !bValue);
             oBody.classList.toggle("sapUShellApplicationContainer", !bValue);
         });
@@ -75,7 +74,7 @@ sap.ui.define([
             if (vGetFullWidthParamFromManifest === true || vGetFullWidthParamFromManifest === "true") {
                 EventHub.emit("appWidthChange", bValue);
             } else {
-                AppRuntimeService.postMessageToFLP("sap.ushell.services.AppConfiguration.setApplicationFullWidth", {
+                AppCommunicationMgr.postMessageToFLP("sap.ushell.services.AppConfiguration.setApplicationFullWidth", {
                     bValue: bValue
                 });
             }

package/src/main/js/sap/ushell/appRuntime/ui5/services/AppLifeCycle.js

@@ -3,15 +3,15 @@
 /**
  * @fileOverview The app runtime wrapper for {@link sap.ushell.services.AppLifeCycle}.
  *
- * @version 1.139.0
+ * @version 1.141.0
  */
 sap.ui.define([
     "sap/base/Log",
-    "sap/ushell/appRuntime/ui5/AppRuntimeService",
+    "sap/ushell/appRuntime/ui5/AppCommunicationMgr",
     "sap/ushell/services/AppLifeCycle"
 ], (
     Log,
-    AppRuntimeService,
+    AppCommunicationMgr,
     AppLifeCycle
 ) => {
     "use strict";
@@ -41,9 +41,9 @@ sap.ui.define([
          */
         this.reloadCurrentApp = async function () {
             try {
-                await AppRuntimeService.postMessageToFLP("sap.ushell.services.AppLifeCycle.reloadCurrentApp", {});
-            } catch (err) {
-                Log.error("reloadCurrentApp failed: ", err);
+                await AppCommunicationMgr.postMessageToFLP("sap.ushell.services.AppLifeCycle.reloadCurrentApp", {});
+            } catch (oError) {
+                Log.error("reloadCurrentApp failed: ", oError);
             }
         };
     }