在KaihongOS中导入接口模块

在KaihongOS中，接口模块是指一组定义了特定功能和行为的API（应用程序编程接口）集合，它们允许开发者访问和控制操作系统的特定功能或硬件特性。接口模块是KaihongOS提供给开发者的一套标准化的编程接口，用于构建应用程序和系统服务。

接口模块的特点

1. 封装性： 接口模块将复杂的系统功能封装成简单的API，使得开发者无需深入了解底层实现细节即可使用这些功能。

2. 模块化： KaihongOS的接口模块通常按照功能划分，每个模块负责一组相关的功能，这有助于保持系统的模块化和可维护性。

3. 可扩展性： 开发者可以根据需要添加或替换接口模块，以扩展或修改系统的功能。

4. 跨平台： KaihongOS的接口模块设计考虑了跨平台兼容性，使得开发者可以为不同的设备和硬件编写一次代码，然后在多个平台上运行。

5. 安全性： 接口模块提供了安全的访问控制，确保应用程序只能访问它们被授权使用的资源和功能。

6. 版本控制： 随着KaihongOS版本的更新，接口模块可能会增加新功能、改进或替换旧功能，这有助于系统的持续进化和改进。

接口模块的加载

接口模块的详细分类可参考API接口目录。

KaihongOS的接口模块是动态加载的，在应用程序启动时，系统会根据应用程序的配置信息，自动加载所需的接口模块。

1. 根据需求选择所需的接口模块，此处以HiLog日志打印的接口为例。
2. 在ets页面最开头导入接口模块：

// index.ets
import hilog from '@ohos.hilog';

3. 在需要打印日志的地方使用hilog中的方法，具体接口的的方法可查看@ohos.hilog(HiLog日志打印)。

// index.ets
Button() {
  Text('Next')
    .fontSize(30)
    .fontWeight(FontWeight.Bold)
}
.type(ButtonType.Capsule)
.margin({
  top: 20
})
.backgroundColor('#0D9FFB')
.width('40%')
.height('5%')
.onClick(() => {
  hilog.info(0x0001, "ImportAPI", "%{public}s KaihongOS %{private}d", "hello", 3)
})

4. 查看日志输出结果

• 如果当前电脑没有连接真机，则可直接操作预览器查看日志
  1. 点击窗口右边侧边栏中的“预览器”。
  2. 点击"Next"按钮。
  3. 点击窗口下边侧边栏中的“日志”，查看日志。
• 如果当前电脑已连接真机 （对于不同的真机，选择不同类型的线将电脑和真机连接） ，则可操作真机查看日志
  1. 关闭预览器，连接完真机后，查看窗口右上角的侧边栏，检查是否有真实设备的id，如果没有的话需要重新选择运行的设备；如果有的话则点击运行按钮，将项目推送到真机上运行。
  2. 点击窗口下边侧边栏中的“日志”，在最右边的输入框中输入“ImportAPI”过滤日志，在真机上点击“Next”按钮，查看日志。

index.ets完整代码

import hilog from '@ohos.hilog';

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

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
        // 添加按钮，以响应用户点击
        Button() {
          Text('Next')
            .fontSize(30)
            .fontWeight(FontWeight.Bold)
        }
        .type(ButtonType.Capsule)
        .margin({
          top: 20
        })
        .backgroundColor('#0D9FFB')
        .width('40%')
        .height('5%')
        .onClick(() => {
          hilog.info(0x0001, "ImportAPI", "%{public}s KaihongOS %{private}d", "hello", 3)
        })
      }
      .width('100%')
    }
    .height('100%')
  }
}

注： 当前文档中的源码路径：entry/src/main/ets/pages/applicationComposition/importAPI.ets

关于应用开发文档中，所涉及的项目代码目录结构说明

• 目前从写一个简单的页面到当前导入接口模块的文档中，已经开发了许多示例，我们根据文档目录结构将文档中涉及到的示例的代码都放在对应的目录中，方便开发者查看，同时，项目中的页面名称对应文档名称，方便开发者理解。（ 若有特殊项目需单独开发的话会做说明，否则都是放在sample_demo此项目中 ）。以下是目录结构：
• 在获取到源码后，需要运行对应目录下的代码可以通过以下步骤：
  • 解压项目源码包，双击打开DevEco Studio 4.1 Release。
  • 在窗口上方的菜单中，点击文件-打开项目-选择解压的项目源码，等待源码同步完成。
  • 找到项目源码包中，对应目录下的ets文件，双击打开，即可看到对应的示例代码，以当前文档中的代码为例，源码在entry/src/main/ets/pages/applicationComposition/importAPI.ets。
  • 全选importAPI.ets中的代码，将代码复制拷贝在Index.ets中。
  • 在窗口上方的菜单中，点击文件-项目结构-Signing Configs，选择Automatically generate signature后，点击Apply，点击OK，完成配置DevEco Studio的使用-自动签名。
  • 连接真机，点击运行按钮，即可看到效果。