新建一个文件夹 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/[email protected] @types/[email protected] @types/[email protected]
当您开发 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的原创文章,尽在:"汪子熙"。