更新记录

v1.0.2020.10.26（2020-10-26）

添加iOS版插件，修改插件使用说明文档。 下一版本目标：可定制内部单元文字颜色，大小，是否开启跑马灯。圆点颜色，描述颜色等。

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

插件使用说明：

一、范例数据

[ { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":1 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":2 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":3 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":4 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":5 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":1 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":2 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":3 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":4 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":5 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":1 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":1 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":1 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":3 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":4 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":5 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":1 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":2 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":3 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":4 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":3 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":4 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":5 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":1 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":2 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":3 }, { "nick":"胡小明", "pop":50, "desc":"这是描述", "status":4 } ]

二、字段说明

{"nick":"胡小明","pop":50,"desc":"这是描述","status":1}
nick：昵称
pop：匹配度
desc：描述
status：状态（1-描述：最活跃，圆点颜色0xFFFFFF，2-描述：最匹配，圆点颜色0x58B4AC，3-描述：最新人，圆点颜色0x9485D8，4-描述：用desc字段（男生），圆点颜色：0xC1F1F2，5-描述：desc字段（女生），圆点颜色：0xFBD8D8）

组件中提供data字段，内容为String，内部将直接解析为JSON数组。因此你的data数组应该是[{"nick":"胡小明","pop":50,"desc":"这是描述","status":1},...]

提供点击回调事件，onItemClick，且detail参数为被点击数据在list中的位置。

提供错误回调时间，onError，当json错误时会告诉具体原因。

## 三、调用代码
nvue文件中，组件调用代码
```markdown
<SoulPlanetView :data="你自己的soul数据，可直接使用一的范例数据" style="background-color: #000000; height: 500rpx; width: 500rpx;" @onError="onError" @onItemClick="onItemClick"/>

js事件代码

//错误回调事件
onError(ret) {
    console.log('错误回调事件', ret)
},
onItemClick(ret) {
    console.log('点击事件回调', ret)
}