当前位置：首页 > article >正文

HarmonyOS NEXT 开发之ArkTS基础入门

article 2025/1/21 2:54:56

摘要

ArkTS 是 HarmonyOS NEXT 的开发语言，它基于 TypeScript 并进行了扩展和优化。以下是一些基础语法知识点、示例用法及注意事项。

一、ArkTS 简介

ArkTS 是一种基于 TypeScript 的编程语言，主要用于 HarmonyOS 应用的 UI 界面和业务逻辑开发。它在 TypeScript 的基础上，进行了一些针对 HarmonyOS 系统的优化和定制。

二、创建 ArkTS 项目

1.打开 DevEco Studio：点击 File -> New -> Project，选择适合的模板作为项目类型。
2.输入项目名称和包名：然后点击 Next。
3.完成项目创建：点击 Finish，DevEco Studio 将自动创建一个 ArkTS 项目。

三、编写 ArkTS 代码

1.编写 UI 界面：ArkTS 项目的 UI 界面使用 XML 文件定义，可以在 resources/base/layout 目录下找到应用的布局文件。
2.编写业务逻辑：ArkTS 项目的业务逻辑代码使用 TypeScript 编写，可以在 src/main/js/default 目录下找到应用的 TypeScript 代码。
3.添加资源文件：ArkTS 项目的图片、字符串等资源文件存放在 resources/base 目录下。
4.配置文件：ArkTS 项目的配置信息存放在 config.json 文件中。

四、ArkTS 关键语法和使用示例

1. 类型注解

类型注解是 TypeScript 的核心特性之一，它允许在变量、函数参数和函数返回值上添加类型信息。

let message: string = "Hello, HarmonyOS";
let count: number = 10;
function greet(name: string): string {
    return `Hello, ${name}`;
}
let greeting: string = greet("HarmonyOS");

2. 接口

接口是 TypeScript 中定义复杂类型的一种方式，它可以描述一个对象的结构。

interface Person {
    name: string;
    age: number;
}
function showPersonInfo(person: Person) {
    console.log(`Name: ${person.name}, Age: ${person.age}`);
}
let person: Person = { name: "John", age: 30 };
showPersonInfo(person);

3. 类

类是 TypeScript 中定义对象类型的一种方式，支持继承和多态。

class Animal {
    constructor(public name: string) {}
    speak() {
        console.log(`${this.name} makes a noise.`);
    }
}

class Dog extends Animal {
    speak() {
        console.log(`${this.name} barks.`);
    }
}

let dog = new Dog("Bingo");
dog.speak(); // Bingo barks.

4. 继承

继承允许一个类（子类）继承另一个类（父类）的属性和方法。

class Base {
    commonMethod() {
        console.log("Common Method");
    }
}

class Derived extends Base {
    derivedMethod() {
        console.log("Derived Method");
    }
}

let derived = new Derived();
derived.commonMethod(); // Common Method
derived.derivedMethod(); // Derived Method

5. 泛型

泛型允许在定义函数、接口或类时使用类型参数。

function identity<T>(arg: T): T {
    return arg;
}

let output = identity<string>("Hello, world!");
console.log(output); // "Hello, world!"

6. 模块

模块是 TypeScript 中组织代码的一种方式，支持导入和导出。

// file1.ts
export function sayHello(name: string) {
    console.log(`Hello, ${name}`);
}

// file2.ts
import { sayHello } from "./file1";
sayHello("TypeScript");

7. 装饰器

装饰器是一种特殊类型的声明，它可以被附加到类、方法、属性或参数上。

function log(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
    console.log(`Property ${propertyKey} is being called`);
}

class Person {
    @log
    name() {
        return "John";
    }
}

let person = new Person();
person.name(); // Property name is being called

8. 异步编程

异步编程允许你编写非阻塞的代码。

async function fetchData() {
    return await fetch("https://api.example.com/data");
}

fetchData().then(data => console.log(data));

9. 类型别名

类型别名允许你为类型定义一个新名称。

type Name = string;
type Coordinates = { x: number; y: number };

let name: Name = "Alice";
let coordinates: Coordinates = { x: 10, y: 20 };

10. 类型保护

类型保护是一种检查变量类型的方法，可以在编译时确保变量具有正确的类型。

type Shape = Circle | Square;
function getArea(shape: Shape): number {
    if (shape instanceof Circle) {
        return Math.PI * shape.radius ** 2;
    } else {
        return shape.width * shape.height;
    }
}

11. 枚举

枚举是一种特殊的类型，它允许你为一组有限的值定义友好的名字。

enum Direction {
    Up,
    Down,
    Left,
    Right,
}

function move(direction: Direction): void {
    console.log(`Moving in direction: ${Direction[direction]}`);
}
move(Direction.Up);

12. 映射类型

映射类型允许你根据现有类型创建新的类型。

type ReadonlyPoint = Readonly<Point>;
let readonlyPoint: ReadonlyPoint = { x: 10, y: 20 };
readonlyPoint.x = 30; // Error: Cannot assign to 'x' because it is a read-only property