怎样监控手机微信小程序记录

基础使用方法

基础方法包含获取微信小程序监控SDK并初始化、上报和设置安全域名这三个步骤：

获取微信小程序监控SDK并初始化：

在微信小程序/utils目录下新建wxLogger.js文件，并将JS文件的内容复制并粘贴至新建的wxLogger.js文件中。

在/utils目录下新建monitor.js文件，并将以下内容添加至新建的monitor.js文件中以完成初始化。

说明 您可以自定义JS文件的名称和存放位置。

如果项目使用node module (require) 方式集成，则添加以下内容：

const WXLogger = require('./wxLogger.js')

const Monitor = WXLogger.init({

pid: 'xxx',

region: 'cn',// 指定应用部署的地域：中国设为cn，海外地区靠近新加坡的设为sg。

})

export default Monitor

如果项目使用ES module (import) 方式集成，则添加以下内容：

import WXLogger from './wxLogger.js'

const Monitor = WXLogger.init({

pid: 'xxx',

region: 'cn',// 指定应用部署的地域：中国设为cn，海外地区靠近新加坡的设为sg。

})

export default Monitor

说明 关于参数的详细配置，请参见通用SDK配置项。

使用以下方法静默采集PV、Error、API、性能及Health数据：

在app.js中，使用Monitor.hookApp(options)方法静默捕获Error类日志。其中的options即为App层相应的Object配置。

import Monitor from '/util/monitor'

App(Monitor.hookApp({

onError(err) {

console.log('进入onError:', err)

},

onLaunch() {

console.log('进入onLaunch')

},

onShow(options) {

},

onHide() {

}

}))

在page的JS文件中通过Monitor.hookPage(options)方法静默上报API请求、PV、Health数据。

import Monitor from '/util/monitor'

// 使用hookPage后，生命周期的API会自动打点。

Page(Monitor.hookPage({

data: {},

onLoad(query) {

},

onReady() {

// 页面加载完成。

},

onShow() {

},

onLoad(query) {

},

onHide() {

},

onUnload() {

}

}))

设置安全域名：

如果region设为cn，则将https://arms-retcode.aliyuncs.com添加到Request合法域名。

如果region设为sg，则将https://arms-retcode-sg.aliyuncs.com添加到Request合法域名。

API方法：静默打点基础API

方法 参数 备注 示例使用场景

hookApp {} 请传入原有的App参数。 在App的生命周期中自动打点。

hookPage {} 请传入原有的Page参数。 在Page的生命周期中自动打点。

说明 小程序监控项目如需使用hookApp、hookPage嵌入生命周期打点，必须符合标准小程序关于App和Page的规范，即App层有onError，Page层有onShow、onHide、onUnload。使用方法示例，请参见基础使用方法。

API方法：其他设置API

方法 参数 备注

setCommonInfo {[key: string]: string} 设置日志基础字段，可用于灰度发布等场景。

setConfig {[key: string]: string} 设置config字段，具体 *** 作，请参见SDK参考。

说明 对于setConfig方法，小程序场景不支持配置uid，您可以使用setUsername代替uid标识用户。

pageShow {} Page Show打点，发送PV数据。

pageHide {} Page Hide打点，发送Health数据。

error String/Object 错误日志打点。

api 请参见API参考 API类日志上报。

sum/avg String 自定义求和、求均值日志上报。

进阶场景

当基础使用方法无法满足需求时，请参见以下进阶场景：

手动上报API相关信息（不采用静默上报方式）：

将disableHook设为true，不静默上报wx.request请求的日志。

手动调用api()方法上报API相关信息。

取消静默上报并改为手动打点：

在App和Page对应的JS文件中不再使用hookApp、hookPage方法。

如需发送当前页面的PV数据，则在Page的onShow方法下调用pageShow()方法。

说明 请勿与hookPage()方法同时使用此方法，否则会造成PV类日志重复上报。

import Monitor from '/util/monitor'

Page({

onShow: function() {

Monitor.pageShow()

}

})

如需发送当前页面的Health类数据，统计当前页面的健康度和页面停留时间，则在Page的onHide和onUnload方法下调用pageHide()方法。

说明 请勿与 hookPage()方法同时使用此方法，否则会造成日志重复上报。

import Monitor from '/util/monitor'

Page({

onHide: function() {

Monitor.pageHide()

},

onUnload: function() {

Monitor.pageHide()

}

...

})

通用SDK配置项

ARMS前端监控提供一系列SDK配置项，让您能够通过设置参数来满足额外需求。以下是适用于本文场景的通用配置项。

参数 类型 描述 是否必选 默认值

pid String 项目唯一ID，由ARMS在创建站点时自动生成。 是 无

uid String 用户ID，用于标识访问用户，可手动配置，用于根据用户ID检索。如果不配置，则由SDK随机自动生成且每半年更新一次。 否 由SDK自动生成

tag String 传入的标记，每条日志都会携带该标记。 否 无

release String 应用版本号。建议您配置，便于查看不同版本的上报信息。 否 undefined

environment String 环境字段，取值为：prod、gray、pre、daily和local，其中：

prod表示线上环境。

gray表示灰度环境。

pre表示预发环境。

daily表示日常环境。

local表示本地环境。

否 prod

sample Integer 日志采样配置，值为1~100的整数。对性能日志和成功API日志按照1/sample的比例采样，关于性能日志和成功API日志的指标说明，请参见统计指标说明。 否 1

behavior Boolean 是否为了便于排查错误而记录报错的用户行为。 否 false

enableLinkTrace Boolean 进行前后端链路追踪，请参见使用前后端链路追踪诊断API错误原因。 否 false

ARMS前端监控还提供了更多SDK配置项，可满足进一步的需求。更多信息，请参见SDK参考。

与iOS开发很相似，小程序的导航栏也可以全局设置一下，在公共文件app.json中设置了导航栏相关样式如下：

这个地方是全局设置，如果想要在不同的页面设置各自的标题属性，只需要在该子级文件中设置

子页面想调用共公js的方法，需先在子页面js中先实例化app:具体过程如下

在需要调用的子页面中，

如果是嵌套循环，很容易出现多个list和index，例如表视图一样，所以在小程序中可以重命名 list 和index 方法为：wx:for-index='重命名' wx:for-list="重命名"

在APP开发中，UI复用是一个很好的手段，在小程序上就是模板template。

在逛小程序联盟的时候发现了一个大湿总结的比我好，搬过来一下。

微信小程序中，如果几个页面中需要引用同一个header/footer，当定义了公共模板时，有两种引用方法如下：

方法一：在公共模板中定义template元素，利用 方法 ,这种方式只会显示公共模板的template里面的内容，之外的内容不会显示

** 方法二:**

总结：import方式和imclude方式的不同在于前者仅引用公共模板中的template里面的内容后者仅引用template以外的内容，显而易见，include方式更简单一些，在wxml中只需要一句话即可。

rpx单位是微信小程序中css的尺寸单位，rpx可以根据屏幕宽度进行自适应。规定屏幕宽为750rpx。如在 iPhone6 上，屏幕宽度为375px，共有750个物理像素，则750rpx = 375px = 750物理像素，1rpx = 0.5px。

具体的 这里有一片文章介绍的很详细 ， 还有这个

小程序的事件主要有：

小程序中的wxml中绑定事件有两种：以touchtab为例 ，在wxml中必须有bind/catch不然无法实现上述事件

bindtouchtab和catchtouchtab bind的不会阻止事件冒泡（元素最里层到最外层函数执行），catch会阻止冒泡，只是冒泡到当前层结束

如果想在元素执行某事件时把元素的某个属性传到后台 可在元素中加入data-属性名称=“xxx”,在事件函数中 function(event){}的event中的currentTarget里面的data-set里面可查看接收在元素中绑定的的id或者其他属性clientX/Y 查看滑动手指距离屏幕左侧的位置，查看滑动位置也可以通过touchstart和和touchend的clientx/y获取

看到几个别人写的，瞬间石化，果断收藏。

在小程序中，定义了一项工具文件utils,此文件的js旨在本文件之内有效，当其他子页面想调用其中的js方法或者变量时，需要两步骤：

1：在utils被调用的js文件中，面向对象的方式模型输出： module.exports={要调用的函数名称：要调用的函数名称 }；

2：在要调用的js文件中模块化引入utils的js文件 var object=require("utils被调用的js文件地址")； 可以输出一下object就能看到被调用的方法了；

例子如下：

要调用的js文件：

小程序的后台获取数据方式get/post具体函数格式如下：wx.request({})

如果屏幕中某元素的内容超过此元素的高度，可设置元素为scroll-view 为滚动状态元素，这样可以做到元素固定高度且元素内容滚动屏幕不滚动的效果；

scroll-view标签的主要属性分为以下几种：

微信小程序广告轮播元素 图片所在元素/swiper-item>

其中属性有：

图片更改事件：bindchange='imgchange' imagechange()的e.detail.current为当前显示页面的下标值

注册开发者账号： https://mp.weixin.qq.com/

安装小程序开发工具：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html

创建项目

pages目录：用于存放所有的页面。

utils目录：用于存放工具类文件。

app.js：是入口文件，程序在运行时，首先要执行该文件。

app.json：是全局配置文件，用于配置小程序的信息（它里面配置的是全局信息）。

app.wxss：是全局样式文件。全局样式文件里面定义的选择器，在所有的页面中生效。

project.config.json：是项目配置文件。

sitemap.json：是SEO配置文件，方便用户搜索到该小程序。

（1）pages配置项

pages里面注册的是视图。用于指定小程序由哪些页面组成，每一项都对应一个页面的路径（含文件名）信息

（2）window配置项

window 是全局窗口配置。

backgroundTextStyle 设置文本样式（下拉loading的样式），仅支持 dark / light。

navigationBarBackgroundColor 设置导航栏背景。

navigationBarTitleText 设置导航栏文本。

navigationBarTextStyle 设置导航栏标题颜色，仅支持 black / white。

（3）style

style 设置样式级别，默认是v2。

（4）sitemapLocation

sitemapLocation 指明sitemap.json 的位置；默认为 'sitemap.json' 即在 app.json 同级目录下名字的 sitemap.json 文件。

每一个页面由四个文件组成：xxx.wxml文件、xxx.wxss文件、 xxx.js文件和xxx.json文件。

（1）xxx.wxml文件

xxx.wxml文件，就相当于一个html文件。在wxml文件中，不能写传统的html标签，只能写微信提供的组件。

① view组件

相当于div标签。

② text组件

相当于span标签。

③ swiper

swiper是滑块视图容器，它里面只能放swiper-item组件。

swiper组件的常用属性：

circular是衔接滑动

autoplay是自动切换

interval是自动切换时间间隔

indicator-dots是否显示面板指示点

indicator-color指示点颜色

indicator-active-color当前选中的指示点颜色

④ image

image是图片组件，最好全部采用网络图片，因为小程序的总体积不允许超过2MB。

（2）xxx.wxss文件

xxx.wxss文件，就相当于一个css文件。在wxss文件中，最好不要写标签选择器和id选择器，统一写类选择器。

为了让小程序里面的内容在各种设备上能够自适应显示，微信推出了响应式单位：rpx。在iphone6中，2rpx=1px。

（3）xxx.js文件

xxx.js文件，是交互文件（核心文件）。

Page()函数，返回页面对象，该函数需要传一个配置参数，这个配置参数是一个对象。在这个配置对象中，定义当前页面的所有内容。

① data

定义页面的数据。

② 自定义函数

开发者可以添加任意的函数或数据到Object 参数中，在页面的函数中用this可以访问。

（4）xxx.json文件

xxx.json文件，是页面的配置文件（它里面配置的是当前页面信息）。

WXML 中的动态数据均来自对应 Page 的 data。

（1）获取data中数据

通过插值表达式{{}}，可以显示js里面定义的data里面的数据。

（2）组件属性(需要在双引号之内)

（3）运算

可以在{{}} 内进行简单的运算。

① 三元运算

② 逻辑判断

bindtap是触屏事件，其实就是相当于网页中的点击事件。

小程序中bindtap绑定方法时不能传参数。所以组件通过data-xxx传递数据。

注意： 自定义属性的命名用驼峰或者大写命名，小程序内部会自动转成小写。

8、setData()方法

setData()方法，更新页面中数据。页面数据更新后，调用setData()方法重新渲染到页面。

wx:for指令用于循环数组数据，生成组件。

循环出来的每一项通过item返回，每一项对应的索引，通过index返回。

wx:key=""，设置每一项唯一的标识。循环列表时，添加wx:key的好处是，将来列表发生变化时重新渲染列表的损耗为更低。

条件渲染可以使用wx:if或hidden。

一般来说，wx:if 有更高的切换消耗而 hidden 有更高的初始渲染消耗。因此，如果需要频繁切换的情景下，用 hidden 更好，如果在运行时条件不大可能改变则 wx:if 较好。

wx:if用于条件渲染：条件为真生成里面的内容，条件为假不会生成里面的内容。（每次重新生成内容）

也可以用wx:elif 和 wx:else 来添加一个 else 块。

hidden用于条件渲染：条件为真隐藏里面的内容，条件为假显示里面的内容。（每次切换样式）

在app.json文件中添加tabBar节点。tabBar是小程序客户端底部或顶部tab栏的实现。

color：tab上的文字默认颜色，仅支持十六进制颜色。

selectedColor：tab上的文字选中时的颜色，仅支持十六进制颜色。

backgroundColor：tab的背景色，仅支持十六进制颜色。

borderStyle：tabbar上边框的颜色， 仅支持 black / white。

position：tabBar的位置，默认值是: bottom，仅支持 bottom / top。当 position 为 top 时，不显示 icon。

custom：自定义tabBar。

（2）list

list：tab的列表。

list 接受一个数组，只能配置最少 2 个、最多 5 个 tab。

pagePath：页面路径，必须在pages 中先定义。

text：tab 上按钮文字。

iconPath：图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，不支持网络图片。selectedIconPath：选中时的图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，不支持网络图片。

（1）跳转普通页面

方法① navigator组件

方法② navigateTo()方法

navigateTo()方法，用于跳转普通页面。

（2）跳转tabBar页面

方法① navigator组件

如果要使用navigator组件跳转tabBar页面，需要设置open-type="switchTab"。

方法② switchTab()方法

switchTab()方法，用于跳转tabBar页面。

title：提示的标题

content：提示的内容

success：接口调用成功的回调函数。回调函数中的confirm属性返回true，表示点击的是确定按钮，否则是取消按钮。

title：提示的内容

icon：图标

duration：消息提示框的显示时间

mask：是否显示透明蒙层，防止触摸穿透

模块化语法有两种：① commonjs规范，② es6规范。

nodejs环境采用的就是commonjs规范。采用exports 或 module.exports 导出成员，采用require() 导入成员。

微信小程序支持commonjs规范，同时还支持官方的ES6规范。ES6规范采用export 导出成员，采用import 导入成员。

将封装的方法放到util目录下的js文件中。可以新建js文件，也可以写在直接util.js文件中。

（1）确认框方法

定义确认框方法，并导出

（2）消息框方法

定义消息框方法，并导出

（3）获取事件参数的方法

import是ES6的导入语句。

wx对象是微信小程序的全局对象，在任何地方都可以使用。

（1） 注册语句

（2） 在app.js入口文件中导入

注意： 注册给wx对象的方法，需要在app.js文件中导入，才可使用。

（3） 调用方法

wx.方法名(参数)

---