【OpenHarmony】OpenHarmony 开发基础 ① ( 鸿蒙手机的 HarmonyOS 4.0.0 系统真实 API 版本为 9 | 创建 OpenHarmony 9 版本应用并运行 )_鸿蒙api版本

在之前的博客

• 【鸿蒙 HarmonyOS】Windows 平台搭建 DevEco Studio 开发环境 ① ( 安装 Node.js / ohpm | 安装配置 SDK | 环境变量配置 | 新建项目示例 )
• 【鸿蒙 HarmonyOS】Windows 平台搭建 DevEco Studio 开发环境 ② ( DevEco Studio 设备管理 | 设备管理器 | 远程模拟器/设备 | 本地模拟器 )
• 【鸿蒙 HarmonyOS】Windows 平台搭建 DevEco Studio 开发环境 ③ ( 华为 Mate30 真机运行鸿蒙应用 | hdc 命令行工具使用 )

中 , 在 WIndows 10 系统中 , 安装了 HUAWEI DevEco Studio 4.0 开发环境 , 从本篇博客开始 , 开始进行 鸿蒙 的应用开发 ;

一、HarmonyOS 真机与 OpenHarmony 的 API 版本匹配 ( HarmonyOS 4.0.0 对应 OpenHarmony API 9 SDK )

---

当前使用的是 华为畅享 50 Pro 测试机 , 在 设置 中的 关于手机 页面中 , 显示的 HarmonyOS 版本是 4.0.0 ;

华为对外宣传 , 要在 HarmonyOS 4.0 版本中 , 取消对 Android 的兼容 , 不再支持 Android 应用 ,

目前 整个 鸿蒙生态中 本身的原生应用太少 , 一旦不支持 Android 应用 , 很多功能将无法使用 ,

目前版本卡在了 HarmonyOS 3.1 Release 版本 , 已经一年多没有更新版本了 , 之前都是保持 2 ~ 3 个月更新一版的速度 ;

从 网站上的 版本说明 https://developer.huawei.com/consumer/cn/doc/harmonyos-releases-V2/harmonyos_release_3_1_202305-0000001582097989-V2?catalogVersion=V2 页面看 , 去年 5 月就是 HarmonyOS 3.1 Release 版本 , 一直没有更新 ,

估计华为也很纠结这事 , 要推动所有 Android 开发者 重新学习 鸿蒙 HarmonyOS 开发 , 有点难度 , 重新培养新的开发者 , 又没有那么多的岗位支持 ;

等 HarmonyOS 系统的 市场占有率上来 , 估计才能出现真正的 剥离 Android 的系统版本 ;

这个版本实际上是 HarmonyOS 3.1 开发者版本 , 对应的 API 版本是 9 ;

开发者 版本 和 给用户看的 版本 不是一个 , 估计 用户版本 是 兼容 Android 的 , 现在的 纯 HarmonyOS 鸿蒙原生应用 , 没有几个 ;

运行 API 10 版本的 OpenHarmony 应用程序 , 报错

Failure[INSTALL_PARSE_FAILED_USESDK_ERROR]
compileSdkVersion and releaseType of the app do not match the apiVersion and releaseType on the device.
1
2

信息 , 按理说 HarmonyOS 可以安装 API 10 的应用 ;

HarmonyOS 官网 给出的 HarmonyOS 3.1/4.0 对应 API 9 级别的 SDK 版本 ;

因此 , 这里要在该 HarmonyOS 4.0 手机中运行 鸿蒙应用 , 创建 OpenHarmony API 9 版本的应用程序 ;

二、创建 OpenHarmony 应用并运行

---

创建 OpenHarmony 应用 , 可以运行在所有的 OpenHarmony 设备上 , 包括 第三方厂商的 嵌入式设备 或 车载设备 , 不仅仅局限于 华为的 HarmonyOS 手机 ;

1、查看 HarmonyOS 和 OpenHarmony SDK

在之前的博客中 , 安装了 HarmonyOS 和 OpenHarmony 的 SDK , 检查下这两个 SDK 的各个 API 的版本号 ;

HarmonyOS 和 OpenHarmony 的 SDK 安装在了不同的目录中 ;

选择 " 菜单栏 / 文件 / 设置 " 选项 ,

在 设置 对话框 中 , 选择左侧的 SDK 选项 , 默认显示 HarmonyOS 的 SDK , 完整的安装了 API 8 和 API 9 两个版本的 SDK , 可创建 API 8 / 9 的 HarmonyOS 应用 ;

点击下图 红色矩形框 中的 下拉菜单 , 可以切换 SDK 类型 , 切换成 OpenHarmony SDK 后 , 可以看到 OpenHarmony 的 API 版本号是 8 / 9 / 10 , 可创建 OpenHarmony 的 对应版本的应用程序 ;

创建应用时 , 尽量创建 OpenHarmony 的应用 , 创建 HarmonyOS 的应用 , 可能无法在 OpenHarmony 系统 或者 HarmonyOS Next 系统 中运行 ;

2、创建 OpenHarmony 应用并运行

在 DevEco Studio 欢迎界面中 , 点击 " 新建项目 " 按钮 ,

选择创建 [OpenHarmony]Empty Ability 类型的 应用 , 该类型应用使用的是 OpenHarmony 的 API ,

在后续配置中 , 可配置项目的 工程名 , 包名 , 代码位置 , 编译 SDK 版本 , 最低兼容 SDK 版本 ;

此处选择 API 9 版本的 OpenHarmony SDK , 创建后可运行在 HarmonyOS 4.0 的真机上运行 ,

注意 : 在 HarmonyOS 4.0 的真机上 , 无法运行 API 10 的 OpenHarmony 应用 , 会报错 " Failure[INSTALL_PARSE_FAILED_USESDK_ERROR] " ;

创建完成后 , 进入了 开发界面 ;

主页内容如下 :

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

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

在 底部的 日志 面板 中 , 点击 面板 左侧的 截图 按钮 , 可以截取 当前的 真机运行 ;

在手机上的运行效果如下 :