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%')
}
}
4. 注意事项
- 路径正确性: 确保在oh-package.json5中指定的静态库路径正确无误。
- 同步操作: 添加或更新依赖后,务必执行同步操作,否则项目可能无法正确识别静态库。
- 版本控制: 如果静态库会频繁更新,建议使用版本控制来管理静态库的版本,避免因版本不一致导致的问题。
- 资源冲突: 如果静态库中包含资源文件,确保资源名称不会与主工程中的资源冲突。
- 编译顺序: 在构建项目时,确保静态库先于使用它的模块编译,以避免依赖问题。
- 权限和配置: 根据静态库的功能,可能需要在应用的配置文件中添加相应的权限或配置。
通过以上步骤,你可以在HarmonyOS中创建和使用静态库,以实现代码和资源的高效复用。在实际开发过程中,注意遵循最佳实践,确保应用的稳定性和可维护性
为了帮助大家更深入有效的学习到鸿蒙开发知识点,小编特意给大家准备了一份全套最新版的HarmonyOS NEXT学习资源,获取完整版方式请点击→《https.docs.qq.com》
HarmonyOS教学视频:语法ArkTS、TypeScript、ArkUI等.....视频教程
鸿蒙生态应用开发白皮书V2.0PDF:
获取完整版白皮书方式请点击→《https.docs.qq.com》
鸿蒙 (Harmony OS)开发学习手册
一、入门必看
- 应用开发导读(ArkTS)
- ……
二、HarmonyOS 概念
- 系统定义
- 技术架构
- 技术特性
- 系统安全
- ........
三、如何快速入门?《https.docs.qq.com》
- 基本概念
- 构建第一个ArkTS应用
- ……
四、开发基础知识
- 应用基础知识
- 配置文件
- 应用数据管理
- 应用安全管理
- 应用隐私保护
- 三方应用调用管控机制
- 资源分类与访问
- 学习ArkTS语言
- ……
五、基于ArkTS 开发
- Ability开发
- UI开发
- 公共事件与通知
- 窗口管理
- 媒体
- 安全
- 网络与链接
- 电话服务
- 数据管理
- 后台任务(Background Task)管理
- 设备管理
- 设备使用信息统计
- DFX
- 国际化开发
- 折叠屏系列
- ……