返回

uni-app技术分享| uni-app常见问题(一)

Android

uni-app技术分享| uni-app常见问题(一)

在uni-app开发过程中,难免会遇到各种各样的问题,为了帮助开发者快速解决问题,本文汇总了一些常见的uni-app问题并给出详细的解答。

1. 运行无法使用插件

查看控制台提示是否存在以下提示, 请根据控制台提示操作:

  • 使用的是 标准运行基座 需要制作自定义运行基座
  • 运行时选择自定义基座运行(HBuilder 默认标准运行基座)
  • 插件仅支持自定义运行基座

2. HBuilderX 提示创建项目时“未找到合适的模板”

原因是当前最新版本的 HBuilderX 已经将uniapp模板内置到开发工具中,无需再安装项目模板了。

3. ios项目中使用image插件报错,且提示无此方法

解决办法是:

  • 在uniapp.scss文件中添加 @import "@dcloudio/uni-ui/lib/image/style/index.scss";
  • 安装 image 插件:npm install @dcloudio/uni-ui-image --save

4. 在组件中使用 报错

解决办法是:

  • 在uniapp.scss文件中添加 @import "@dcloudio/uni-ui/lib/template/style/index.scss";
  • 安装 template 插件:npm install @dcloudio/uni-ui-template --save

5. 无线调试时的错误"Debugger Agent xxxx not Found..."

解决办法是:

  • 在App.vue中添加debugger语句;
  • 将项目的运行环境修改为web;
  • 将Chrome的debugger地址修改为http://localhost:6080/。

6. HBuilderX 提示“无法启动,当前运行环境不是uni-app环境”

  • 有可能将某个普通项目文件夹(非uni-app项目)错误的当做了uni-app项目打开了。
  • 如果项目是uni-app项目,检查该项目下的manifest.json文件中是否含有"uni-app":"6.0.10"。

7. uni-app组件库显示异常

查看组件的引入方式,确保:

  • 在HBuilderX的项目结构中,组件所在目录或文件必须放置在uni_modules目录下。
  • 在uniapp.scss中,组件的样式文件必须按照一定的顺序引入。
  • 在main.js中,组件必须按照一定顺序引入。

8. iOS微信小程序运行出错:_ReceiveMessage can only be called in a callback of receiveMessageCallback or onMessageCallback in AppEntry.m.

解决办法是:

  • 在App.vue中,onLoad方法中增加如下代码:
mpvue.setReceiveMessageListener(function(msg, type) {
    console.log("receivemessage", msg, type);
});

9. 真机编译安卓微信开发者工具报编译报错,提示插件包安装失败。

解决办法是:

  • 需要编译环境中正确安装有JDK和Android Studio。
  • 尽量在原生开发者工具中编译,或更换更高版本的微信开发者工具。

10. uni-app应用打包后,启动页面出现 运行时错误 xxxxxxxxxxx 中断。

解决办法是:

  • app.vue组件中data是defineProperties定义的,在Vue3的组件中不可以使用这种方式。
  • 换成return一个对象。

以上就是uni-app开发中常见问题的汇总及解答,希望能帮助开发者快速解决问题,提高开发效率。