QNScaleSDK

https://github.com/yolandaqingniu/qnscalesdk
Admin
QNScaleSDK is an Android SDK for Qingniu (Yolanda) Bluetooth scales that enables device discovery,...
Tokens:4,222
Snippets:24
Trust Score:5.9
Update:4 days ago
Show doc for...
Tokens:
Raw
### 添加在线依赖

Source: https://github.com/yolandaqingniu/qnscalesdk/blob/master/README.md

在 module 的 build.gradle 文件中添加 SDK 依赖，版本号可根据需要替换。

```gradle
<!--这里的版本号，2.3.14可以指定为任意release版本-->
	<!--如果希望一直使用最新版本可以替换 2.3.14 master-SNAPSHOT -->
dependencies {
	        ...
	        compile 'com.github.YolandaQingniu:qnscalesdk:2.3.14'
	}
```

--------------------------------

### 根目录build.gradle添加jitpack仓库

Source: https://github.com/yolandaqingniu/qnscalesdk/wiki/Home

在工程根目录的build.gradle中添加jitpack仓库，用于在线依赖。

```groovy
allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}
```

--------------------------------

### module的build.gradle添加SDK依赖

Source: https://github.com/yolandaqingniu/qnscalesdk/wiki/Home

在module的build.gradle中添加依赖，版本号2.3.10可指定为任意release版本，也可使用master-SNAPSHOT获取最新版本。

```groovy
dependencies {
        ...
        compile 'com.github.YolandaQingniu:qnscalesdk:2.3.10'
}
```

--------------------------------

### 注册SDK组件（1.1.3-beta4及之后版本）

Source: https://github.com/yolandaqingniu/qnscalesdk/wiki/Home

在AndroidManifest.xml中注册SDK的service组件，适用于qnscalesdk:1.1.3-beta4及之后版本，需要添加BIND_JOB_SERVICE权限。

```xml
<!--qnscalesdk:1.1.3-beta3 之后(1.1.3-beta4开始)的版本配置-->
   <service android:name="com.qingniu.qnble.scanner.BleScanService" android:permission="android.permission.BIND_JOB_SERVICE"/>
   <service android:name="com.qingniu.scale.measure.ble.ScaleBleService" android:permission="android.permission.BIND_JOB_SERVICE"/>
   <service android:name="com.qingniu.scale.measure.broadcast.ScaleBroadcastService" android:permission="android.permission.BIND_JOB_SERVICE"/>
   <service android:name="com.qingniu.scale.wsp.ble.ScaleWspBleService" android:permission="android.permission.BIND_JOB_SERVICE" />
   <service android:name="com.qingniu.scale.measure.broadcast.ScaleFoodBroadcastService" android:permission="android.permission.BIND_JOB_SERVICE" />
```

--------------------------------

### 注册SDK组件（1.1.3-beta3及之前版本）

Source: https://github.com/yolandaqingniu/qnscalesdk/wiki/Home

在AndroidManifest.xml中注册SDK的service组件，适用于qnscalesdk:1.1.3-beta3及之前版本。

```xml
<!--qnscalesdk:1.1.3-beta3之前(包含1.1.3-beta3)的版本配置-->
  <service android:name="com.qingniu.qnble.scanner.BleScanService"/>
  <service android:name="com.qingniu.scale.measure.ble.ScaleBleService"/>
   <service android:name="com.qingniu.scale.measure.broadcast.ScaleBroadcastService"/>
```

--------------------------------

### 本地依赖：配置jniLibs目录

Source: https://github.com/yolandaqingniu/qnscalesdk/wiki/Home

在app module的gradle文件中配置sourceSets，指定jniLibs目录为libs，用于本地依赖。

```groovy
sourceSets {
        main {
            jniLibs.srcDirs = ['libs']
        }
    }
```

--------------------------------

### 混淆配置：保留BleScaleData类

Source: https://github.com/yolandaqingniu/qnscalesdk/wiki/Home

在proguard-rules文件中添加此规则，防止混淆时移除BleScaleData类。

```proguard
-keep class com.qingniu.scale.model.BleScaleData{*;}
```

--------------------------------

### AndroidManifest.xml权限声明

Source: https://github.com/yolandaqingniu/qnscalesdk/wiki/Home

在清单文件中申请蓝牙、位置、存储、网络等权限，注意不同版本对FOREGROUND_SERVICE和WAKE_LOCK权限的要求。

```xml
<!--蓝牙权限-->
   <uses-permission android:name="android.permission.BLUETOOTH" />
   <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
   <!--6.0及之后需要动态申请-->
   <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
   <!--用来存储日志-->
   <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
   <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
   <!--如果是在线的sdk需要网络权限-->
   <uses-permission android:name="android.permission.INTERNET" />
   <!--qnscalesdk:1.1.3-beta3 之前(包含1.1.3-beta3)的版本需要增加此权限，之后的版本不需要-->
   <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

   <!--qnscalesdk:1.1.3-beta3 之后(1.1.3-beta4开始)的版本需要增加此权限，之前的版本不需要-->
      <uses-permission android:name="android.permission.WAKE_LOCK" />
```
Tokens:
Raw