# 前言说明
EXE版本信息需要到[比邻云官网](https://www.bilnn.com)去上传，此处只是windows sdk的使用说明
SDK已包含应用更新、异常上报、运营统计功能
# SDK下载
前往官网SDK下载页面下载SDK
https://www.bilnn.com/documentation#sdk
# 引用SDK
下载SDK后将得到四个文件
BilnnUpdate.dll SDK核心文件，负责数据获取
Update.exe SDK核心文件，负责处理升级
Test.exe SDK引用示例
Test.e SDK引用示例源码
# 集成SDK
1.首先将BilnnUpdate.dll和Update.exe放在您项目的根目录
2.将BilnnUpdate.dll引用进项目主程序
3.调用dll命令进行配置
最简化调用示例
```
initState ＝ BilnnSdkInit ("appid", "appkey", 1) ' 比邻云SDK初始化，返回真或假
BilnnSdkCkVer () ' 检查更新，使用默认弹窗，返回假不需要更新，真需要更新
需要更新时dll会自动调用相同目录下的Update.exe进行更新，并结束当前程序
更新包会下载到同目录下，文件名为：bilSetup.exe
下载成功后会自动运行bilSetup.exe
开发者需要在上传exe时做好更新处理，例如做成自解压exe，运行就自动解压覆盖文件，完成更新
```
# DLL命令列表
```
比邻云SDK初始化，返回真为初始化成功，假为失败，部分win7系统因SSL问题，可能需要再次启动才能初始化成功（必选）
DLL命令 BilnnSdkInit
返回类型：逻辑型
入参：
.参数 appid, 文本型, , appid
.参数 appsecret, 文本型, , appsecret
.参数 vercode, 整数型, , 当前版本号，大于0的整数
获取错误详情，查看最后一次错误的文本信息（可选）
DLL命令 BilnnSdkErr
返回类型：文本型
检查更新，默认弹窗自动更新，返回真需要更新（BilnnSdkCkVer、BilnnSdkCkVerCallBack二选一）
DLL命令 BilnnSdkCkVer
返回类型：逻辑型
检查更新，获取更新文本，自行实现弹窗显示，将更新文本原样传给BilnnSdkUpgrade实现更新（BilnnSdkCkVer、BilnnSdkCkVerCallBack二选一）
返回类型：文本型
json更新文本，示例：{"appName":"测试","appid":"21cde036dfcb0f2e","content":"123","ctime":"2023-04-17 17:00:45","device":"3","types":"1","url":"kqjRmkytIJCYMlgIsROCdGKFOv_AkxJyHVXp7n21C2P1vEV-HpGudCMYqPrkLeGxd85qiPmjlXzXovglfmkHSedL8x8Uj1lOaLVX9iJ0PEJKEtO4GPLHX67CKp7hMTVXCa8uhDGGLOqgphYV4c-urg**","vercode":"5","version":"v5","versize":"6726"}
appName： 应用名称
appid： 应用appid
content： 更新内容
ctime： 发布时间
device： 设备类型，1安卓 2ios 3windows
types： 更新类型，1推荐，2强制
url： 下载地址
vercode： 最新版本号
version： 最新版本名称
versize： 更新包大小（KB）
调用更新，自己实现弹窗时，根据返回types决定是否更新（BilnnSdkCkVerCallBack时必选）
DLL命令 BilnnSdkUpgrade
入参：
.参数 updateInfo, 文本型, , BilnnSdkCkVerCallBack获取的json文本，原样传
设置异常错误文本，方便定位（可选）
DLL命令 BilnnSdkSetCrash
入参：
.参数 CrashText, 文本型, , 错误文本，长度50，用于显示具体错误位置信息
```
### **具体调用详见SDK内示例**
