编译失败原因
复现方法
示例:
// SDK
declare class Base {
// since 9
getPropA(): number;
// since 12 new method
getPropB(): number;
}
// apply
let b: Base = {
getPropA() {
return 0;
}
}
// Error message after upgrading to API 12.
// Property 'getPropB' is missing in type '{ getPropA(): number; }' but required in type 'Base'. 报错原因
ArkTS语言的类型检查要求类型和对象要匹配,Base有两个方法,但是赋值的对象只有一个,如果不在编译时检查报错,可能会在运行时出现异常。
对象字面量初始化class实例
不推荐使用
通过对象字面量初始化class实例是业界不推荐的用法。
会造成以下问题:
// SDK API
declare class Person1 {
name: string;
age: number;
greet(): void;
}
// apply
const p: Person1 = {
name: 'Bob',
age: 40,
greet() {} // Tampering with system greet behavior.
} // SDK API
declare class Person2 {
name: string;
age: number;
greet(): void;
}
// apply
const p1: Person2 = {
name: 'Bob',
age: 40,
greet() {}
}
console.log(`${p1 instanceof Person2}`); // return false 业界使用罕见
使用class的场景主要为:
// SDK API
declare class Person3 {
name: string;
age: number;
greet(): void;
}
const p2: Person3 = new Person3(); // SDK API
declare class Person4 {
name: string;
age: number;
greet(): void;
}
class Student extends Person4 {
study() {}
} // SDK API
declare class Person5 {
name: string;
age: number;
static greet(): void;
}
Person5.greet(); declare class Person6 {
name: string;
age: number;
greet(): void;
}
const p3: Person2 = {
name: 'Bob',
age: 40,
greet() {}
} 扫描开源社区TypeScript官方代码,其.ts代码有80w行,其中通过对象字面量初始化class实例的代码为:生产代码,9行,占0.001%;测试代码,63行,占0.008%。
系统演进
操作系统的开放能力会持续演进,在class中新增方法是常见的演进行为,在HarmonyOS与业界其他操作系统中非常常见。
以程序框架UIAbilityContext为例,在API9、10、12版本中均有新增API:
declare class UIAbilityContext {
/**
* @since 9
*/
startAbility(): void;
/**
* @since 9
*/
startAbilityForResult(): void;
/**
* @since 10
*/
setMissionContinueState(): void;
/**
* @since 12
*/
backToCallerAbilityWithResult(): Promise<void>;
} 修改方案
为保证操作系统开放能力的持续演进,开发者使用对象字面量的方式初始化class实例,若编译失败,需要修改。
应用不使用对象字面量的方式初始化class实例,修改为通过new的方式初始化。
// SDK
declare class Base2 {
// since 9
getPropA(): number;
// since 12 new method
getPropB(): number;
}
// Initialize an instance of a class using the new method.
let b2: Base2 = new Base2();
// Upgrading to API 12 SDK will not result in errors.