Fix Partially Deprecated Apis

作者 UI52b8c4a944e39无许可证收录于 2026年10月8日更新于 2026年10月8日

Fix partially deprecated API usage that UI5 linter reports but cannot auto-fix. Use this skill when linter outputs: - `no-deprecated-api` for Parameters.get, JSONModel.loadData, Mobile.init, ODataModel.v2.createEntry, View.create, Fragment.load, Router constructor - `unsupported-api-usage` for string formatter in JS bindings Trigger on: Parameters.get without object param, JSONModel.loadData with bAsync=false, Mobile.init with homeIcon, createEntry with batchGroupId, View.create/Fragment.load with non-XML type, Router without async:true, formatter as string in JS. Provides specific fix patterns for each partially deprecated API variant.

仅含说明Software Development
AI 生成的概览

修复 UI5 linter 能检测但无法自动修复的部分弃用 SAP UI5 API 用法。

功能
该技能针对特定的弃用 UI5 API 变体提供修改前后的代码模式，涵盖 Parameters.get、JSONModel.loadData、Mobile.init、ODataModel.v2.createEntry、View.create、Fragment.load、Router 构造函数以及 JavaScript 绑定中的字符串格式化器。它把 linter 规则 ID 和消息模式对应到相应修复方式，并说明何时需要将视图或片段文件转换为 XML。它输出的是修正后的代码片段，本身不运行任何工具。
适用场景
当 UI5 linter 输出针对上述 API 之一报告 no-deprecated-api 或 unsupported-api-usage，且问题无法自动解决时使用。适合正在现代化改造 UI5 应用代码、需要针对所用弃用变体获取具体替换模式的开发者。
运行要求
不附带脚本或软件包，仅为说明性指令。应用这些修复需要 SAP UI5 代码库，并可使用 UI5 linter 进行验证。

Fix Partially Deprecated APIs

This skill fixes partially deprecated API usage that the UI5 linter detects but cannot auto-fix because they require understanding the specific deprecated variant being used.

Quick Reference

APIDeprecated UsageFix
Parameters.getNo args, string, or arrayObject with name and callback
JSONModel.loadDatabAsync=false (3rd param)Omit or set true
Mobile.inithomeIcon/homeIconPrecomposedRemove, use web manifest
ODataModel.v2.createEntrybatchGroupIdUse groupId
ODataModel.v2.createEntryproperties as arrayUse object with values
View.createtype: "JS/JSON/HTML/Template"Use "XML" or omit
Fragment.loadtype: "HTML"Use "XML" or omit
Router constructorMissing/false asyncSet async: true
Binding formatterString value in JSFunction reference

Linter Rules Handled

Rule IDMessage PatternThis Skill's Action
no-deprecated-apiUsage of deprecated variant of 'sap/ui/core/theming/Parameters.get'Use object parameter
no-deprecated-apiUsage of deprecated value for parameter '...' of 'sap/ui/model/json/JSONModel#loadData'Remove/change parameter
no-deprecated-apiUsage of deprecated value for parameter '...' of 'sap/ui/util/Mobile#init'Remove parameter
no-deprecated-apiUsage of deprecated parameter 'batchGroupId' in 'sap/ui/model/odata/v2/ODataModel#createEntry'Use groupId
no-deprecated-apiUsage of deprecated value '...' for parameter 'type' in 'sap/ui/core/mvc/View.create'Use XML type
no-deprecated-apiUsage of deprecated value '...' for parameter 'type' in 'sap/ui/core/Fragment.load'Use XML type
no-deprecated-apiUsage of deprecated value for parameter 'oConfig.async' of constructor 'sap/ui/core/Router'Set async: true
unsupported-api-usageDo not use strings for 'formatter' values in JavaScriptUse function reference

When to Use

Apply this skill when you see linter output like:

MyController.js:15:5 error Usage of deprecated variant of 'sap/ui/core/theming/Parameters.get'  no-deprecated-apiMyController.js:20:5 error Usage of deprecated value for parameter 'bAsync' of 'sap/ui/model/json/JSONModel#loadData'  no-deprecated-apiMyController.js:25:5 error Usage of deprecated parameter 'batchGroupId' in 'sap/ui/model/odata/v2/ODataModel#createEntry'  no-deprecated-apiMyController.js:30:5 error Do not use strings for 'formatter' values in JavaScript  unsupported-api-usage

Fix Strategies

1. Parameters.get - Old Variant

Problem: Calling Parameters.get() without an object parameter.

javascript
// Before - all these variants are deprecatedsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/theming/Parameters"], function(Controller, Parameters) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            // Deprecated: no arguments            var allParams = Parameters.get();
            // Deprecated: string argument            var singleParam = Parameters.get("sapUiBaseColor");
            // Deprecated: array argument            var multiParams = Parameters.get(["sapUiBaseColor", "sapUiBaseBG"]);        }    });});

Fix Strategy: Use object parameter with callback.

javascript
// After - use object parametersap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/theming/Parameters"], function(Controller, Parameters) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            // Correct: object parameter with name and callback            Parameters.get({                name: "sapUiBaseColor",                callback: function(sValue) {                    // Use the parameter value                    console.log("Color:", sValue);                }            });
            // Correct: multiple parameters            Parameters.get({                name: ["sapUiBaseColor", "sapUiBaseBG"],                callback: function(mParams) {                    // mParams is an object with parameter values                    console.log("Base color:", mParams.sapUiBaseColor);                    console.log("Base BG:", mParams.sapUiBaseBG);                }            });        }    });});

2. JSONModel.loadData - Deprecated Parameters

Problem: Using bAsync=false or bCache=false in loadData().

javascript
// Before - bAsync=false is deprecated (3rd parameter)sap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/model/json/JSONModel"], function(Controller, JSONModel) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            var oModel = new JSONModel();
            // Deprecated: bAsync=false (synchronous loading)            oModel.loadData("/api/data", null, false);
            // Deprecated: bCache=false (6th parameter)            oModel.loadData("/api/data", null, true, "GET", false, false);        }    });});

Fix Strategy: Use async loading (default) and remove cache parameter.

javascript
// After - use async loadingsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/model/json/JSONModel"], function(Controller, JSONModel) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            var oModel = new JSONModel();
            // Correct: async loading (default or true)            oModel.loadData("/api/data").then(function() {                // Handle loaded data            });
            // Or with parameters, omitting deprecated ones            oModel.loadData("/api/data", null, true, "GET");        }    });});

3. Mobile.init - Deprecated Parameters

Problem: Using homeIcon or homeIconPrecomposed in Mobile.init().

javascript
// Before - homeIcon and homeIconPrecomposed are deprecatedsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/util/Mobile"], function(Controller, Mobile) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            Mobile.init({                homeIcon: "icons/icon.png",              // Deprecated                homeIconPrecomposed: true,              // Deprecated                statusBar: "default"            });        }    });});

Fix Strategy: Remove the deprecated parameters.

javascript
// After - remove homeIcon and homeIconPrecomposedsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/util/Mobile"], function(Controller, Mobile) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            Mobile.init({                statusBar: "default"            });
            // Note: Use web app manifest (manifest.json) for home screen icons instead        }    });});

Alternative: Define home screen icons in your web app manifest:

json
{    "icons": [        {            "src": "icons/icon-192.png",            "sizes": "192x192",            "type": "image/png"        }    ]}

4. ODataModel.v2.createEntry - Deprecated Parameters

Problem: Using batchGroupId or properties as array in createEntry().

javascript
// Before - batchGroupId and properties array are deprecatedsap.ui.define([    "sap/ui/core/mvc/Controller"], function(Controller) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onCreate: function() {            var oModel = this.getView().getModel();
            var oContext = oModel.createEntry("/Products", {                batchGroupId: "myBatch",                      // Deprecated: use groupId                properties: ["Name", "Price", "Category"]    // Deprecated: use object            });        }    });});

Fix Strategy: Use groupId and pass properties as object with initial values.

javascript
// After - use groupId and properties objectsap.ui.define([    "sap/ui/core/mvc/Controller"], function(Controller) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onCreate: function() {            var oModel = this.getView().getModel();
            var oContext = oModel.createEntry("/Products", {                groupId: "myBatch",                          // Correct: groupId                properties: {                                // Correct: object with initial values                    Name: "",                    Price: 0,                    Category: ""                }            });        }    });});

5. View.create - Deprecated View Types

Problem: Creating views with deprecated types (JS, JSON, HTML, Template).

javascript
// Before - non-XML view types are deprecatedsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/mvc/View"], function(Controller, View) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            View.create({                viewName: "my.app.view.Detail",                type: "JS"          // Deprecated: JS, JSON, HTML, Template            }).then(function(oView) {                // Use view            });        }    });});

Fix Strategy: Convert to XML view type.

javascript
// After - use XML type (or omit type, XML is default)sap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/mvc/View"], function(Controller, View) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            View.create({                viewName: "my.app.view.Detail",                type: "XML"         // Or omit - XML is default            }).then(function(oView) {                // Use view            });        }    });});

Note: This requires converting your JS/JSON/HTML view file to an XML view file.

6. Fragment.load - Deprecated Fragment Type

Problem: Loading fragments with HTML type.

javascript
// Before - HTML fragment type is deprecatedsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/Fragment"], function(Controller, Fragment) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onOpenDialog: function() {            Fragment.load({                name: "my.app.fragment.Dialog",                type: "HTML"        // Deprecated            }).then(function(oFragment) {                // Use fragment            });        }    });});

Fix Strategy: Convert to XML fragment.

javascript
// After - use XML type (or omit, XML is default)sap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/Fragment"], function(Controller, Fragment) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onOpenDialog: function() {            Fragment.load({                name: "my.app.fragment.Dialog",                type: "XML"         // Or omit - XML is default            }).then(function(oFragment) {                // Use fragment            });        }    });});

7. Router Constructor - Missing async Flag

Problem: Creating Router without async: true.

javascript
// Before - missing or false async flag is deprecatedsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/routing/Router"], function(Controller, Router) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            // Deprecated: no config            var oRouter1 = new Router([]);
            // Deprecated: async not set or false            var oRouter2 = new Router([], {                async: false            });        }    });});

Fix Strategy: Set async: true in the config.

javascript
// After - set async: truesap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/routing/Router"], function(Controller, Router) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            var oRouter = new Router([], {                async: true         // Required            });        }    });});

Note: Most apps use the Component's built-in router via manifest.json, which handles this automatically when IAsyncContentCreation is implemented in Component.js (see fix-component-async skill).

8. String Formatter in JS Bindings

Problem: Using string value for formatter in JavaScript.

javascript
// Before - string formatter doesn't work in JSsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/m/Input",    "../model/formatter"], function(Controller, Input, formatter) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        formatter: formatter,
        onInit: function() {            var oInput = new Input({                value: {                    path: "/status",                    formatter: "formatter.statusText"   // Error: string won't work                }            });        }    });});

Fix Strategy: Use function reference.

javascript
// After - use function referencesap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/m/Input",    "../model/formatter"], function(Controller, Input, formatter) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        formatter: formatter,
        onInit: function() {            var oInput = new Input({                value: {                    path: "/status",                    formatter: formatter.statusText    // Correct: function reference                }            });        }    });});

Note: String formatters work in XML views (resolved at runtime) but not in JS where you have direct access to the function.

Notes

  • These are "partially" deprecated because only specific usage patterns are deprecated, not the entire API
  • Always check npx @ui5/linter --details for links to modernization documentation
  • View/Fragment type changes require converting the actual view/fragment files to XML
  • The Router async: true is automatically handled when using IAsyncContentCreation in Component.js (see fix-component-async skill for correct placement)

来源与署名

来源：UI5/plugins-coding-agents位于plugins/ui5-modernization/skills/fix-partially-deprecated-apis提交2b8c4a9

许可证： 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多来自 UI5/plugins-coding-agents 的技能

Modernize Ui5 App

UI5

编排五阶段 UI5 应用现代化工作流，包含验证关卡和按阶段提交。

Software Development2026年10月8日

Modernize Flp Sandbox

UI5

将 SAP UI5 应用从旧版 FLP 沙箱迁移到新沙箱，重写配置、钩子与测试。

Software Development2026年10月8日

Fix Xml Native Html

UI5

指导将 UI5 XML 视图中已弃用的原生 HTML 和 SVG 替换为等效的 UI5 控件与图标。

Software Development2026年10月8日

Fix Table Row Mode

UI5

将已弃用的 sap.ui.table.Table 行属性转换为 rowMode 聚合，修复 UI5 代码。

Software Development2026年10月8日

Fix Pseudo Modules

UI5

指导修复 UI5 检查器报告的伪模块与隐式全局错误，通过修正模块导入方式解决。

Software Development2026年10月8日

Fix Manifest Json

UI5

修复 UI5 linter 报告但无法自动修复的 SAP UI5 manifest.json 问题。

Software Development2026年10月8日

更多Software Development技能

Playground

anthropics

精选

构建自包含的交互式 HTML 演练场，包含控件、实时预览和可复制的提示词输出。

Software Development37K今天更新

M5 Onboard

anthropics

精选

通过 USB 检测 M5Stack ESP32 开发板，刷写 UIFlow 2.0 固件并安装 MicroPython 应用包。

Software Development37K今天更新

Cardputer Buddy

anthropics

精选

指导迭代 Cardputer-Adv 的 MicroPython 应用包：添加应用、通过 USB 串口推送文件、查看日志并运行 REPL 命令。

Software Development37K今天更新

Testing Strategy

anthropics

精选

设计测试策略与测试计划，涵盖测试类型、覆盖率目标与示例测试用例。

Software Development27K今天更新

Tech Debt

anthropics

精选

识别、分类并排序技术债务，产出评分后的待办清单与分阶段整改计划。

Software Development27K今天更新

System Design

anthropics

精选

通过需求、高层设计、深入设计、扩展与权衡分析来指导系统与架构设计。

Software Development27K今天更新