# OpenHarmony--third_party--DlibFace

**Repository Path**: xxrl2018/open-harmony--third_party--dlib-face

## Basic Information

- **Project Name**: OpenHarmony--third_party--DlibFace
- **Description**: DlibFace: An OpenHarmony App based on DLib.
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2025-09-11
- **Last Updated**: 2025-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenHarmony--third_party--DlibFace

#### 介绍

北京理工大学 (BIT) 硕士课程 “开源鸿蒙操作系统” 课程作业项目，2024 年秋季学期开课 (2024-2025-1)。我们成功将 DLib 的 C++ 第三方库移植到开源鸿蒙操作系统中，实现了相应的子系统服务，对外提供 NAPI 接口，并基于此接口完成了一款简单的人脸识别应用。

#### 小组成员

第43组

- 李昊阳  @声声箜篌鸣. 
- 李枚苣  @十二点心动 
- 王鑫  @wxlearning 
- 尤鑫洋  @intermatrix 

#### 项目结构

- **DlibFace**: DevEco Studio 工程目录，NAPI 接口位于：[DlibFace/entry/src/main/cpp](/DlibFace/entry/src/main/cpp)，前端位于：[DlibFace/entry/src/main/ets](DlibFace/entry/src/main/ets)

- **docs**: 存放各类文档：[成员分工](/docs/鸿蒙要求与分工.md)、[三方库移植文档](/docs/第三方库移植文档.md)、[功能开发文档](/docs/应用功能开发文档.md)、[演示视频](/docs/应用演示视频.mp4)

- **sources**: dlib-19.24.6 源文件、dlib 库所需的人脸识别模型、二进制文件

- **transplants**: 第三方库移植部分

    - **compile_rk3568_out**

        编译鸿蒙 dlib 子系统的输出，目标开发板为 rk3568，目标编译部件为 dlibpart，所属子系统为 dlibsystem，含有模块 libdlib

        执行命令为: `./build.sh  --product-name rk3568 --ccache --build-target=dlibpart`

    - **lycium_sdk**

        仅使用 ohos_sdk 与 lycium 交叉编译工具编译 dlib 第三方库，包含 [HPKBUILD](/transplants/lycium_sdk/HPKBUILD) 文件

    - **origin_cmake_files**

        在 Ubuntu 本地进行 cmake 的编译结果，通过分析编译过程编写对应的鸿蒙配置文件，列出了 build 中的关键文件

    - **pre-check**

        利用 e2e 工具预检查 dlib 库可移植性，手动审查并移除 MANUAL_CONFIRM 的检查符号（对应 error 符号）后，代码检查全量通过

    - **subsystem_config**

        OpenHarmony 源码目录下各项配置的路径与对应文件，包括 [subsystem_config.json](/transplants/subsystem_config/OpenHarmony/build/subsystem_config.json)、[BUILD.gn](/transplants/subsystem_config/OpenHarmony/dlib/BUILD.gn)、[bundle.json](/transplants/subsystem_config/OpenHarmony/dlib/bundle.json) 等

- **LICENSE**: Apache-2.0

- **README.en.md/README.md**: 英文/中文说明文档

#### 项目过程

1. **搭建环境**
    - 安装 OpenHarmony 相关工具包，配置环境变量
    - 搭建 DLib C++ 库源码编译环境

2. **可移植性检查**
    - 用 e2e 工具对 dlib 库进行可移植性预检查

3. **编译第三方库**
    - 研究本地 cmake 编译结果，编写鸿蒙配置文件
    - 按要求配置好编译文件，调整编译参数，编译对应子系统
    - 此外，使用 lycium 交叉编译工具编译第三方库

4. **NAPI接口实现**
    - 在第三方库的动态链接库的基础上，开发 NAPI 接口

5. **开发APP**
    - 开发一款人脸识别 APP

#### 版本界定

- DLib: 19.24.6\
  http://dlib.net/

- OpenHarmony: 5.0.1 Release\
  https://gitee.com/openharmony/docs/blob/master/zh-cn/release-notes/OpenHarmony-v5.0.1-release.md

- Ubuntu: 22.04.5 LTS (Jammy Jellyfish)\
  https://www.releases.ubuntu.com/22.04/

- HUAWEI DevEco Studio: 5.0.1 Release\
  https://developer.huawei.com/consumer/cn/download/