@sapui5/sap.ushell 1.132.1 → 1.134.0

package/src/main/js/sap/ushell/renderer/Shell.controller.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2009-2023 SAP SE, All Rights Reserved
+// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
 
 /**
  * @fileOverview Shell Controller
@@ -7,7 +7,6 @@ sap.ui.define([
     "sap/ushell/renderer/History",
     "sap/base/Log",
     "sap/base/util/extend",
-    "sap/base/util/isPlainObject",
     "sap/m/InstanceManager",
     "sap/ui/core/Component",
     "sap/ui/core/Element",
@@ -22,7 +21,6 @@ sap.ui.define([
     "sap/ui/thirdparty/jquery",
     "sap/ushell/bootstrap/SchedulingAgent",
     "sap/ushell/components/applicationIntegration/AppLifeCycle",
-    "sap/ushell/components/applicationIntegration/relatedServices/RelatedServices",
     "sap/ushell/Config",
     "sap/ushell/EventHub",
     "sap/ushell/library",
@@ -34,8 +32,6 @@ sap.ui.define([
     "sap/ushell/utils/UrlParsing",
     "sap/ushell/utils/WindowUtils",
     "sap/ushell/renderer/ShellLayout",
-    "sap/ushell/renderer/utils",
-    "sap/base/util/ObjectPath",
     "sap/ushell/Container",
     "sap/ushell/state/ShellModel",
     "sap/ushell/state/StateManager",
@@ -47,12 +43,11 @@ sap.ui.define([
     History,
     Log,
     extend,
-    isPlainObject,
     InstanceManager,
     Component,
     Element,
     EventBus,
-    library,
+    coreLibrary,
     Controller,
     HashChanger,
     Ui5History,
@@ -62,7 +57,6 @@ sap.ui.define([
     jQuery,
     SchedulingAgent,
     AppLifeCycleAI,
-    RelatedServices,
     Config,
     EventHub,
     ushellLibrary,
@@ -74,8 +68,6 @@ sap.ui.define([
     UrlParsing,
     WindowUtils,
     ShellLayout,
-    RendererUtils,
-    ObjectPath,
     Container,
     ShellModel,
     StateManager,
@@ -90,7 +82,7 @@ sap.ui.define([
     const ShellArea = ShellLayout.ShellArea;
 
     // shortcut for sap.ui.core.routing.HistoryDirection
-    const Ui5HistoryDirection = library.routing.HistoryDirection;
+    const Ui5HistoryDirection = coreLibrary.routing.HistoryDirection;
 
     // shortcut for sap.ushell.AppType
     const AppType = ushellLibrary.AppType;
@@ -421,20 +413,75 @@ sap.ui.define([
         /**
          */
         _bindTabTitle: function () {
-            const oBinding = ShellModel.getModel().bindProperty("/application/title");
-            oBinding.attachChange(() => {
-                const sTitle = oBinding.getValue();
-
+            const oTitleBinding = ShellModel.getModel().bindProperty("/application/title");
+            const oTitleAdditionalInfoBinding = ShellModel.getModel().bindProperty("/application/titleAdditionalInformation");
+            const fnBindingChangeHandler = () => {
+                const sCalculatedTitle = this._calculateWindowTitle();
                 /*
                  * the tab should have always a title
                  * => only set the title if it is not empty
                  */
-                if (sTitle) {
-                    AppConfiguration.setWindowTitle(sTitle);
+                if (sCalculatedTitle) {
+                    AppConfiguration.setWindowTitle(sCalculatedTitle);
                 }
-            });
+            };
 
-            this._aDanglingBindings.push(oBinding);
+            oTitleBinding.attachChange(fnBindingChangeHandler);
+            oTitleAdditionalInfoBinding.attachChange(fnBindingChangeHandler);
+
+            this._aDanglingBindings.push(oTitleBinding);
+        },
+
+        /**
+         * Calculates the window title based on the title and additional information.
+         *
+         * The title is calculated as follows:
+         * - If the search term is available, the title is the search term.
+         * - If the search term and the search scope are available, the title is the search term with the search scope.
+         * - If the header text and the additional context are available, the title is the header text with the additional context.
+         * - If the header text is available, the title is the header text.
+         * - If the additional context is available, the title is the additional context.
+         * - If none of the above are available, the title is the title.
+         *
+         * Examples:
+         * - titleWindowSearchTermWithScope: <searchTerm> in <searchScope> - Search
+         * - titleWindowSearchTerm: <searchTerm> - Search
+         * - titleWindow: <headerText> - <additionalContext>
+         *
+         * @returns {string} The calculated window title.
+         *
+         * @since 1.133.0
+         * @private
+         */
+        _calculateWindowTitle: function () {
+            let sCalculatedTitle = "";
+            const sTitle = ShellModel.getModel().getProperty("/application/title") || "";
+            const oTitleAdditionalInformation = ShellModel.getModel().getProperty("/application/titleAdditionalInformation");
+
+            if (oTitleAdditionalInformation?.searchTerm) {
+                // <searchTerm> - Search
+                // <searchTerm> in <searchScope> - Search
+                if (oTitleAdditionalInformation.searchScope) {
+                    sCalculatedTitle = ushellResources.i18n.getText(
+                        "titleWindowSearchTermWithScope",
+                        [oTitleAdditionalInformation.searchTerm, oTitleAdditionalInformation.searchScope]
+                    );
+                } else {
+                    sCalculatedTitle = ushellResources.i18n.getText("titleWindowSearchTerm", [oTitleAdditionalInformation.searchTerm]);
+                }
+            } else if (oTitleAdditionalInformation?.headerText && oTitleAdditionalInformation?.additionalContext) {
+                // <headerText>
+                // <headerText> - <additionalContext>
+                // <additionalContext>
+                sCalculatedTitle = ushellResources.i18n.getText(
+                    "titleWindow",
+                    [oTitleAdditionalInformation.headerText, oTitleAdditionalInformation.additionalContext]
+                );
+            } else {
+                sCalculatedTitle = oTitleAdditionalInformation?.headerText || oTitleAdditionalInformation?.additionalContext || sTitle;
+            }
+
+            return sCalculatedTitle;
         },
 
         /**
@@ -466,7 +513,11 @@ sap.ui.define([
                 EventHub.once("CoreResourcesComplementLoaded").do(this._onCoreResourcesComplementLoaded.bind(this)),
                 EventHub.once("loadRendererExtensions").do(this._loadRendererExtensionPlugins.bind(this)),
                 EventHub.once("loadWarmupPlugins").do(this._loadWarmupPlugins.bind(this)),
-                EventHub.once("loadTrackingActivitiesSetting").do(this._loadTrackingActivitiesSetting.bind(this))
+                EventHub.once("loadTrackingActivitiesSetting").do(this._loadTrackingActivitiesSetting.bind(this)),
+
+                // MessagePopover and its dependent controls resources are ~200K. In order to minimize core-min file it is bundled in core-ext file.
+                // Therefore we need to wait until all resources are loaded, before we initialize the MessagePopover.
+                EventHub.once("initMessagePopover").do(this._initializeMessagePopover.bind(this))
             ].forEach((oDoable) => {
                 this.addDoable(oDoable);
             });
@@ -477,20 +528,27 @@ sap.ui.define([
          *
          * This method currently assumes that the application is displayed in the "minimal" state (no home button present).
          */
-        _onBackNavigationChanged: function (oEvent) {
+        _onBackNavigationChanged: async function (oEvent) {
             const fnCallback = oEvent.getParameters().data;
             const sCurrentShellMode = StateManager.getShellMode();
             const sCurrentLaunchpadState = StateManager.getLaunchpadState();
 
+            let BackNavigation;
+            if (Config.last("/core/navigation/enableAppLifeCycleFallback")) {
+                [BackNavigation] = await ushellUtils.requireAsync(["sap/ushell/components/applicationIntegration/relatedServices/RelatedServices"]);
+            } else {
+                [BackNavigation] = await ushellUtils.requireAsync(["sap/ushell/state/BackNavigation"]);
+            }
+
             if (fnCallback) {
-                RelatedServices.setNavigateBack(fnCallback);
+                BackNavigation.setNavigateBack(fnCallback);
 
                 if (sCurrentLaunchpadState === LaunchpadState.App && [Minimal, Standalone, Embedded].includes(sCurrentShellMode)) {
                     Container.getRendererInternal("fiori2").showHeaderItem("backBtn", true);
                 }
             } else {
                 //if no callback is provided we set the default handler: history back
-                RelatedServices.resetNavigateBack();
+                BackNavigation.resetNavigateBack();
             }
         },
 
@@ -672,6 +730,7 @@ sap.ui.define([
             sap.ui.require("sap/ushell/UserActivityLog")?.deactivate();
 
             StateManager.destroy(true);
+            AppLifeCycleAI.reset?.();
         },
 
         /**
@@ -1318,10 +1377,19 @@ sap.ui.define([
         },
 
         _openAppExplace: async function (oResolvedHashFragment, oOldResolvedHashFragment) {
-            const [ApplicationContainer] = await ushellUtils.requireAsync(["sap/ushell/components/container/ApplicationContainer"]);
-
             // Call relevant for Legacy-UI apps that are launched "standalone"; in case of "embedded in new window", the URL doesn't need adaptions.
-            oResolvedHashFragment.url = ApplicationContainer.prototype._checkNwbcUrlAdjustment(undefined, oResolvedHashFragment.applicationType, oResolvedHashFragment.url, true);
+            if (Config.last("/core/navigation/enableAppLifeCycleFallback")) {
+                const [ApplicationContainer] = await ushellUtils.requireAsync(["sap/ushell/components/container/ApplicationContainer"]);
+                oResolvedHashFragment.url = ApplicationContainer.prototype._checkNwbcUrlAdjustment(undefined, oResolvedHashFragment.applicationType, oResolvedHashFragment.url, true);
+            } else {
+                const [UrlPostProcessing] = await ushellUtils.requireAsync(["sap/ushell/ApplicationType/UrlPostProcessing"]);
+                oResolvedHashFragment.url = UrlPostProcessing.processUrl(
+                    oResolvedHashFragment.url,
+                    oResolvedHashFragment.applicationType,
+                    true, // bForFramelessWindow
+                    undefined // oApplicationContainer
+                );
+            }
 
             EventBus.getInstance().publish("launchpad", "appOpening", oResolvedHashFragment);
 
@@ -1488,43 +1556,6 @@ sap.ui.define([
             return ushellUtils.isPlainObject(oResolvedHashFragment.appCapabilities) && oResolvedHashFragment.appCapabilities.hasOwnProperty("navigationMode");
         },
 
-        _usesNavigationRedirect: async function (oComponentHandle) {
-            if (!oComponentHandle) {
-                return false;
-            }
-
-            const oComponent = oComponentHandle.getInstance({});
-            if (!oComponent) {
-                return false;
-            }
-
-            if (typeof oComponent.navigationRedirect !== "function") {
-                return false;
-            }
-
-            // oComponent refers to a trampoline application
-            const oNavRedirectThenable = oComponent.navigationRedirect();
-            if (!oNavRedirectThenable || typeof oNavRedirectThenable.then !== "function") {
-                return false;
-            }
-
-            try {
-                const sNextHash = await ushellUtils.promisify(oNavRedirectThenable);
-                Log.warning(`Performing navigation redirect to hash "${sNextHash}"`);
-
-                oComponent.destroy();
-                this.history.pop();
-
-                const ShellNavigationInternal = await Container.getServiceAsync("ShellNavigationInternal");
-                ShellNavigationInternal.toExternal({ target: { shellHash: sNextHash } }, undefined, false);
-
-                return true;
-            } catch {
-                return false;
-            }
-
-        },
-
         /**
          * Performs navigation based on the given resolved hash fragment.
          *
@@ -1537,107 +1568,104 @@ sap.ui.define([
          * @returns {Promise} Navigation Promise
          */
         _openAppInplace: async function (oParsedShellHash, sShellHash, oResolvedHashFragment, sOldShellHash, sAppPart, oOldResolvedHashFragment) {
-            // todo: [FLPCOREANDUX-10024] check the parameters sent to the AI methods
-
-            const bNavigationFromHome = this._isFLPIntent(sOldShellHash);
-            const bNavigationWithInnerAppRoute = !!sAppPart;
+            if (Config.last("/core/navigation/enableAppLifeCycleFallback")) {
+                return this._openAppInplaceFallback(oParsedShellHash, sShellHash, oResolvedHashFragment, sOldShellHash, sAppPart, oOldResolvedHashFragment);
+            }
 
             // Close dialogs only for inplace navigation
             this._closeAllDialogs();
 
-            await AppLifeCycleAI.handleBeforeCreateApp(sShellHash, oResolvedHashFragment, bNavigationFromHome, bNavigationWithInnerAppRoute);
-
-            // Enhances the resolved hash fragment with the componentHandle for UI5 apps
-            await AppLifeCycleAI.handleCreateApp(sShellHash, oParsedShellHash, oResolvedHashFragment, bNavigationFromHome, bNavigationWithInnerAppRoute);
+            // todo: [FLPCOREANDUX-10024] check the parameters sent to the AI methods
+            const sEffectiveNavigationMode = oResolvedHashFragment.navigationMode;
 
-            // todo: [FLPCOREANDUX-10024] Validate the issue
-            // the activation of user activity logging must be done after the app component is fully loaded
-            // otherwise the module loading sequence causes race conditions on firefox
-            const bContactSupportEnabled = Config.last("/core/extension/SupportTicket");
-            if (bContactSupportEnabled) {
-                ushellUtils.awaitTimeout(0)
-                    .then(() => {
-                        return ushellUtils.requireAsync("sap/ushell/UserActivityLog");
-                    })
-                    .then(([UserActivityLog]) => {
-                        UserActivityLog.activate();
-                    });
+            if (sEffectiveNavigationMode === NavigationMode.replace) {
+                this.oShellNavigationInternal.setIsInitialNavigation(false);
+                // restore hash
+                this.bEnableHashChange = false;
+                this._changeWindowLocation(oResolvedHashFragment.url);
+                return;
             }
 
-            const sEffectiveNavigationMode = oResolvedHashFragment.navigationMode;
-            if (sEffectiveNavigationMode === NavigationMode.embedded) {
-                if (!ushellUtils.isColdStart() && !this._bWasHistoryEntryReplaced) {
-                    this.oShellNavigationInternal.setIsInitialNavigation(false);
-                }
+            if (sEffectiveNavigationMode !== NavigationMode.embedded) {
+                // the navigation mode doesn't match any valid one.
+                // In this case an error message is logged and previous hash is fetched
+                return this.hashChangeFailure(
+                    this.history.getHistoryLength(),
+                    `Navigation mode '${sEffectiveNavigationMode}' was not recognized`,
+                    null,
+                    "sap.ushell.renderer.Shell.controller",
+                    false
+                );
+            }
 
-                // The trampoline application subsequently gets destroyed after it's used to enable the redirection.
-                const bHandledByNavigationRedirect = await this._usesNavigationRedirect(oResolvedHashFragment.componentHandle);
-                if (bHandledByNavigationRedirect) {
-                    // todo: [FLPCOREANDUX-10024] check cleanup stuff (StateManager, ...)
-                    return;
-                }
+            // ========= NavigationMode.embedded =========
 
-                AppLifeCycleAI.resetGlobalShellUIService();
+            /*
+             * The external navigation mode in the resolution result is calculated
+             * statically, and indicates a future state. It currently answers the
+             * question: "is the application going to be opened explace?".
+             *
+             * The target navigation mode, instead, answers the question: "was
+             * the application opened explace?".
+             *
+             * We need to have this logic, because embedded applications do not
+             * check the coldstart condition.
+             */
+            oResolvedHashFragment.targetNavigationMode = ushellUtils.isColdStart() ? "explace" : "inplace";
 
-                const oShellConfig = this._getConfig();
-                const sBasicShellHash = UrlParsing.getBasicHash(sShellHash);
+            if (!ushellUtils.isColdStart() && !this._bWasHistoryEntryReplaced) {
+                this.oShellNavigationInternal.setIsInitialNavigation(false);
+            }
 
-                await AppLifeCycleAI.handleCreateApplicationContainer(
-                    sBasicShellHash, // sAppId
-                    oParsedShellHash,
-                    oResolvedHashFragment,
-                    sOldShellHash,
-                    bNavigationFromHome
-                );
+            AppLifeCycleAI.resetGlobalShellUIService();
 
-                // todo: [FLPCOREANDUX-10024] TBD
-                AppLifeCycleAI.navToCurrentApp(); // todo: [FLPCOREANDUX-10024] triggers appLoaded event
+            const sBasicShellHash = UrlParsing.getBasicHash(sShellHash);
+            const bNavigationFromHome = this._isFLPIntent(sOldShellHash);
+            const bNavigationWithInnerAppRoute = !!sAppPart;
 
-                // @Alon Barnes: Is this call even needed? The beforehand given oMetadata has not included the accessed property in the AppMeta.js
-                // So, maybe this call can even be removed?
-                AppMeta.setAppIcons();
+            const sNavigationRedirectHash = await AppLifeCycleAI.createApplication(
+                sBasicShellHash, // sAppId
+                oParsedShellHash,
+                oResolvedHashFragment,
+                bNavigationFromHome,
+                bNavigationWithInnerAppRoute
+            );
 
-                // todo: [FLPCOREANDUX-10024] should this be done after handleControl?
-                // this only targets the overwritten rootIntent (e.g. workzone advanced)
-                const bIsNavToHome = sShellHash === "#" || (oShellConfig.rootIntent && sBasicShellHash === UrlParsing.getBasicHash(oShellConfig.rootIntent));
-                AppLifeCycleAI.switchViewState(
-                    bIsNavToHome ? LaunchpadState.Home : LaunchpadState.App,
-                    sBasicShellHash, // sAppId
-                    oResolvedHashFragment.applicationType,
-                    oResolvedHashFragment.explicitNavMode
-                );
+            if (typeof sNavigationRedirectHash === "string") {
+                Log.warning(`Performing navigation redirect to hash "${sNavigationRedirectHash}"`);
 
-                // todo: [FLPCOREANDUX-10024] check whether this needs to be awaited
-                await AppLifeCycleAI.handleAfterNavigate(oResolvedHashFragment, oOldResolvedHashFragment);
+                this.history.pop();
 
-                /*
-                * The event is used for FESR records
-                * Normally FESR record is closed on the "AppRendered" event, but for some cases (stateful container, etc.)
-                * the application container is not re-rendered and EmbeddedNavigationDone is additionally fired to close the record.
-                */
-                const oMetadata = AppConfiguration.getMetadata(oResolvedHashFragment);
-                EventHub.emit("CloseFesrRecord", { time: Date.now(), technicalName: oMetadata.technicalName });
-                return;
+                const ShellNavigationInternal = await Container.getServiceAsync("ShellNavigationInternal");
+                return ShellNavigationInternal.toExternal({ target: { shellHash: sNavigationRedirectHash } }, undefined, false);
             }
 
-            // todo: [FLPCOREANDUX-10024] clarify whether there is an actual use case of replace navigation which requires the steps above
-            if (sEffectiveNavigationMode === NavigationMode.replace) {
-                this.oShellNavigationInternal.setIsInitialNavigation(false);
-                // restore hash
-                this.bEnableHashChange = false;
-                this._changeWindowLocation(oResolvedHashFragment.url);
-                return;
-            }
+            AppLifeCycleAI.navToCurrentApp(); // todo: [FLPCOREANDUX-10024] triggers appLoaded event
 
-            // the navigation mode doesn't match any valid one.
-            // In this case an error message is logged and previous hash is fetched
-            await this.hashChangeFailure(
-                this.history.getHistoryLength(),
-                `Navigation mode '${sEffectiveNavigationMode}' was not recognized`,
-                null,
-                "sap.ushell.renderer.Shell.controller",
-                false
+            // todo: [FLPCOREANDUX-10024] move this into a common place and check where it should be
+            AppMeta.setAppIcons();
+
+            const oShellConfig = this._getConfig();
+
+            // todo: [FLPCOREANDUX-10024] should this be done after handleControl?
+            // this only targets the overwritten rootIntent (e.g. workzone advanced)
+            const bIsNavToHome = sShellHash === "#" || (oShellConfig.rootIntent && sBasicShellHash === UrlParsing.getBasicHash(oShellConfig.rootIntent));
+            AppLifeCycleAI.switchViewState(
+                bIsNavToHome ? LaunchpadState.Home : LaunchpadState.App,
+                sBasicShellHash, // sAppId
+                oResolvedHashFragment.applicationType,
+                oResolvedHashFragment.explicitNavMode
             );
+
+            // todo: [FLPCOREANDUX-10024] Move this into the regular flow
+            /*
+             * The event is used for FESR records
+             * Normally FESR record is closed on the "AppRendered" event, but for some cases (stateful container, etc.)
+             * the application container is not re-rendered and EmbeddedNavigationDone is additionally fired to close the record.
+             */
+            const oMetadata = AppConfiguration.getMetadata(oResolvedHashFragment);
+            EventHub.emit("CloseFesrRecord", { time: Date.now(), technicalName: oMetadata.technicalName });
+            return;
         },
 
         /**
@@ -1893,10 +1921,8 @@ sap.ui.define([
             if (!navigationBar) {
                 return;
             }
-            bVisible = bVisible ||
-                (Config.last("/core/menu/enabled") &&
-                Config.last("/core/menu/position") === "Top" &&
-                Config.last("/core/menu/visibleInAllStates")); // visibleInAllStates:true has priority
+            bVisible = bVisible || (Config.last("/core/menu/enabled") &&
+                                    Config.last("/core/menu/visibleInAllStates")); // visibleInAllStates:true has priority
 
             navigationBar.classList.toggle("sapUshellShellHidden", !bVisible);
         },
@@ -1906,10 +1932,8 @@ sap.ui.define([
             if (!sideNavigation) {
                 return;
             }
-            bVisible = bVisible ||
-                (Config.last("/core/menu/enabled") &&
-                Config.last("/core/menu/position") === "Side" &&
-                Config.last("/core/menu/visibleInAllStates")); // visibleInAllStates:true has priority
+            bVisible = bVisible || (Config.last("/core/sideNavigation/enabled") &&
+            Config.last("/core/sideNavigation/mode") === "Docked");
 
             sideNavigation.classList.toggle("sapUshellShellHidden", !bVisible);
         },
@@ -2215,9 +2239,16 @@ sap.ui.define([
             StateManager.updateAllBaseStates("footer.content", Operation.Set, "");
         },
 
+        /**
+         * Adds an entry to the user settings dialog.
+         *
+         * @param {object} entryObject The configuration object of the entry.
+         * @param {boolean} bGrouped Whether the entry should be grouped.
+         * @returns {string} The ID of the entry.
+         */
         addUserPreferencesEntry: function (entryObject, bGrouped) {
             this._validateUserPrefEntryConfiguration(entryObject, bGrouped);
-            this._updateUserPrefModel(entryObject, bGrouped);
+            return this._updateUserPrefModel(entryObject, bGrouped);
         },
 
         _validateUserPrefEntryConfiguration: function (entryObject, bGrouped) {
@@ -2306,12 +2337,27 @@ sap.ui.define([
             return this.oSessionHandler;
         },
 
-        _navBack: function () {
+        _navBack: async function () {
             // set meAria as closed when navigating back
             this.setUserActionsMenuSelected(false);
-            RelatedServices.navigateBack();
+
+            if (Config.last("/core/navigation/enableAppLifeCycleFallback")) {
+                const [RelatedServices] = await ushellUtils.requireAsync(["sap/ushell/components/applicationIntegration/relatedServices/RelatedServices"]);
+                RelatedServices.navigateBack();
+            } else {
+                const [BackNavigation] = await ushellUtils.requireAsync(["sap/ushell/state/BackNavigation"]);
+                BackNavigation.navigateBack();
+            }
         },
 
+        /**
+         * Updates the user preferences model with the new entry.
+         *
+         * @param {object} entryObject The configuration object of the entry.
+         * @param {boolean} bGrouped Whether the entry should be grouped.
+         * @returns {string} The ID of the entry.
+         * @private
+         */
         _updateUserPrefModel: function (entryObject, bGrouped) {
             const oNewEntry = this._getModelEntryFromEntryObject(entryObject);
             let aEntries = Config.last("/core/userPreferences/entries") || [];
@@ -2327,6 +2373,7 @@ sap.ui.define([
             // Re-order the entries array to have the Home Page entry right after the Appearance entry (if both exist)
             aEntries = this._reorderUserPrefEntries(aEntries);
             Config.emit("/core/userPreferences/entries", aEntries);
+            return oNewEntry.id;
         },
 
         _getModelEntryFromEntryObject: function (entryObject) {
@@ -2415,6 +2462,196 @@ sap.ui.define([
             ];
 
             return aFLPIntents.some((sIntent) => sBasicHash === sIntent);
+        },
+
+        // ===================================================================
+        // ================== AppLifeCycleFallback logic =====================
+        // ===================================================================
+
+        _usesNavigationRedirect: async function (oComponentHandle) {
+            if (!oComponentHandle) {
+                return false;
+            }
+
+            const oComponent = oComponentHandle.getInstance({});
+            if (!oComponent) {
+                return false;
+            }
+
+            if (typeof oComponent.navigationRedirect !== "function") {
+                return false;
+            }
+
+            // oComponent refers to a trampoline application
+            const oNavRedirectThenable = oComponent.navigationRedirect();
+            if (!oNavRedirectThenable || typeof oNavRedirectThenable.then !== "function") {
+                return false;
+            }
+
+            try {
+                const sNextHash = await ushellUtils.promisify(oNavRedirectThenable);
+                Log.warning(`Performing navigation redirect to hash "${sNextHash}"`);
+
+                oComponent.destroy();
+                this.history.pop();
+
+                const ShellNavigationInternal = await Container.getServiceAsync("ShellNavigationInternal");
+                ShellNavigationInternal.toExternal({ target: { shellHash: sNextHash } }, undefined, false);
+
+                return true;
+            } catch {
+                return false;
+            }
+
+        },
+
+        /**
+         * Method to adapt the CrossApplicationNavigation service method
+         * isUrlSupported to the request as issued by the SAP UI5 MessagePopover control
+         *
+         * @param {object} oToBeValidated an object defined by the MessagePopover control containing the URL
+         *  which should be validated and an ES6 promise object which has to be used to receive the validation results.
+         *  This promise always needs to be resolved expecting { allowed: true|false } as a an argument to the resolve function.
+         *
+         * @since 1.30.0
+         * @private
+         */
+        _adaptIsUrlSupportedResultForMessagePopover: async function (oToBeValidated) {
+            const CrossApplicationNavigation = await Container.getServiceAsync("Navigation");
+            try {
+                await CrossApplicationNavigation.isUrlSupported(oToBeValidated.url);
+                oToBeValidated.promise.resolve({ allowed: true, id: oToBeValidated.id });
+            } catch {
+                oToBeValidated.promise.resolve({ allowed: false, id: oToBeValidated.id });
+            }
+        },
+
+        _initializeMessagePopover: async function (eventData) {
+            const [MessagePopover] = await ushellUtils.requireAsync(["sap/m/MessagePopover"]);
+            if (MessagePopover?.setDefaultHandlers) {
+
+                //Hook CrossApplicationNavigation URL validation logic into the sap.m.MessagePopover control
+                MessagePopover.setDefaultHandlers({
+                    asyncURLHandler: this._adaptIsUrlSupportedResultForMessagePopover
+                });
+            }
+            EventHub.emit("StepDone", eventData.stepName);
+        },
+
+        /**
+         * Performs navigation based on the given resolved hash fragment.
+         *
+         * @param {object} oParsedShellHash the parsed shell hash obtained via {@link sap.ushell.services.URLParsing} service
+         * @param {string} sShellHash the hash fragment to navigate to. It must start with "#" (i.e., fixed).
+         * @param {object} oResolvedHashFragment the hash fragment resolved via {@link sap.ushell.services.NavTargetResolutionInternal#resolveHashFragment}
+         * @param {string} sOldShellHash the old hash fragment. It must start with "#" (i.e., fixed).
+         * @param {string} sAppPart the application part
+         *
+         * @returns {Promise} Navigation Promise
+         */
+        _openAppInplaceFallback: async function (oParsedShellHash, sShellHash, oResolvedHashFragment, sOldShellHash, sAppPart, oOldResolvedHashFragment) {
+            // todo: [FLPCOREANDUX-10024] check the parameters sent to the AI methods
+
+            const bNavigationFromHome = this._isFLPIntent(sOldShellHash);
+            const bNavigationWithInnerAppRoute = !!sAppPart;
+
+            // Close dialogs only for inplace navigation
+            this._closeAllDialogs();
+
+            await AppLifeCycleAI.handleBeforeCreateApp(sShellHash, oResolvedHashFragment, bNavigationFromHome, bNavigationWithInnerAppRoute);
+
+            // Enhances the resolved hash fragment with the componentHandle for UI5 apps
+            await AppLifeCycleAI.handleCreateApp(sShellHash, oParsedShellHash, oResolvedHashFragment, bNavigationFromHome, bNavigationWithInnerAppRoute);
+
+            // todo: [FLPCOREANDUX-10024] Validate the issue
+            // the activation of user activity logging must be done after the app component is fully loaded
+            // otherwise the module loading sequence causes race conditions on firefox
+            const bContactSupportEnabled = Config.last("/core/extension/SupportTicket");
+            if (bContactSupportEnabled) {
+                ushellUtils.awaitTimeout(0)
+                    .then(() => {
+                        return ushellUtils.requireAsync("sap/ushell/UserActivityLog");
+                    })
+                    .then(([UserActivityLog]) => {
+                        UserActivityLog.activate();
+                    });
+            }
+
+            const sEffectiveNavigationMode = oResolvedHashFragment.navigationMode;
+            if (sEffectiveNavigationMode === NavigationMode.embedded) {
+                if (!ushellUtils.isColdStart() && !this._bWasHistoryEntryReplaced) {
+                    this.oShellNavigationInternal.setIsInitialNavigation(false);
+                }
+
+                // The trampoline application subsequently gets destroyed after it's used to enable the redirection.
+                const bHandledByNavigationRedirect = await this._usesNavigationRedirect(oResolvedHashFragment.componentHandle);
+                if (bHandledByNavigationRedirect) {
+                    // todo: [FLPCOREANDUX-10024] check cleanup stuff (StateManager, ...)
+                    return;
+                }
+
+                AppLifeCycleAI.resetGlobalShellUIService();
+
+                const oShellConfig = this._getConfig();
+                const sBasicShellHash = UrlParsing.getBasicHash(sShellHash);
+
+                await AppLifeCycleAI.handleCreateApplicationContainer(
+                    sBasicShellHash, // sAppId
+                    oParsedShellHash,
+                    oResolvedHashFragment,
+                    sOldShellHash,
+                    bNavigationFromHome
+                );
+
+                // todo: [FLPCOREANDUX-10024] TBD
+                AppLifeCycleAI.navToCurrentApp(); // todo: [FLPCOREANDUX-10024] triggers appLoaded event
+
+                // @Alon Barnes: Is this call even needed? The beforehand given oMetadata has not included the accessed property in the AppMeta.js
+                // So, maybe this call can even be removed?
+                AppMeta.setAppIcons();
+
+                // todo: [FLPCOREANDUX-10024] should this be done after handleControl?
+                // this only targets the overwritten rootIntent (e.g. workzone advanced)
+                const bIsNavToHome = sShellHash === "#" || (oShellConfig.rootIntent && sBasicShellHash === UrlParsing.getBasicHash(oShellConfig.rootIntent));
+                AppLifeCycleAI.switchViewState(
+                    bIsNavToHome ? LaunchpadState.Home : LaunchpadState.App,
+                    sBasicShellHash, // sAppId
+                    oResolvedHashFragment.applicationType,
+                    oResolvedHashFragment.explicitNavMode
+                );
+
+                // todo: [FLPCOREANDUX-10024] check whether this needs to be awaited
+                await AppLifeCycleAI.handleAfterNavigate(oResolvedHashFragment, oOldResolvedHashFragment);
+
+                /*
+                * The event is used for FESR records
+                * Normally FESR record is closed on the "AppRendered" event, but for some cases (stateful container, etc.)
+                * the application container is not re-rendered and EmbeddedNavigationDone is additionally fired to close the record.
+                */
+                const oMetadata = AppConfiguration.getMetadata(oResolvedHashFragment);
+                EventHub.emit("CloseFesrRecord", { time: Date.now(), technicalName: oMetadata.technicalName });
+                return;
+            }
+
+            // todo: [FLPCOREANDUX-10024] clarify whether there is an actual use case of replace navigation which requires the steps above
+            if (sEffectiveNavigationMode === NavigationMode.replace) {
+                this.oShellNavigationInternal.setIsInitialNavigation(false);
+                // restore hash
+                this.bEnableHashChange = false;
+                this._changeWindowLocation(oResolvedHashFragment.url);
+                return;
+            }
+
+            // the navigation mode doesn't match any valid one.
+            // In this case an error message is logged and previous hash is fetched
+            await this.hashChangeFailure(
+                this.history.getHistoryLength(),
+                `Navigation mode '${sEffectiveNavigationMode}' was not recognized`,
+                null,
+                "sap.ushell.renderer.Shell.controller",
+                false
+            );
         }
+
     });
 });