【HarmonyOS 5】金融应用开发鸿蒙组件实践

【HarmonyOS 5】金融应用开发鸿蒙组件实践

一、鸿蒙生态观察

2024 年 1 月 18 日：
发布 原生鸿蒙操作系统星河版，面向开发者开放申请，余承东宣布鸿蒙生态设备数达 8 亿台；建设银行、邮储银行等完成鸿蒙原生应用 Beta 版本开发。

2024 年 10 月 22 日：
HarmonyOS NEXT(鸿蒙 5.0) 发布，这是中国首个全栈自研操作系统，彻底脱离安卓，流畅度显著提升，标志中国在操作系统领域取得突破性进展。11 月 26 日，华为 Mate70 系列与 Mate X6 发布，到手即可升级原生鸿蒙系统。

2025 年 3 月：
原生鸿蒙正式版发布，HarmonyOS 5，发布Pura X 首款全面搭载 HarmonyOS 5 的阔折叠手机。

2025 年 5 月：
鸿蒙 PC 发布，从内核重构操作系统，由鸿蒙底座、生态和体验三大核心板块组成，实现国产操作系统在 PC 领域的重要突破。

根据 2025 年 5 月的信息，鸿蒙系统的设备装机量已超过 10 亿台。
国内鸿蒙化应用越来越多，外资例如汇丰，渣打今年都已启动鸿蒙项目。
从 BOSS 直聘、猎聘等平台信息来看，鸿蒙相关岗位丰富，薪资可观。

二、鸿蒙特性助力金融应用

TEE
Trusted Execution Environment，可信执行环境。
在主处理器中的一个安全区域，确保各种敏感数据在一个可信环境中被存储、处理和受到保护。

TEE为授权安全软件，也称为“可信应用”提供一个安全的执行环境，通过实施保护、保密性、完整性和数据访问权限确保端到端的安全。

人脸活体检测
华为提供活体检测安全组件，方便三方应用集成。

登录后复制

// 导入人脸识别功能模块
import { interactiveLiveness } from '@kit.VisionKit';
// 导入业务错误处理模块
import { BusinessError } from '@kit.BasicServicesKit';
// 导入日志记录模块
import { hilog } from '@kit.PerformanceAnalysisKit';
// 导入权限控制相关模块
import { abilityAccessCtrl, common } from '@kit.AbilityKit';
// 导入提示框组件
import { promptAction } from '@kit.ArkUI';
// 导入应用包管理模块
import { bundleManager } from '@kit.MDMKit';

/**
 * 人脸活体检测页面组件
 * 提供相机权限申请和交互式人脸活体检测功能
 */
@Entry
@Component
struct FaceLivenessPage {

  // 记录用户是否已授予相机权限的状态
  @State userGrant: boolean = false;

  /**
   * 向用户申请相机权限
   * @returns 权限申请结果数组，0表示授权成功
   */
  private async reqPermissionsFromUser(): Promise<number[]> {
    // 获取当前UI上下文
    let context = getContext() as common.UIAbilityContext;
    // 创建权限管理实例
    let atManager = abilityAccessCtrl.createAtManager();
    // 发起相机权限申请
    let grantStatus = await atManager.requestPermissionsFromUser(context, ['ohos.permission.CAMERA']);
    return grantStatus.authResults;
  }

  /**
   * 处理相机权限申请流程
   */
  private async requestCameraPermission() {
    // 获取权限申请结果
    let grantStatus = await this.reqPermissionsFromUser();
    // 遍历结果检查是否授权成功
    for (let i = 0; i < grantStatus.length; i++) {
      if (grantStatus[i] === 0) {
        // 授权成功，更新状态并提示用户
        this.userGrant = true;
        promptAction.showToast({
          message: "授权成功!"
        });
      }
    }
  }

  /**
   * 权限申请按钮点击事件处理函数
   */
  onClickPermission = () => {
    this.requestCameraPermission();
  }

  /**
   * 人脸活体检测按钮点击事件处理函数
   */
  onClickFaceLiv = () => {
    // 检查是否有相机权限
    if (!this.userGrant) {
      promptAction.showToast({
        message: "无相机权限！"
      });
      return;
    }

    // 配置活体检测模式为交互式
    let isSilentMode = "INTERACTIVE_MODE" as interactiveLiveness.DetectionMode;
    // 配置需要完成的动作数量为3个
    let actionsNum = 3 as interactiveLiveness.ActionsNumber;
    // 配置活体检测参数
    let routerOptions: interactiveLiveness.InteractiveLivenessConfig = {
      actionsNum: actionsNum,         // 动作数量
      isSilentMode: isSilentMode,     // 检测模式
      routeMode: "back" as interactiveLiveness.RouteRedirectionMode // 检测完成后返回方式
    };
    
    // 启动人脸活体检测
    interactiveLiveness.startLivenessDetection(routerOptions, (err: BusinessError, result: interactiveLiveness.InteractiveLivenessResult | undefined) => {
      if (err.code !== 0 && !result) {
        // 检测失败，记录错误日志
        hilog.error(0x0001, "LivenessCollectionIndex", `Failed to detect. Code：${err.code}，message：${err.message}`);
        return;
      }
      // 检测成功，记录结果日志并提示用户
      hilog.info(0x0001, 'LivenessCollectionIndex', `Succeeded in detecting result：${JSON.stringify(result)}`);
      promptAction.showToast({
        message: JSON.stringify(result)
      });
    });
  }

  /**
   * 定义按钮通用样式
   */
  @Styles commonText() {
    .width(px2vp(600))      // 设置宽度
    .height(px2vp(120))     // 设置高度
    .backgroundColor(Color.Blue) // 设置背景色
    .borderRadius(15)       // 设置圆角
  }

  /**
   * 组件UI构建函数
   */
  build() {
    Column() {
      // 权限申请按钮
      Text("请求相机权限")
        .fontColor(Color.White)
        .textAlign(TextAlign.Center)
        .commonText()           // 应用通用样式
        .onClick(this.onClickPermission) // 绑定点击事件
        .margin({
          bottom: px2vp(60)     // 设置底部边距
        })

      // 人脸检测按钮
      Text("人脸活体检测")
        .fontColor(Color.White)
        .textAlign(TextAlign.Center)
        .commonText()           // 应用通用样式
        .onClick(this.onClickFaceLiv)   // 绑定点击事件

    }
    .height('100%')           // 设置高度为全屏
    .width('100%')            // 设置宽度为全屏
    .justifyContent(FlexAlign.Center) // 垂直居中对齐
    .backgroundColor(Color.Black)     // 设置背景色
  }
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.
• 20.
• 21.
• 22.
• 23.
• 24.
• 25.
• 26.
• 27.
• 28.
• 29.
• 30.
• 31.
• 32.
• 33.
• 34.
• 35.
• 36.
• 37.
• 38.
• 39.
• 40.
• 41.
• 42.
• 43.
• 44.
• 45.
• 46.
• 47.
• 48.
• 49.
• 50.
• 51.
• 52.
• 53.
• 54.
• 55.
• 56.
• 57.
• 58.
• 59.
• 60.
• 61.
• 62.
• 63.
• 64.
• 65.
• 66.
• 67.
• 68.
• 69.
• 70.
• 71.
• 72.
• 73.
• 74.
• 75.
• 76.
• 77.
• 78.
• 79.
• 80.
• 81.
• 82.
• 83.
• 84.
• 85.
• 86.
• 87.
• 88.
• 89.
• 90.
• 91.
• 92.
• 93.
• 94.
• 95.
• 96.
• 97.
• 98.
• 99.
• 100.
• 101.
• 102.
• 103.
• 104.
• 105.
• 106.
• 107.
• 108.
• 109.
• 110.
• 111.
• 112.
• 113.
• 114.
• 115.
• 116.
• 117.
• 118.
• 119.
• 120.
• 121.
• 122.
• 123.
• 124.
• 125.
• 126.
• 127.
• 128.
• 129.
• 130.
• 131.
• 132.
• 133.
• 134.
• 135.
• 136.
• 137.
• 138.
• 139.
• 140.

图片筛选

隐私安全提升，比业内Android和IOS更加保护用户隐私与安全。

登录后复制

import { photoAccessHelper } from '@kit.MediaLibraryKit';
import { BusinessError } from '@kit.BasicServicesKit';

/**
 * 相册图片选择
 */
@Entry
@Component
struct AlbumPage {

  private TAG: string = "AlbumPage";

  onClickSelectPhoto = ()=>{
    try {
      let PhotoSelectOptions = new photoAccessHelper.PhotoSelectOptions();
      // 设置筛选过滤条件
      PhotoSelectOptions.MIMEType = photoAccessHelper.PhotoViewMIMETypes.IMAGE_TYPE;
      // 选择用户选择数量
      PhotoSelectOptions.maxSelectNumber = 1;
      // 添加图片目标筛选类型
      let recommendOptions: photoAccessHelper.RecommendationOptions = {
        recommendationType: photoAccessHelper.RecommendationType.ID_CARD | photoAccessHelper.RecommendationType.BANK_CARD | photoAccessHelper.RecommendationType.QR_CODE
      }
      PhotoSelectOptions.recommendationOptions = recommendOptions;
      // 实例化图片选择器
      let photoPicker = new photoAccessHelper.PhotoViewPicker();
      // 唤起安全相册组件
      photoPicker.select(PhotoSelectOptions, (err: BusinessError, PhotoSelectResult: photoAccessHelper.PhotoSelectResult) => {
        if (err) {
          console.error(this.TAG, "onClickSelectPhoto photoPicker.select error:" + JSON.stringify(err));
          return;
        }
        // 用户选择确认后，会回调到这里。
        console.info(this.TAG, "onClickSelectPhoto photoPicker.select successfully:" + JSON.stringify(PhotoSelectResult));
      });
    } catch (error) {
      let err: BusinessError = error as BusinessError;
      console.error(this.TAG, "onClickSelectPhoto photoPicker.select catch failed:" + JSON.stringify(err));
    }
  }

  build() {
    Row(){
      Button('点击唤起相册选择')
        .onClick(this.onClickSelectPhoto)
    }
    .justifyContent(FlexAlign.Center)
    .size({
      width: "100%",
      height: "100%"
    })
  }
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.
• 20.
• 21.
• 22.
• 23.
• 24.
• 25.
• 26.
• 27.
• 28.
• 29.
• 30.
• 31.
• 32.
• 33.
• 34.
• 35.
• 36.
• 37.
• 38.
• 39.
• 40.
• 41.
• 42.
• 43.
• 44.
• 45.
• 46.
• 47.
• 48.
• 49.
• 50.
• 51.
• 52.
• 53.
• 54.

扫一扫
系统提供安全扫码控件，简单几句代码即可集成扫码界面与解析。
扫码界面内完整集成图库选取，闪光灯补光，图片扫码，实时扫码。

登录后复制

import { scanBarcode, scanCore } from '@kit.ScanKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { promptAction } from '@kit.ArkUI';

@Entry
@Component
struct ScanPage {
  private TAG: string = "Index";

  private onToEasyScan = () => {
    let options: scanBarcode.ScanOptions = {
      scanTypes: [scanCore.ScanType.ALL],
      enableMultiMode: true,
      enableAlbum: true
    };
    scanBarcode.startScanForResult(getContext(this), options).then((result: scanBarcode.ScanResult) => {
      // 扫码解析成功，二维码数据
      console.info(this.TAG, " result: " + JSON.stringify(result));
      promptAction.showToast({
        message: result.originalValue
      });
    }).catch((error: BusinessError) => {
      // 扫码解析失败
      console.info(this.TAG, " error: " + JSON.stringify(error));
    });
  }

  build() {
    RelativeContainer() {
      Text("跳转一键扫码")
        .id('HelloWorld')
        .fontSize(50)
        .fontWeight(FontWeight.Bold)
        .alignRules({
          center: { anchor: '__container__', align: VerticalAlign.Center },
          middle: { anchor: '__container__', align: HorizontalAlign.Center }
        })
        .onClick(this.onToEasyScan)
    }
    .height('100%')
    .width('100%')
  }
}

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.
• 15.
• 16.
• 17.
• 18.
• 19.
• 20.
• 21.
• 22.
• 23.
• 24.
• 25.
• 26.
• 27.
• 28.
• 29.
• 30.
• 31.
• 32.
• 33.
• 34.
• 35.
• 36.
• 37.
• 38.
• 39.
• 40.
• 41.
• 42.
• 43.
• 44.
• 45.

三、开发问题定位和解决方案分享

鸿蒙开发经验分享

1、如何高效的学习鸿蒙？
所谓知其然，才能知其所以然，先进行鸿蒙整体概念的入门和学习，了解鸿蒙相关的专有名词是非常重要。

1.1、专有名词介绍：鸿蒙
特指HarmonyOS与OpenHarmony，前者是商业鸿蒙，是华为公司使用和维护的系统。后者是HW开源给开放原子基金协会的系统，任何人遵守开源协议，都可以使用和改造的系统。

HarmonyOS虽然基座是OpenHarmony，但是上层功能和使用差异也还是有的。两者虽然近似，但是并非一个东西。
两者区别详情参见：OpenHarmony和HarmonyOS区别与共性

鸿蒙相关公司
目前使用和维护开源鸿蒙OpenHarmony成长的公司有很多，例如深开鸿，润开鸿，鸿湖万联，开鸿智谷，九联开鸿等。开源鸿蒙的现在使用方向很多，例如电网，工业，物联，矿产等等。
商业鸿蒙，是华为公司自己进行迭代和维护与使用。

鸿蒙北向和南向
特指，北向应用开发，南向设备开发。设备开发多是基于开源鸿蒙。北向分OpenHarmony应用开发和HarmonyOS应用开发。

鸿蒙双框架和单框架
在 HarmonyOS NEXT 发布之前，华为手机运行的是 “双框架” 系统。其架构逻辑是鸿蒙和安卓框架共同存在，但底层基础服务仍以鸿蒙为核心，也被称为 “杂交系统”。单框架：以 HarmonyOS NEXT 为代表，是纯血鸿蒙系统，底座全线自研，去掉了传统的安卓开放源代码项目(AOSP)代码，只支持鸿蒙内核及鸿蒙系统的应用

鸿蒙HDE
华为开发者专家(HUAWEI DEVELOPER EXPERTS)，经过华为官方认证。他们是华为开放能力的实践领袖，肩负着技术布道、知识赋能等责任，会在各大技术社区解答用户有关华为开发能力的相关问题，定期在社交媒体上进行线上分享，也常在线下以讲师身份分享关于华为最新技术趋势讲解。

2、建立鸿蒙知识框架
我向来建议大家，建立鸿蒙的学习框架，首先了解鸿蒙是什么，能做什么，都有什么功能。新特性是什么？与Android和IOS的区别在哪？

只有充分解构学习目标之后，才能更有动力，更有方向的去学习鸿蒙。

综上所述，现在我们来看官方的文档，就明白如何去学习使用了。

版本说明，是鸿蒙迭代版本的详细说明，从这里我们可以了解到，鸿蒙最新的技术迭代方向，和某些老技术废弃的原因。及时调整自己的学习方向和开发方案。

指南作为开发功能的概述，会有完整的demo代码片段，当你需要更详细的接口文档时，就需要点击API参考进行查看。

最佳实践和FAQ作为开发方案的技术范本和常规问题规避，可以理解为踩坑文档。鸿蒙快速迭代如何不掉队？
因为鸿蒙在快速成长，API迭代速度很快。很多组件，路由管理，状态装饰器都在快速进化中。有的就被废弃了，需要快速学习新的方案。所以对持续学习的要求很高。

建议进行知识框架的搭建，例如通过思维导图，个人知识库，定期学习官方文档进行知识的迭代。在工作开发中，经常自我总结，归纳鸿蒙相关的技能和解决方案。