2***@qq.com
2***@qq.com
  • 发布:2026-09-20 10:57
  • 更新:2026-09-20 10:58
  • 阅读:38

【报Bug】HBuilderX 5.26更新完后uni-chooseSystemImage一直提示报错,已按照文档进行重新打包和配置环境

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Windows

PC开发环境操作系统版本号: windows11

HBuilderX类型: 正式

HBuilderX版本号: 5.26

手机系统: Android

手机系统版本号: Android 16

手机厂商: OPPO

手机机型: 一加 Ace2 pro

页面类型: vue

vue版本: vue3

打包方式: 云端

项目创建方式: HBuilderX

操作步骤:

1、5.24版本引入uni-chooseSystemImage组件,打入自定义基座包
2、更新5.26后运行报:请前往运行配置环境
3、按照文档配置好运行环境,重新打自定义包
4、uni-chooseSystemImage还是报错运行报错

预期结果:

项目正常运行

实际结果:

uni-chooseSystemImage运行报错

bug描述:

HBuilderX 5.26使用:uni-chooseSystemImage插件会报以下错误,已按照文档设置运行环境和打基座包,恢复5.24版本正常了

项目 DiTuiApp 开始编译
10:44:34.355 请注意运行模式下,因日志输出、sourcemap 以及未压缩源码等原因,性能和包体积,均不及发行模式。
10:44:34.355 编译器版本:5.26(vue3)
10:44:34.355 正在编译中...
10:44:34.355 编译会生成大量临时文件,杀毒软件监控时会影响编译速度,并造成CPU升高。推荐把项目目录添加到杀毒软件的监控排除名单中。[添加] [帮助]
10:44:56.606 uni_module [uni-chooseSystemImage] 正在更新三方依赖...
10:45:58.597 uni_module [uni-chooseSystemImage]
10:45:58.597 FAILURE: Build failed with an exception.
10:45:58.597 Where:
10:45:58.597 Build file 'C:\Users\灏忚敗\AppData\Roaming\HBuilder X.uts-development-android\gradle\uni-chooseSystemImage_1789872296581\build.gradle' line: 2
10:45:58.597
What went wrong:
10:45:58.597 An exception occurred applying plugin request [id: 'com.android.application', version: '8.2.2']
10:45:58.597 > Failed to apply plugin 'com.android.internal.application'.
10:45:58.597 > Your project path contains non-ASCII characters. This will most likely cause the build to fail on Windows. Please move your project to a different directory. See http://b.android.com/95744 for details. This warning can be disabled by adding the line 'android.overridePathCheck=true' to gradle.properties file in the project directory.
10:45:58.597 * Try:
10:45:58.597 > Run with --stacktrace option to get the stack trace.
10:45:58.597 > Run with --info or --debug option to get more log output.
10:45:58.598 > Run with --scan to get full insights.
10:45:58.598 > Get more help at https://help.gradle.org.
10:45:58.598 BUILD FAILED in 50s
10:46:06.815 [plugin:uni:uts-uni_modules] kotlin编译失败
10:46:06.815 at uni_modules/uni-chooseSystemImage:1:0
10:46:06.815 ‌error: 找不到名称“activity”。参考: https://doc.dcloud.net.cn/uni-app-x/uts/compiler-known-issues.html#error18‌
10:46:06.815 at uni_modules/uni-chooseSystemImage/utssdk/app-android/ChooseSystemImageActivity.kt:13:17
10:46:06.815 11 | import android.view.WindowManager
10:46:06.815 12 | import android.widget.LinearLayout
10:46:06.815 13 | import androidx.activity.result.PickVisualMediaRequest
10:46:06.815 | ^
10:46:06.816 14 | import androidx.activity.result.contract.ActivityResultContracts
10:46:06.816 15 | import androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.VisualMediaType⁠
10:46:06.816 ‌error: 找不到名称“activity”。参考: https://doc.dcloud.net.cn/uni-app-x/uts/compiler-known-issues.html#error18‌
10:46:06.816 at uni_modules/uni-chooseSystemImage/utssdk/app-android/ChooseSystemImageActivity.kt:14:17
10:46:06.816 12 | import android.widget.LinearLayout
10:46:06.816 13 | import androidx.activity.result.PickVisualMediaRequest
10:46:06.816 14 | import androidx.activity.result.contract.ActivityResultContracts
10:46:06.816 | ^
10:46:06.816 15 | import androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.VisualMediaType
10:46:06.816 16 | import androidx.fragment.app.FragmentActivity⁠
10:46:06.816 ‌error: 找不到名称“activity”。参考: https://doc.dcloud.net.cn/uni-app-x/uts/compiler-known-issues.html#error18‌
10:46:06.816 at uni_modules/uni-chooseSystemImage/utssdk/app-android/ChooseSystemImageActivity.kt:15:17
10:46:06.816 13 | import androidx.activity.result.PickVisualMediaRequest
10:46:06.816 14 | import androidx.activity.result.contract.ActivityResultContracts
10:46:06.816 15 | import androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.VisualMediaType
10:46:06.816 | ^
10:46:06.816 16 | import androidx.fragment.app.FragmentActivity
10:46:06.816 17 | import java.util.Locale⁠
10:46:06.816 ‌error: 找不到名称“fragment”。参考: https://doc.dcloud.net.cn/uni-app-x/uts/compiler-known-issues.html#error18‌
10:46:06.816 at uni_modules/uni-chooseSystemImage/utssdk/app-android/ChooseSystemImageActivity.kt:16:17
10:46:06.816 14 | import androidx.activity.result.contract.ActivityResultContracts
10:46:06.816 15 | import androidx.activity.result.contract.ActivityResultContracts.PickVisualMedia.VisualMediaType
10:46:06.816 16 | import androidx.fragment.app.FragmentActivity
10:46:06.816 | ^
10:46:06.816 17 | import java.util.Locale
10:46:06.816 18 | ⁠
10:46:06.816 ‌error: 找不到名称“FragmentActivity”。参考: https://doc.dcloud.net.cn/uni-app-x/uts/compiler-known-issues.html#error18‌
10:46:06.816 at uni_modules/uni-chooseSystemImage/utssdk/app-android/ChooseSystemImageActivity.kt:20:35
10:46:06.816 18 |
10:46:06.816 19 |
10:46:06.816 20 | class ChooseSystemImageActivity : FragmentActivity() {
10:46:06.816 | ^
10:46:06.816 21 | override fun onCreate(savedInstanceState: Bundle?) {
10:46:06.816 22 | super.onCreate(savedInstanceState)⁠
10:46:06.970 代码编译报错?[AI修复]

2026-09-20 10:57 负责人:无 分享
已邀请:
Ask小助手

Ask小助手 - Ask社区AI助手

欢迎到专业群( uni-app x技术交流群 ) 咨询,群中有相关专业的管理员和群友。

感谢您的反馈。针对您提交的 Bug 报告,我们从 DCloud 官方技术支持的角度进行了评审与分析,具体意见如下:

一、 Bug 反馈内容完整性评审

  • 环境与分类信息:非常完整。您详细提供了 PC 环境(Windows 11)、HBuilderX 版本(5.26 正式版)、手机系统与机型(Android 16 / 一加 Ace2 pro)、Vue 版本(Vue3)等信息,这对排查问题非常有帮助。
  • 复现步骤与现象描述:清晰明了。您准确描述了从 5.24 升级到 5.26 后重新配置环境并打包基座的过程,并指出了回退 5.24 版本可恢复正常,同时附带了完整的控制台报错日志。
  • 预期与实际结果:合理且明确。
  • 附件说明:提示一下,我们无法识别和查看附件内容,后续如需补充信息请直接以文本形式提供。

二、 Bug 成立性分析
经过核查,该 Bug 反馈的现象是成立的,但并非 HBuilderX 5.26 版本编译器自身的缺陷,而是由于本地 Gradle 构建环境与路径配置引发的常见 UTS 插件编译问题。具体分析如下:

  1. 非 ASCII 路径导致构建失败
    日志中的核心报错为:Your project path contains non-ASCII characters. This will most likely cause the build to fail on Windows.
    这表明您的工程路径或 HBuilderX 的缓存路径中包含了非 ASCII 字符(从日志可见路径 C:\Users\灏忚敗\AppData\Roaming\HBuilder X\.uts-development-android\... 包含了中文字符)。在 Android Gradle 构建中,包含中文的路径极易导致构建直接失败,从而中断后续 UTS 插件的编译。

  2. UTS 插件缺少依赖引发 error18 报错
    日志中后续出现的 找不到名称“activity”找不到名称“fragment” 等报错,属于 UTS 编译器的已知问题(参考 UTS 编译器已知问题 error18)。
    uni-chooseSystemImage 插件内部依赖了 androidx.activityandroidx.fragment 等三方库。当本地 Gradle 构建因前述路径问题失败时,这些依赖无法被正确解析,编译器就会抛出找不到名称的异常。这并非 5.26 编译器改动导致,而是本地环境配置问题。

三、 解决方案与建议
针对您当前遇到的问题,建议按以下步骤排查和修复:

  1. 修改 HBuilderX 缓存路径(关键)
    请在 HBuilderX 的“工具 -> 设置 -> 运行配置”中,将 Android 编译缓存目录 修改为一个纯英文且无空格的路径(例如 D:\uts-cache),避免使用包含中文的用户目录。

  2. 检查并配置正确的 Gradle 版本
    请确保在“运行配置”中指定的本地 Gradle 路径指向的 Gradle 版本在 7.58.x 之间。日志中可能存在 Gradle 版本过高(如 Gradle 9.x)导致不兼容的情况,建议下载并使用 Gradle 8.x 版本。

  3. 清理缓存并重新编译
    修改完路径和 Gradle 配置后,完全退出 HBuilderX,删除原本的中文缓存目录(C:\Users\灏忚敗\AppData\Roaming\HBuilder X\.uts-development-android),然后重新启动 HBuilderX 进行编译打包。

通过以上调整,本地环境即可正确解析 uni-chooseSystemImage 的三方依赖,编译报错问题应能得到解决。

内容为 AI 生成,仅供参考

要回复问题请先登录注册