/weapp-doc

小程序配置指引、升级方案

OtherNOASSERTION

小程序初始化配置指引

假如您已成功创建了小程序资源,需要对现有的资源进行一些简单配置后,才能让小程序跑起来

未创建过资源的用户可以先在小程序控制台进行创建

1.配置微信小程序通信域名

首先我们在小程序资源视图中将二级域名拷贝下来,在后面的几个流程中都会用到。

小程序资源视图

然后前往微信公众平台 -【开发】-【基本配置】-【服务器配置】-【修改配置】,使用二级域名完成通信域名设置,设置完后可能需要稍等几分钟重启微信开发者工具生效。

微信域名配置

  • request合法域名:填腾讯云分配的二级域名
  • socket合法域名:填腾讯云分配的 Socket 域名,如 12345678.ws.qcloud.la
  • uploadFile合法域名:填腾讯云分配的二级域名
  • downloadFile合法域名:填腾讯云分配的二级域名

2.修改业务服务器配置

如果开发语言环境是CentOS操作系统,创建资源时已默认下发好配置到/etc/qcloud/sdk.config,可略过此步

登录云服务器的密码请在站内信、手机短信、邮箱中查看

Windows Server系统修改c://qcloudsdk.config文件

{
    "serverHost": "xxxx.qcloud.la", //资源视图给出的二级域名
    "authServerUrl": "http://内网IP/mina_auth/", //内网IP改成会话管理服务器的内网IP
    "tunnelServerUrl": "https://xxxx.ws.qcloud.la", //不用修改
    "tunnelSignatureKey": "62aaa14292b3a65a61c14b8c30437bc648e087b2", //填写一份随机字符
    "networkTimeout": "30000"
}

修改完成后,需要重启 IIS 中的网站来生效。

3.下载微信小程序 Demo 和 SDK

  1. 前往github将 Demo 下载到本地

  2. 修改 Demo 根目录下的 config.js 配置文件里主机配置

var host = 'www.qcloud.la'; //host替换成微信小程序资源视图中分配的二级域名

var config = {
    service: {
        host,
        loginUrl: `https://${host}/login`,
        tunnelUrl: `https://${host}/tunnel`
    }
};

module.exports = config;
  1. 微信开发者工具导入 Demo 工程目录,然后点击调试即可打开聊天室 Demo 开始体验

开发者工具下载地址:windows 64windows 32mac

小程序Demo

4.升级方案

如果现有的配置满足不了您的业务需求,我们提供了单机版架构升级集群版架构扩容来对现有资源进行配置升级、扩容。

常见问题

微信 AppId 和 AppSecret 在购买时填写错误怎么办

如果在购买解决方案时,把 AppId 和 AppSecret 填写错误。小程序用户在登录时,便会返回错误码40029,错误信息MA_WEIXIN_CODE_ERR。此时便需要手动修改 AppId 和 AppSecret

修改步骤如下:

  1. 登录会话管理服务器,进入/opt/lampp/htdocs/mina_auth/system/db/目录,查看db.ini文件,文件中保存着 云数据库 CDB 的ip、port、username、passwd以及 dbname 等信息。

1.1) 进入CDB配置文件目录

 cd /opt/lampp/htdocs/mina_auth/system/db/

1.2) 查看服务器配置文件

 vi db.ini
  1. 拿到这些信息以后,登录云数据库 CDB,修改 cAppinfo 表中的 AppId 和 secretKey 即可。

2.1)进入安装mysql命令的目录

cd /opt/lampp/bin/

2.2)连接CDB

./mysql -h #ip -P #port -u #username -p #passwd(其中#ip、#port、#username、#passwd是在1.2步骤中查看到的具体信息)

2.3)更新AppId 和 AppSecret

use cAuth;//选中数据库。

update cAppinfo set appid = "your appid",secret = "your secret";//更新正确的AppId 和 AppSecret

创建资源时填的AppID和AppSecret在哪找到?

要查看 AppID,请前往微信公众平台 -【选择设置】- 开发者设置】在开发者ID一栏中可以看到。AppSecret 是小程序私有密钥,微信不再保存,无法查看,只能重置。重置后请妥善保管,并参考上面的流程修改 Wafer 服务中保管的版本。

一站式构建小程序分配的CVM/CDB密码哪里获取?

分配的服务器及数据库资源的密码请在站内信、手机短信、邮箱中可以获取到

重装开发语言环境

目前业务服务器提供了PHP、Node.js、Java、.NET版本的语言环境,用户如果要切换需要做以下操作:

  1. 备份配置文件

sdk.config从服务器拷贝到本地、CentOS系统在/etc/qcloud路径下,Windows Server系统在c://qcloud路径下

  1. 重装系统

如有重要数据请提前保存好

首先需要登录腾讯云CVM控制台,在会话管理CVM实例右侧操作栏,点击【更多】-【重装系统】。

弹出框内镜像来源选服务市场,镜像选基础环境,下拉列表中找到四个语言的镜像来选中镜像,设置好系统密码后点开始重装

重选系统镜像

  1. 上传配置文件

系统重装好后将步骤1中保存下来的sdk.config上传至服务器上,CentOS系统在/etc/qcloud路径下,Windows Server系统在c://qcloud路径下

  1. 重启服务
  • Node.js环境进入/data/release/node-weapp-demo下执行pm2 start process.json
  • .NET环境需要重启 IIS 中的网站来生效配置
  • Java环境重启tomcat执行命令systemctl restart tomcat