HarmonyOS实战开发-静态库（SDK）的创建和使用_harmonyos sdk

作者：我家小花儿 | 2024-05-24 03:54:11

踩

harmonyos sdk

1. 静态库（SDK）概述

在HarmonyOS中，静态库（通常以.har为文件扩展名）是一种用于代码和资源共享的机制。它允许开发者创建可重用的组件、接口和资源，以便在多个应用中共享和复用。

2. 创建静态库

2.1 新建静态库模块

打开DevEco Studio: 启动HarmonyOS开发环境。
创建项目: 如果还没有项目，创建一个新的HarmonyOS项目。
添加模块: 在项目视图中，右键点击项目名称，选择New > Module...。
选择模块类型: 在弹出的对话框中，选择Static Library。
命名模块: 输入模块名称，例如wmdinglibrary，然后点击Finish。

2.2 开发静态库内容

编写组件: 在新创建的静态库模块中，开发你的ArkUI组件、接口或资源，如下示例：

定义MainPage的页面：


@Component
export struct MainPage {
  @State message: string = 'Hello World';
 
  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}

定义wmding的类：


export class wmding {
  age: number = 0;
  name: string = "0";
 
  constructor(age: number, name: string) {
    this.age = age;
    this.name = name;
  }
 
  toString(): string {
    return this.name + ' ' + this.age;
  }
 
}

2.导出内容: 在index.ets文件中，使用export关键字导出你想要共享的组件或接口。如下示例，导出一个页面和一个名为 wmding 的类。


export { MainPage } from './src/main/ets/components/mainpage/MainPage'
export { wmding } from './src/main/ets/components/mainpage/wmding'

2.3 编译静态库

构建模块: 在项目视图中，选择静态库模块，然后点击Build > Make Module 'wmdinglibrary'

2.获取.har文件: 编译成功后，在模块的build/default/outputs/default目录下找到wmdinglibrary.har文件。

3. 使用静态库

3.1 配置项目依赖

编辑 oh-package.json5: 在主工程的根目录下，打开oh-package.json5文件。
添加依赖: 在dependencies部分，添加静态库的依赖项，例如：


{
  "license": "",
  "devDependencies": {},
  "author": "",
  "name": "entry",
  "description": "Please describe the basic information.",
  "main": "",
  "version": "1.0.0",
  "dependencies": {
    // 直接使用module，直接引用module的路径
    // "wmdinglibrary": "file:../wmdinglibrary"
    // 将wmdinglibrary.har放到固定目录下时引用
    "wmdinglibrary": "file:../entry/src/main/lib/wmdinglibrary.har"
 
  }
}

同步项目: 点击Sync Now按钮，同步项目以包含新添加的静态库。

3.2 在应用中使用静态库

导入组件或接口: 在你的应用代码中，使用import语句导入静态库中的组件或接口。
使用组件: 在你的应用页面或逻辑中，像使用普通组件一样使用导入的静态库组件。


import { wmding, MainPage } from 'wmdinglibrary'
 
@Entry
@Component
struct UseLibraryPage {
  @State message: string = 'Hello World';
  wmding2: wmding = new wmding(111, 'rere');
 
  build() {
    Row() {
      Column() {
 
        // 使用Library中的页面
        MainPage()
 
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
 
        Button('使用Library中的类')
          .onClick(() => {
            console.log("wmding: " + this.wmding2.age)
            console.log("wmding: " + this.wmding2.name)
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}