打包提示未添加uni-authentication模块

5.11.2026052520-alpha 版本已修复

2026-05-26 12:00 分享

欢迎到专业群（ uni-app 官方技术交流群 1 ）咨询，群中有相关专业的管理员和群友。

根据你的描述，在 HBuilderX 5.08 alpha 版本中勾选了 Fingerprint 和 FaceID 模块，但打包后仍提示“打包时未添加uni-authentication模块”，这通常与打包方式有关。

云打包与离线打包的区别

manifest.json 中的模块勾选仅对 App 云打包 生效。如果你使用的是离线打包，需要在原生工程中手动配置这些模块。

解决方案

确认打包方式：首先确认你使用的是云打包还是离线打包。
离线打包配置：如果是离线打包，你必须按照文档在原生工程中添加对应的依赖文件和配置。知识库中有关于 Fingerprint 模块在离线打包时配置的明确说明：
- Android 平台：需要在 dcloud_properties.xml 文件中添加如下代码：
```
<feature name="Fingerprint" value="io.dcloud.feature.fingerprint.FingerPrintsImpl"/>  
```
  本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent
- iOS 平台：需要添加 liblibFingerprint.a 库，并依赖 LocalAuthentication.framework 系统库。
云打包测试：如果离线打包配置后问题依旧，可以尝试使用云打包来验证模块是否生效。因为知识库中有用户反馈“使用在线打包就不会”出现类似问题。

如果上述步骤仍无法解决，建议检查离线打包的配置文件是否添加到了正确位置（可参考 ask 社区中类似问题的解决方案），或清理项目缓存后重新打包。

补充说明

FaceID 模块在 Android 平台通常需要结合 uni实人认证使用，而 iOS 平台则使用自带的 FaceID 功能。

内容为 AI 生成，仅供参考

请确认是uni-app项目还是uni-app x项目？uni-app项目在Android平台仅支持Fingerprint。
uni-app x项目5.08版本新增uni-authentication模块支持指纹和人脸识别。

2026-05-12 16:37 分享

4***@qq.com (作者)

uniapp项目，云打包，我勾选的Fingerprint指纹识别模块，Android打完包还是提示uni-authentication未选择。

2026-05-12 17:09
4***@qq.com (作者)

"modules" : {

"Geolocation" : {},

"Record" : {},

"VideoPlayer" : {},

"Barcode" : {},

"Permission" : {},

"Camera" : {},

"Push" : {},

"Fingerprint" : {}

},

2026-05-12 17:10
DCloud_App_Array

回复 4***@qq.com: uni-app项目没有uni-authentication模块，这是uni-app x项目中才有的。页面中是怎么调用的？

2026-05-13 12:35
飞翔的青蛙

回复 DCloud_App_Array: 调用了uni.checkIsSoterEnrolledInDevice

2026-05-16 17:33
4***@qq.com (作者)

回复 DCloud_App_Array: uni.startSoterAuthentication

2026-05-20 12:25