HarmonyOS-静态库（SDK）的创建和使用

文章目录

一、静态库（SDK）
二、创建静态库
- 1.新建静态库模块
- [2. 开发静态库内容](#2. 开发静态库内容)
- [3. 编译静态库](#3. 编译静态库)
三、使用静态库
- [1. 配置项目依赖](#1. 配置项目依赖)
- [2. 在应用中使用静态库](#2. 在应用中使用静态库)
- [3. 注意事项](#3. 注意事项)
四、打包错误
- [1. library引用本地har包错误](#1. library引用本地har包错误)

一、静态库（SDK）

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

二、创建静态库

1.新建静态库模块

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

2. 开发静态库内容

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

@Component
export struct BasePage {
@State message: string = '';

build() {
Row() {
Column() {
Text(this.message)
.fontSize(50)
.fontWeight(FontWeight.Bold)
}
.width('100%')
}
.height('100%')
}
}

定义基础的类：

复制代码

@Component
export class BaseConfig {
  IMAGE_BACK_SIZE: number = 21;
  IMAGE_BACK_MARGIN_RIGHT: number = 18;
  IMAGE_LOADING_SIZE: number = 22;
  BAR_HEIGHT: number = 47;
  BAR_MARGIN_HORIZONTAL: number = 26;
  BAR_MARGIN_TOP: number = 10;
  WEIGHT: string = '50%';
}

2.导出内容

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

复制代码

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

3. 编译静态库

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

2.获取.har文件

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

三、使用静态库

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的路径
"Baselibrary": "file:../Baselibrary"
// 将wmdinglibrary.har放到固定目录下时引用
// "Baselibrary": "file:../entry/src/main/lib/Baselibrary.har"

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

2. 在应用中使用静态库

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

import { Baselibrary, MainPage } from 'Baselibrary'

@Entry
@Component
struct UseLibraryPage {
@State message: string = 'Hello World';

build() {
Row() {
Column() {
复制代码
```
     Text(this.message)
       .fontSize(50)
       .fontWeight(FontWeight.Bold)
   }
   .width('100%')
 }
 .height('100%')
```
}
}

3. 注意事项

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

四、打包错误

1. library引用本地har包错误

解决措施

HarmonyOS library引用本地的har包的引用方式需要进行改造，具体步骤为：

在工程根目录下创建一个libs文件夹，并将需要引用的本地har包放到该文件夹下。

不支持har引本地har的格式，需要引用的har发布到npm仓上然后引用！