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

1. 静态库（SDK）概述

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

2. 创建静态库

2.1 新建静态库模块

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

2.2 开发静态库内容

1. 编写组件: 在新创建的静态库模块中，开发你的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 编译静态库

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

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

3. 使用静态库

3.1 配置项目依赖

1. 编辑 oh-package.json5: 在主工程的根目录下，打开oh-package.json5文件。
2. 添加依赖: 在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"

  }
}

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

3.2 在应用中使用静态库

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

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%')
  }
}

4. 注意事项

• 路径正确性: 确保在oh-package.json5中指定的静态库路径正确无误。
• 同步操作: 添加或更新依赖后，务必执行同步操作，否则项目可能无法正确识别静态库。
• 版本控制: 如果静态库会频繁更新，建议使用版本控制来管理静态库的版本，避免因版本不一致导致的问题。
• 资源冲突: 如果静态库中包含资源文件，确保资源名称不会与主工程中的资源冲突。
• 编译顺序: 在构建项目时，确保静态库先于使用它的模块编译，以避免依赖问题。
• 权限和配置: 根据静态库的功能，可能需要在应用的配置文件中添加相应的权限或配置。

通过以上步骤，你可以在HarmonyOS中创建和使用静态库，以实现代码和资源的高效复用。在实际开发过程中，注意遵循最佳实践，确保应用的稳定性和可维护性

为了帮助大家更深入有效的学习到鸿蒙开发知识点，小编特意给大家准备了一份全套最新版的HarmonyOS NEXT学习资源，获取完整版方式请点击→《https.docs.qq.com》

HarmonyOS教学视频：语法ArkTS、TypeScript、ArkUI等.....视频教程

​

​

鸿蒙生态应用开发白皮书V2.0PDF：

获取完整版白皮书方式请点击→《https.docs.qq.com》

​

鸿蒙 (Harmony OS)开发学习手册

一、入门必看

1. 应用开发导读(ArkTS)
2. ……

​

二、HarmonyOS 概念

1. 系统定义
2. 技术架构
3. 技术特性
4. 系统安全
5. ........

​

三、如何快速入门？《https.docs.qq.com》

1. 基本概念
2. 构建第一个ArkTS应用
3. ……

​

四、开发基础知识

1. 应用基础知识
2. 配置文件
3. 应用数据管理
4. 应用安全管理
5. 应用隐私保护
6. 三方应用调用管控机制
7. 资源分类与访问
8. 学习ArkTS语言
9. ……

​

五、基于ArkTS 开发

1. Ability开发
2. UI开发
3. 公共事件与通知
4. 窗口管理
5. 媒体
6. 安全
7. 网络与链接
8. 电话服务
9. 数据管理
10. 后台任务(Background Task)管理
11. 设备管理
12. 设备使用信息统计
13. DFX
14. 国际化开发
15. 折叠屏系列
16. ……

​

更多了解更多鸿蒙开发的相关知识可以参考：《https.docs.qq.com》