WeTouch 开发文档

WeTouch 开发文档

基础开发注意事项

1、开发WeTouch时只允许同时运行一个项目工程,要开启一个新的项目,务必要关闭现在的VSCode窗口再开启新的窗口。此外,如果云端打包时APP时不止开一个工程,打包程序可能会找不到要打包的是哪个工程;

2、开发时当设置了10px字体在chrome中一般不生效,因为chrome默认最小支持12px字体,在移动端浏览器或App下是正常的。也可以修改chrome的设置让它支持10px字号。在“设置>>自定义字体>>最小字号”中调整

3、 开发时设置了框架提供的1像素细线有时候在chrome不生效也是正常现象,主要是因为pc端屏幕像素密度不够大,在移动端浏览器或App下是正常的;

4、开发时访问一个页面出现404提示,可能有两种情况,(1)链接过去的页面不存在 (2)该页面路径没有写在pages节点中;

5、使用开发工具时,有些时候遇到一些非常规的问题,比如无法停止开发服务、编译时间过长中途想重新编译等,这时可以试着重载窗口。在VSCode菜单中选择”查看>>命令面板...“打开命令面板,输入Reload Window然后即可,跟关闭编辑器再打开是一个作用;

6、在开发阶段,有时候需要用手机浏览器访问开发的页面测试,有的时候加载一个页面等待时间会比较长,这是因为开发环境的版本代码还没有优化和压缩过,不是最终的访问速度。如果要体验真实访问速度,可以将工程编译并导出web工程,部署到服务端访问,一般都会秒开;

7、每个组件标签建议单独起一行,否则可能会导致编译出错。例如

<ui-view class="sample_content">
  <ui-text class="price">16元</ui-text>
  <ui-text class="price2">门市价:30元</ui-text>
</ui-view>

而不是

<ui-view class="sample_content">
  <ui-text class="price">16元</ui-text><ui-text class="price2">门市价:30元</ui-text>
</ui-view>

8、当需要点击文本触发事件时(例如点击“返回”进行页面返回处理),不要直接在文本上绑定事件,而要为文字所在的容器绑定事件,尽量增大点击区域以提高点击准确度;

9、导出web工程后无法用鼠标操作:当然,因为WeTouch是用于移动开发,导出web工程的作用是用于webApp或者微信公众号等场景,请在移动端使用触摸方式操作或者开启chrome的手机预览模式;

10、入口文件与首屏文件区别:入口文件是指根目录的app.ui,这是整个app的框架结构,里面会放置一些公用内容,例如通用导航栏、底部tabBar等;首屏文件指的是进入app的第一个界面,在app.ui的config中进行配置,在pages节点的第一项就是首屏文件。公用的内容适合放在app.ui里,例如侧滑菜单内容,而只有首屏用到的适合放在首屏页面里,例如引导swiper内容;

11、API文档目录中,标有APP字样的在浏览器不支持,只能在APP端生效。

12、绑定事件函数时,函数中参数不可以加{{ }},否则函数会自动执行。

13、组件使用静态数据可以,使用远程数据就出错。参考文档的:框架>>方案>>组件的动态数据渲染