wechat-app-issues
早就知道小程序这个坑很深,一个多月的实践发现这个坑果然名不虚传...
不过,开发的小程序如期上线了,还是值得庆贺!!!呵呵,记录一下那些让自己停顿的点。
一、开发微信小程序遇到的坑
- 1、 {{}} 不能执行方法,只能处理简单的运算如 “+ - * /”,比如遇到遍历list,每个item的金额需要格式化,只能在js里预先格式化好再setData一遍( ╯□╰ )
- 2、只能通过,只能通过,只能通过setData()更新视图,坑..........
- 3、我们规定页面路径只能是五层,请尽量避免多层级的交互方式。
- 4、A页面-->B页面,B页面返回A,如何触发A的刷新,不增加页面层级。 暂时想到的方案:在A页面的onshow事件里写A的初始化数据逻辑。
- 5、
undefined 当作字符串处理 if(xxx == "undefined") 【后期版本迭代优化了】 - 6、遇到奇怪的问题(如样式等)先重启工具,百试不爽
- 7、不支持本地web字体(需要使用线上字体),经测试发现一些安卓就是不能正常显示。几经折腾才发现原来还要存放字体的服务器要支持跨域。尼玛,手机上调试也不报错,差点放弃web字体了。卡了好久,坑.............
- 8、本地资源无法通过 css 获取 可以使用网络图片,或者 base64,或者使用
<image/>
标签 - 9、不能直接操作 Page.data 【避免在直接对 Page.data 进行赋值修改,请使用 Page.setData 进行操作才能将数据同步到页面中进行渲染】
- 10、数字键盘用 type="digit"
- 11、已用 https,但报无法建立与该服务器的安全连接是什么情况【需要 nginx 配置一下 https 的加密标准为tls1.2及以上】
- 12、wx.setStorage(OBJECT) 【目前每个小程序限制5M】
- 13、数据监控【微信后台:事实访问次数/昨日概况/累计访问用户数/TOP受访页】
- 14、微信调试神器,ngrok,见 ngrok
- 15、view 添加点击效果[需要开启hover效果]:
<view hover hover-class="item-hover">
- 16、用户授权调试方法【开发工具-》清除手机授权数据 (缓存-清除手机授权数据) 】
- 17、安卓手机上小程序第一次加载时候首页时候, onshow方法会莫名其妙加载两遍,而同样在iphone下却不会,由于需要在onshow里面触发获取用户信息,所以系统加载两次onshow会导致后台报错。。。
- 18、禁止页面下拉: 设置 "disableScroll": true 。
- 19、安卓下会出现getAppConfig:fail,无法获取userInfo。微信问题,下载最新的微信安装包
- 20、后台不能接受POST数据,但是可以接收GET请求参数
url: url,
data: data,
method: "POST",
dataType: "json",
header: {
'content-type': 'application/x-www-form-urlencoded' //==> 此处若为application/json则服务端无法获取POST的参数
}
- 21、小程序第一次启动用户拒绝授权后,下一次无法唤起授权弹框,默认记住上一次用户的选择。暂时没有找到解决方法,微信也没有相关解析。【2017-01-10】 微信更新了api(wx.authorize(OBJECT)),支持唤起授权弹框【2017-07-05】
- 22、跳转到有tabbar的页面一定要用 wx.switchTab().这个在各个群里几乎每天都有人问到!!!
- 22、绑定开发者/体验者时记得去手机上确认邀请。(超多人问)
- 23、 微信后台更新了request合法域名,可以直接去微信开发工具-->项目-->配置信息-->刷新,立马生效。
- 24、 小程序官方没有提供java版登录信息解密示例,可以用这个demo java版解密demo
- 25、 使用wx:for遍历的时候最好加上wx:key="{{item.id}}",如果明确知道该列表是静态,或者不必关注其顺序,可以选择忽略,但是如果遍历的数组会发生改变,则有可能导致数据顺序会改变。
- 26、小程序开发页面便利之处在于rpx, 所以设计稿建议用iphone6尺寸。flex布局可以参考这篇
- 27、微信小程序的会默认监听文件变化,然后自动刷新。但不足的是每次都是全量刷新,而不是模块的热替换,反而会影响开发速度,尤其对于喜欢频繁Command + S的开发者,你会发现你的小程序在不断的刷新。@MinJieLiu
- 28、微信小程序自 基础库
1.6.4
开始支持了web-view
组件,即在小程序支持了嵌入网页的能力,但是使用的时候发现在开发者工具中不能显示网页,手机预览却可以【升级微信客户端最新版本】。原因是所使用的基础库不支持web-view
组件,可通过选择最新的基础库解决。如下:
- 29、 不支持H5和小程序通信,不能通过本地存储之类的手段打通, 如果硬是需要携带参数,可以尝试在
web-view
url 中携带,但是不推荐,H5可以使用公众号授权。web-view开放的能力(网页需嵌入jssdk): 网页中支持的JSSDK接口: - 30、web-view 目前不支持微信支付
- 31、小程序中
try...catch
语句中catch
部分使用throw
抛出错误在更外层的try...catch
无法捕获到
二、小程序开发前相关配置
- 1、登录--->管理员扫二维码-->设置-->开发设置-->生成AppSecrect
- 2、服务器配置 登录--->管理员扫二维码-->设置-->开发设置-->服务器域名-->扫二维码
- 3、绑定开发者 用户身份-->开发者-->二维码 开发者最多10人
- 4、绑定体验者 用户身份-->体验者-->二维码扫描 体验者20人
三、小程序发布
发布只能用管理员账号。步骤如下:
- 开发工具中退出开发者账号
- 管理员扫码登录开发者工具,上传-->微信后台设为体验版本-->审核-->发布
注意: 审核时间不定,2-6天
四、审核不通过原因收集
- 1、小程序简介没有介绍小程序功能
- 2、类目与页面提供的内容不一致
- 3、小程序提供的服务和内容必须是正式的,不能以测试内容提交,多次以测试内容提交
- 4、含有声音视频内容,请补充相关对应类目
- 5、首页图片与文字有互相重叠,建议优化
- 6、搜索框及少数下才能选中,页面评论点击无响应,页面图片分辨率尺寸失真
- 7、部分图片显示被压缩体检不好
- 8、有账号体系的小程序,除自有登录方式,必须支持微信授权登录
- 9、必须登录才能使用的服务,请提供测试账号
- 10、存在虚拟物品在线交易, ios系统需要走IAP,小程序暂不支付,请留意后续
- 11、小程序服务类目所对应的页面中的核心内容必须与该类目一致。
- 12、必须保证用户在该页面能使用该服务类目,不得隐藏,不得进行多次跳转
- 13、不得展示和推荐第三方小程序。示例:不能做小程序导航,不能做小程序链接互推,小程序排行榜等
- 14、小程序的页面内容中,存在诱导类行为,包括但不限于诱导分享、诱导添加、诱导关注公众号、诱导下载等,要求用户分享、添加、关注或下载后才可操作的程序,含有明示或暗示用户分享的文案、图片、按钮、浮层、弹窗等的小程序,通过利益诱惑诱导用户分享、传播的小程序,用夸张言语来胁迫、引诱用户分享的小程序,强制或诱导用户添加小程序的,都将会被拒绝;
- 15、 禁止视频、音乐、语音等多媒体的自动播放
- 16、 如果小程序有账户系统,必须提供能正常使用且易于发现的“退出”账户选项
- 17、小程序内容不能包含赌博、竞猜和抽奖的。
- 18、小程序的页面内容中,不能存在测试类内容;示例:算命,抽签,星座运势等。
五、文档及社区
六、code
- 1、封装微信发起请求接口,登录失效默认自动发起登录请求
/**
* 发起的是 HTTPS 请求
* @pram url: 请求地址,协议必须为https
* @pram data 请求参数请求参数
* @param success 请求成功回调
* @param fail 请求失败回调
* @param complete 请求完成(成功或者失败)回调
*/
function request(url, data, success, fail, complete) {
var _url = url,
_data = data,
_success = success,
_fail = fail,
_complete = complete;
wx.request({
url: url,
data: data,
method: "POST",
dataType: "json",
header: {
'content-type': 'application/x-www-form-urlencoded',
'Client-Agent': getSystemInfo(),
'WX-SESSION-ID': wx.getStorageSync(constant['WX-SESSION-ID']) //每次请求带上登录标志
},
success: function(res) {
if(res.data.code == "-9999") { //会话失效重新登录
requestLogin(function(){
constant['NUM_TRY_LOGIN'] ++;
//设置请求上限,防止重复提交并死循环
if(constant['NUM_TRY_LOGIN'] < constant['LIMIT_NUM_TRY_LOGIN']) {
request(_url, _data, _success, _fail, _complete);
}
});
return;
}
if(res.data.code == "0") {
if(typeof _success == "function") {
_success(res.data);
}
} else {
wx.showToast({title: res.data.msg, icon: 'loading', duration: 2000});
return;
}
},
fail: function(res) {
if(typeof _fail == "function") {
_fail(res);
}
if(typeof _fail == "string") { //请求失败的弹框提示
wx.showToast({title: _fail, icon: 'loading', duration: 2000});
}
},
complete: function(res) {
if(typeof _complete == "function") {
_complete(res);
}
}
});
}
- 2、请求登录接口
/**
* 请求登录,获取用户相关信息
* @param callback
*/
function requestLogin(callback) {
var _callback = callback;
wx.login({
success: function (event) {
// 获取到请求码,继续请求用户的基本信息
if(event.code) {
var code = event.code;
wx.getUserInfo({
success: function (res) {
var data = {
code: code,
encryptedData: res.encryptedData,
iv: res.iv,
signature: res.signature,
rawData: res.rawData
}
var url = domain + "/wx_xxx"; //请求登录地址
request(url, data,
function(res){ //success
if(res.code == "0") {
//此处可以将服务端返回的登录状态保存起来
wx.setStorageSync(constant['WX-SESSION-ID'], res.object.sessionId);
if(typeof _callback == "function") {
_callback();
}
}
},
function(res){ //fail
wx.showToast({title: '请求登录失败',icon: 'loading', duration: 2000});
}
);
},
fail: function(res) {
//用户拒绝授权
if(res.errMsg == "getUserInfo:cancel" || res.errMsg == "getUserInfo:fail auth deny") {
wx.redirectTo({ //跳转至未授权页面
url: '../xxx-page/xxx-page'
});
}
}
})
} else {
wx.showToast({title: '微信登录失败',icon: 'loading', duration: 2000});
}
},
fail: function(res) {
wx.showToast({title: '微信登陆失败!',icon: 'loading', duration: 2000});
}
});
}