WeTouch 开发文档

WeTouch 开发文档

App开发注意事项

真机运行

1、每次更改代码后需要真机运行时都需要重新编译才行,否则运行的还是上次编译的版本;

2、为了提高开发效率,没有用到原生API的话可以直接在浏览器里查看效果,需要时再真机运行即可;

3、安卓真机运行不成功:

adb驱动没安装好。建议PC端安装腾讯应用宝或者360手机助手,使用手机助手成功连接手机后真机运行

4、安卓真机运行后卡在启动图上:

(1)在首页mouted中添加手动关闭启动图API

      window.setTimeout(() => {
        ui.closeSplashscreen()
      }, 1000)

(2)加上手动关闭启动图API仍然卡住的话,很可能是由于有JS错误。

先用浏览器运行看控制台是否报错。

如果浏览器控制台没错误可能是调用了某些真机API出错或者调用的时机不对。这时可以通过webview调试来排查错误。参见文档:实战>>安卓开发>>移动端App预览与webView调试

webview调试需要翻墙,不太方便。还有个简单的办法可以排查错误。就是在app.ui中的配置项添加debug:true。这样错误信息会以alert方式弹出来。参见文档:框架>>配置>>app配置

但需要注意的是,debug的方式只能作为一个初步的排查问题手段,不一定所有错误都会alert出来。例如如果在main.js中写的js或者组件内部的js是不会通过alert弹出错误的,webview调试是最保险的。

5、IOS真机运行不成功(1):

itunes没装或者itunes没能成功连接手机

6、IOS真机运行出错(2):

某些苹果手机会这样。这是由于iOS对文件传输限制太严格导致。建议多试几次,不行重启手机或者换个手机。如果iOS真机运行不了,建议平时开发时使用安卓真机运行。偶尔用云端打包APP的方式生成ipa文件安装到苹果手机测试

云端打包App

1、配置页面打不开

这里使用了3333端口,可能是由于你的3333端口被其他程序用了(例如Apache服务等)

如果还是不行建议重装VSCODE

2、打包报错:free over limit

个人版的免费流量用完,需要购买标准版

3、打包失败

打包失败。打包失败原因可能性有很多。常见的有:

(1)包名不规范。规范的包名应该是域名反写,例如com.uileader.xxx是正确的。如果是中文、字符串、含有特殊字符、含有数字等等都是不规范的。例如:测试、uileader、wetouch-viiv 、com.uileader(1)等等

(2)苹果的证书或配置文件名含有特殊字符,例如15311223344_jujia(2).mobileprovision,不能有括号

(3)图标资源格式不对,必须是png格式

(4)苹果证书配置文件需要勾选推送权限

(5)提示需要填写微信分享的id

如果你已经填写过微信分享,那么需要把微信登录信息也填写上(二者信息一样),否则安卓打包会失败。

4、打包成功但安装到手机后app打不开

多体现在安卓,会提示解析包错误。大多是包名不规范导致