1# 统一认证控件 2 3- [简介](#简介) 4- [目录](#目录) 5- [说明](#说明) 6 - [使用说明](#使用说明) 7- [相关仓](#相关仓) 8## 简介 9 10**统一认证控件** 配套统一用户认证框架（user_auth_framework），在统一用户认证框架处理用户认证请求时，提供用户认证交互界面。界面支持调用的业务应用自定义标题等显示信息，并提供相应的功能按钮支持用户切换认证方式或取消认证。 11**图1** 统一认证控件架构图 12<img src="figures/authwidget_architecture_ZH.png" alt="统一认证控件架构图" style="zoom:80%;" /> 13 14## 目录 15 16``` 17//base/useriam/auth_widget 18├── entry # entry模块目录 19│ ├── src/main 20│ │ ├─ets 21│ │ │ └─extensionability # 系统弹框扩展能力实现，入口 22│ │ │ └─common # 公共工具目录 23│ │ │ └─pages # 弹框内容页面 24│ │ │ └─image # 页面使用的预置图标资源 25│ │ └─resources # 资源文件 26│ │ └─module.json5 # 全局配置文件 27│ └─ src/ohostest # arkXTest实现的自动化单元测试 28├── signature # 证书文件目录 29├── LICENSE # 许可文件 30└── figures # readme的截图 31``` 32 33## 编译构建 34 35在OpenHarmony源码根目录下，调用以下指令，单独编译统一身份认证控件部件。 36 37``` 38./build.sh --product-name rk3568 --ccache --build-target auth_widget 39``` 40 41> 说明： 42> 43> --product-name：产品名称，例如rk3568。 44> 45> --ccache：编译时使用缓存功能。 46> 47> --build-target: 编译的部件名称。 48 49## 说明 50 51### 使用说明 52 531. 统一身份认证控件提供了系统默认的用户身份认证界面，具体调用方式请参考统一认证框架北向使用指导，选择使用带控件的接口getUserAuthInstance,AuthParam指定认证参数，WidgetParam指定控件显示参数。 542. 为确保用户在系统上有统一的的身份认证体验，不带认证界面的身份认证API后续将逐步废弃，建议开发者使用API 10提供的新用户身份认证接口。 55 56## 相关仓 57 58**[useriam_user_auth_framework](https://gitee.com/openharmony/useriam_user_auth_framework)**
