微信开发 手把手教你迁移微信小程序到 QQ 浏览器

minapp · 2018年12月18日 · 34 次阅读

继微信、QQ 之后,QQ 浏览器上也可以使用小程序了。

12 月 5 日,QQ浏览器小程序宣布,实现与微信小程序打通。QQ 浏览器 Android 版现已上线小程序,在搜索的场景下,小程序嵌入 QQ 浏览器「搜索直达」,作为直接的内容承载。用户在搜索框输入关键词后,相关小程序会在关键词智能推荐列表优先推荐,并直接展示相关内容。墨迹天气、腾讯翻译君等小程序已经成功入驻。

除此之外,QQ 浏览器小程序兼容适配了微信小程序,号称「只需三步」开发者即可完成适配工作将微信小程序移植到 QQ 浏览器上运行。

知晓程序也在第一时间体验了整个适配过程,接下来将为大家一一讲解其中的细节和关注点。值得一提的是,腾讯官方将 QQ 浏览器(QQ Browser)小程序称为 QB 小程序,听到这个名字想必大家会有种奇妙的感觉。

安装并注册 QB 小程序调试工具

在你正式上手调试前,我们需要提醒以下三点注意事项:

  1. 目前开发者工具只支持安卓;
  2. 小程序的正式名称、图标和简介是用户可见的,并且填写完成后暂时没有办法修改,所以填写一定要谨慎;
  3. qbDebugKey 是设备唯一的,每台手机都会生成一个 qbDebugKey

目前 QB 小程序的调试页面和介绍页面还十分简陋,也没有相关的 PC 端开发工具,所以开发者仍需在微信开发者工具上完成小程序的开发,然后适配成 QB 小程序。

1. 使用微信扫描二维码进入 QB 小程序调试页面。

扫描二维码后,页面可能会提示「调试内核版本过旧」,需按照提示长按识别页面中的二维码下载安装最新版调试内核,安装完成后再重新扫描上方二维码进入。

2. 进入调试页面后,需先完成「注册」。 在注册页面中:

  • packageName 是小程序的唯一标识,一旦注册成功,packageName 会在后台与 qbDebugKey 绑定,注册后只有当前设备可以使用这个 packageName 进行登录,如果需要给这个 packageName 绑定其他开发设备,可以在登录后进行添加。
  • 开发者昵称是 qbDebugKey 的别名,方便开发者管理开发设备。
  • 小程序的正式名称、图标和简介是用户可见的,注册完成后暂时不提供修改方法,请谨慎填写。

同时,你需要将 qbDebugKey 添加到微信小程序的 app.json 配置文件里,如下所示:

{
  "window": {
    "navigationBarBackgroundColor": "#FFF",
     "navigationBarTitleText": "知晓课堂",
     "navigationBarTextStyle": "black",
    "qbDebugKey": ["495f18a64485eeac5e78ccbxxx", "7e2f29d50e78411b3915128exxx"]
  },
}

注意:只有在 app.json 里配置过测试机生成的 qbDebugKey,测试机才能使用 QQ 浏览器小程序调试工具调试该小程序。一台手机对应一个 qbDebugKey

3.如果你完成了注册或已有其他开发者为你添加了开发权限,输入对应小程序 并点击「登录」按钮进入进入开发者管理后台页面。

在此页面中,你可以点击「开发者权限管理」添加其它开发设备,需要输入待添加设备的 qbDebugKey 和昵称,添加成功后,新设备就可以使用该 packageName 进行登录了。

安装调试版 QQ 浏览器

点击「启动 QB 打开小程序」按钮,如果没有下载调试版 QQ 浏览器,这步操作会下载调试版 QQ 浏览器。

如果你手机中未安装 QQ 浏览器或安装的版本非正确的调试版本,在点击后会提示「请先下载调试版 QQ 浏览器」,按照提示再次点击按钮即可开始下载安装;安装完成后再次回该页面点击启动按钮即可拉起 QQ 浏览器启动要调试的小程序。

调试兼容性

在以上两步完成后,接下来我们需要调试兼容性,直到小程序能够跑起来。这里主要注意 QB 小程序和微信小程序的几点区别:

  • QB 小程序的登录态与微信小程序不互通,并且没有 unionId 概念
  • QB 小程序不支持自定义导航栏颜色
  • QB 小程序的 canvas 不支持 measureText, 意味着没有办法在 canvas 上进行文本换行
  • QB 小程序不支持下拉刷新
  • QB 小程序的 intersectionObserver 无法使用
  • QB 小程序不支持模版消息
  • QB 小程序不支持打开跳转其他小程序
  • 微信强相关的 API 都不支持

这里主要参考QQ浏览器小程序开发者文档

提交预览,在 QQ 浏览器打开

处理好了兼容性问题之后,就可以在QQ浏览器中预览小程序了。

1.首先在 QB 小程序调试工具中点击「微信扫码」 按钮,扫描微信开发者工具中预览生成的二维码,此时会进入到微信环境下的小程序,先点击右上角圆点退出小程序,返回到 QB 小程序调试工具中。 2.然后点击「启动 QB 打开小程序」按钮,在已安装好调试版 QQ 浏览器情况下,会自动跳转到 QQ 浏览器小程序环境,进入后就能看到效果。 ▲ 在 QQ 浏览器中的预览效果

3.预览没问题之后就可以上传一个体验版,输入版本号,上传成功后会有一个 url 返回,复制这个 url 到 QQ 浏览器中就能打开小程序了。

4.关于分享问题。QQ 浏览器小程序可以分享到微信朋友圈、微信好友、QQ 好友、QQ 空间,和微信小程序分享不同的是,QQ 浏览器小程序分享是创建一张分享海报,里面有 QQ 浏览器小程序二维码,在安卓手机中长按识别即可自动打开小程序。

提交审核并上线

体验版测试没问题之后,在 QB 小程序调试工具中点击「包状态管理」,进入到提交包的历史列表,点击需要提审的版本提交审核。

审核通过后即可上线发布。


本文首发于「知晓云」公众号:https://mp.weixin.qq.com/s/Joaz-CFWCVPjvZ4ovzAC5w

如果你还想了解 更多小程序开发技巧,快速掌握小程序开发能力。

欢迎扫描下方二维码关注「知晓云」,我们会持续为更新与小程序有关的实战教程哦~

暂无回复。
需要 登录 后方可回复, 如果你还没有账号请点击这里 注册