# WX-Mini-Program-BX-OTA

**Repository Path**: bluexmicro/wx-mini-program-bx-ota

## Basic Information

- **Project Name**: WX-Mini-Program-BX-OTA
- **Description**: BXOTA（微信小程序）
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2022-07-09
- **Last Updated**: 2023-11-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BX-OTA-Library
这是BlueXMicro OTA 小程序端的SDK源码和Demo

## 导入
复制OTA目录到宿主工程下即可(如图1所示的OTA目录)
> ![figure1](https://gitee.com/bluexmicro/wx-mini-program-bx-ota/raw/master/image/figure1.png)

## 使用步骤
1. import
2. 准备参数（目标设备id、固件“微信文件对象”）
3. 开始OTA

### 简单例程，详情请参考Demo工程
```javascript
import {
  startFastOta,
  startOta
} from "../../ota/bx_ota.js" //这里要注意正确填写OTA目录在宿主工程的路径

Page({
  data:{
    faseMode:false
    deviceId:"FF:FF:FF:FF:FF:FF"//替换成目标设备的（Android）MAC地址或者（IOS）UUID
    tasks:[]//task:{wxFile,hexaddress?}
  },
  onStartOtaTap:function(){
    if (this.data.fastMode) {
      startFastOta(this.data.deviceId, this.data.otaTasks,this.onStateChanged,this.onFinish)
    }else{
      //只能单任务，注意越界的判断
      startOta(this.data.deviceId, this.data.otaTasks[0],this.onStateChanged,this.onFinish)
    }
  },
  onStateChanged:function(state){
    let index = state.index //对应任务的下标
    let startTime = state.startTime //当前任务开始的时间
    let endTime = state.endTime //当前任务结束的时间
    let progress = state.progress //当前任务的进度
    let errorMsg = state.errorMessage //当前任务失败的信息
  },
  onFinish:function(res){
      if(res.result){
        //成功，但不代表所有任务都成功
      }else{
        //失败，任务因异常未开始
        res.error
      }
  }
})
```