1.1.0 • Published 4 years ago
rykx_ads_sdk v1.1.0
开发
- 安装依赖:
npm install
- 执行命令:
npm run dev
默认会在包根目录下生成 miniprogram_dev 目录,src 中的源代码会被构建并生成到 miniprogram_dev/components 目录下。如果需要监听文件变化动态构建,则可以执行命令:
npm run watch
ps: 如果 minirpogram_dev 目录下已存在小程序 demo,执行
npm run dev
则不会再将 tools 下的 demo 拷贝到此目录下。而执行npm run watch
则会监听 tools 目录下的 demo 变动并进行拷贝。
生成的 miniprogram_dev 目录是一个小程序项目目录,以此目录作为小程序项目目录在开发者工具中打开即可查看自定义组件被使用的效果。
进阶:
- 如果有额外的构建需求,可自行修改 tools 目录中的构建脚本。
- 内置支持 webpack、less 语法、sourcemap 等功能,默认关闭。如若需要可以自行修改 tools/config.js 配置文件中相关配置。
- 内置支持多入口构建,如若需要可自行调整 tools/config.js 配置文件的 entry 字段。
- 默认开启 eslint,可自行调整规则或在 tools/config.js 中注释掉 eslint-loader 行来关闭此功能。
目录结构
以下为推荐使用的目录结构,如果有必要开发者也可以自行做一些调整:
|--miniprogram_dev // 开发环境构建目录
|--miniprogram_dist // 生产环境构建目录
|--src // 源码
| |--components // 通用自定义组件
| |--images // 图片资源
| |
| |--xxx.js/xxx.wxml/xxx.json/xxx.wxss // 暴露的 js 模块/自定义组件入口文件
|
|--test // 测试用例
|--tools // 构建相关代码
| |--demo // demo 小程序目录,开发环境下会被拷贝生成到 miniprogram_dev 目录中
| |--config.js // 构建相关配置文件
|
|--gulpfile.js
PS:对外暴露的 js 模块/自定义组件请放在 src 目录下,不宜放置在过深的目录。另外新增的暴露模块需要在 tools/config.js 的 entry 字段中补充,不然不会进行构建。
测试
- 执行测试用例:
npm run test
- 执行测试用例并进入 node inspect 调试:
npm run test-debug
- 检测覆盖率:
npm run coverage
测试用例放在 test 目录下,使用 miniprogram-simulate 工具集进行测试,点击此处查看使用方法。在测试中可能需要变更或调整工具集中的一些方法,可在 test/utils 下自行实现。
其他命令
- 清空 miniprogram_dist 目录:
npm run clean
- 清空 miniprogam_dev 目录:
npm run clean-dev
广告投放SDK使用步骤
- 安装广告组件
npm install rykx_ads_sdk@^1.0.8 --save
小程序开发工具中执行:工具->构建npm
小程序引入广告组件
"usingComponents": {
"rykx-ads-box": "/miniprogram_npm/rykx_ads_sdk/index"
}
- 使用广告组件
<rykx-ads-box mediaId="m000000000001" appKey="b5dd10b9ec62432499470deee50c2f28" locationType="1"></rykx-ads-box>
- 组件参数
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
mediaId | String | 是 | 第三方媒体标识 |
appKey | String | 是 | 第三方媒体接口调用秘钥,系统分配 |
userId | String | 是 | 用户唯一标识 |
userType | String | 是 | 用户唯一标识类型,phone:手机号,id_card_no:省份证号,open_id:微信小程序用户标识,system_id:小程序系统用户标识 |
locationType | Number | 否 | 广告位类型, 1-信息流(默认),2-详情页 |
screenId | String | 否 | 屏幕标识 |
province | String | 否 | 用户所在省份 |
city | String | 否 | 用户所以地区 |
userInfo | object | 否 | 用户扩展信息 |
clientInfo | object | 否 | 终端扩展信息 |
- 用户扩展信息字段说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
userId | String | 否 | 用户唯一标识 |
userName | String | 否 | 用户名称 |
userOpenId | String | 否 | 用户小程序唯一标识 |
userPhone | String | 否 | 用户手机号 |
idCardNo | String | 否 | 用户身份证号 |
birthday | String | 否 | 用户生日 |
userWeight | String | 否 | 用户体重 |
userHeight | String | 否 | 用户生日 |
userGender | String | 否 | 用户性别 |
userAge | String | 否 | 用户年龄 |
userInterestTags | String | 否 | 用户兴趣标签,以逗号“,”分隔 |
- 终端扩展信息字段说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
phoneSys | String | 否 | 手机系统 |
phoneBrand | String | 否 | 手机品牌 |
networkType | String | 否 | 网络类型 |