Cool Unix

主题

常见问题 ​

运行时控制台提示 uni_modules[cool-svg] 存在第三方依赖或资源引用 ​

需要打包自定义基座，并配置运行环境https://uniapp.dcloud.net.cn/tutorial/run/uts-development-android.html

Mac 运行配置参考如下：

  • Gradle（8.5 版本）：/Users/icssoa/Desktop/coding/env/gradle-8.5/bin/gradle
  • JDK 路径：/Library/Java/JavaVirtualMachines/amazon-corretto-21.jdk/Contents/Home
  • 安卓 SDK 路径：/Users/icssoa/Library/Android/sdk

Configuring project':app' without an existing directory is not allowed. ​

HBuilderX 出现该提示，请安装 Gradle（8.5 版本）

loadFontFace: fail, font-family or src is null ​

HBuilderX 控制台出现 loadFontFace: fail, font-family or src is null，不必在意

为何使用 .ts 后缀而不是 .uts ​

我们选择使用 .ts 文件扩展名而不是 .uts 的原因是:

  1. HBuilderX 会自动将 .ts 文件转换为 .uts 文件
  2. TypeScript 提供了更完善的类型提示和智能补全功能
  3. 我们在项目中内置了专门用于 VSCode 的类型定义文件，可以获得更好的开发体验

暂时不推荐使用官方的 vscode 插件 ​

使用官方插件会导致丢失许多重要功能特性，比如 tailwindcss 的智能类型提示，同时可能会出现一些未知的语法错误提示。我们也不建议将 .uvue 文件的语言模式设置为 UVUE。不过,如果您正在开发 uts 插件，那么使用官方提供的 语言插件 是可以的。

API service is not running ​

出现 [cool-eps] API service is not running → http://127.0.0.1:8001/app/base/comm/eps 类似的情况，则 服务端未开启 或者 proxy 配置的地址不对

‌Cannot find a parameter with this name: base‌ ​

编译时出现 ‌⁠error: Cannot find a parameter with this name: base‌，则 服务端未开启 或者 proxy 配置的地址不对

Please specify it explicitly ​

这种错误通常表示在组件或标签上使用的变量缺少明确的类型定义。无法自动推断出变量的具体类型，需要通过显式类型声明来解决

鸿蒙平台空白或者点击闪退 ​

一般这种情况都是代码有问题，而且看不到错误提示，需要手动排查