使用 TypeScript 编写 SAP UI5 应用的准备工作

新建一个文件夹 ui5-ts, 执行命令行 npm init -y 初始化：

新建一个 src 文件夹，里面存放一个 Component.ts 文件，源代码如下：

import UIComponent from "sap/ui/core/UIComponent";

/**
 * @namespace ui5.typescript.helloworld
 */
export default class Component extends UIComponent {

    public multiply(x : number, y : number) : number {
        return x * y;
    }
}

它是 TypeScript 代码，这意味着虽然大部分是纯 JavaScript，但它还包含变量、参数和函数返回值的类型声明，如“multiply”方法的定义所示。 我们马上将能够看到 TypeScript 编译将如何去除这些内容。

它是带有模块和类的“现代 JavaScript”代码，将在构建过程的进一步步骤中转换为经典的 UI5 代码。 这与 TypeScript 并没有真正的关系，但它是我们推荐的在任何时候都需要构建步骤时编写现代 UI5 应用程序的一种方式。

如下图所示：

安装对应的依赖：

npm install --save-dev typescript @types/openui5@1.97.0 @types/jquery@3.5.1 @types/qunit@2.5.4

当您开发 SAPUI5 应用程序时（即使用 OpenUI5 中不可用的控件库），请使用 @sapui5/ts-types-esm 类型而不是 @types/openui5 类型。

另一方面，@openui5/ts-types-esm 中的可用类型，它们与@types/openui5 有什么不同？ 唯一的区别在于版本控制：虽然@openui5 命名空间中的类型与相应的 OpenUI5 版本完全同步，但 @types 命名空间中的类型遵循 DefinitiveTyped 版本控制，并且每个 OpenUI5 的次要版本只发布一次。 实际上，它不应该对我们使用的内容产生影响，但请注意，在 @types 命名空间中通常只有 ..0 补丁版本可用。

SAPUI5 类型在 @types 命名空间中不可用。

我们安装具体版本，以确保类型定义与使用的 UI5 代码和随附的 jQuery 版本相匹配。

其他库的类型需要以相同的方式添加。

npm install 成功完成：

执行命令行：

npx tsc src/Component.ts

遇到错误消息：

node_modules/@types/openui5/sap.ui.core.d.ts:1890:13 - error TS2583: Cannot find name 'Iterator'. Do you need to change your target library? Try changing the 'lib' compiler option to 'es2015' or later.

尝试执行这个命令：

npm install -D @types/node

之后 tsc 命令可以成功执行。

但这并不是推荐的方式，况且采取这种方式生成的 Component.js, 内容并不正确。

正确的做法是：新建一个 tsconfig.json 文件，维护如下的内容：

{
    "compilerOptions": {
        "target": "es2015",
        "module": "es2015",
        "skipLibCheck": true,
        "preserveConstEnums": true,
        "allowJs": true,
        "strict": true,
        "strictNullChecks": false,
        "strictPropertyInitialization": false,
        "rootDir": "./src",
        "outDir": "./dist",
        "baseUrl": "./",
        "paths": {
            "ui5/typescript/helloworld/*": [
                "./src/*"
            ]
        }
    },
    "include": [
        "./src/**/*"
    ]
}

之后再次执行npx tsc 命令，即可顺利生成 Component.js.

更多Jerry的原创文章，尽在："汪子熙"。