# 校园设备APP部署
[TOC]

**本页面仅用作展示校园类APP版本信息及部分adb命令行的使用方式，具体部署方式均以部署工具为准**

## 部署工具
**校园类APP部署工作，请使用部署工具进行，今后将不再直接提供校园类APP的下载链接**  
更新日志：2020-8-5  
下载地址：http://update.i-school.net/zxedu-system-images/CampusDeployTool.7z  

#### 问题及解决方案：
1. 启动部署工具后，提示adb server version doesn't match the client，导致刷新设备列表无法找到设备  
方案：将电脑的adb命令更新到41版本，win下载链接：http://release-android.i-school.net/archive/platform-tools_r30.0.3-windows.zip  



<del>## 签名

**Launcher与APP均需要进行系统签名，文档中默认提供 `rk3368` 的签名版适用于大部分设备。若由于不兼容导致无法安装，请使用文档中提供的未签名版本，并向厂家索要系统key自行签名。**  
**海康专版不需要进行签名，直接下载安装。**

### Key

需要向厂家索要 `platform.x509.pem`,   `platform.pk8`, `signapk.jar` 三个文件。

### 签名方法

命令行执行：
`java -jar signapk.jar platform.x509.pem platform.pk8 unsigned_apk_file signed_apk_file`

**注: `unsigned_apk_file` 使用未签名安装包名替换； `signed_apk_file` 使用想要输出的已签名文件名替换**

## Launcher安装

### 最新版本：1.3

* rk3368/rk3288签名版
* 未签名版
* 海康威视专版
* 誉鼎专版

### 安装方式

依次执行下令命令

**注：步骤1中的 `apk_file` 需要使用实际的已签名APK文件名替代**

1. `adb install apk_file`
2. 进入设置将校园启动器设置为设备默认启动器
3. 安装需要部署的实际软件（电子班牌、校园安全控制台、etc.）
4. `adb reboot`


## APP安装

### 安装方式

执行以下命令完成安装

`adb install apk_file`

**注：`apk_file` 需要使用实际的已签名APK文件名替代**

### 初始化CMDB ID

当成功安装Launcher及APP后，Launcher会自动启动APP，进入到APP初始化页面，需要输入CMDB ID以进行初始化。

可以使用以下两种方式对设备进行初始化

* 手动方式：在初始化页面手动操作
* 自动方式：
  * 有校园服务器
    * 执行 `adb shell am broadcast -a net.ischool.isus.cmdbid  --es cmdb_id "XXX" -n com.zxedu.classcard/net.ischool.isus.broadcast.CMDBReceiver` 
    * 示例：`adb shell am broadcast -a net.ischool.isus.cmdbid  --es cmdb_id "148" -n com.zxedu.classcard/net.ischool.isus.broadcast.CMDBReceiver`
  * 无校园服务器
    * 执行 `adb shell am broadcast -a net.ischool.isus.cmdbid  --es cmdb_id "${cmdb_id}_${school_id}_${pass_code}" -n com.zxedu.classcard/net.ischool.isus.broadcast.CMDBReceiver`
    * 示例：`adb shell am broadcast -a net.ischool.isus.cmdbid  --es cmdb_id "148_1115333_faa894796e" -n com.zxedu.classcard/net.ischool.isus.broadcast.CMDBReceiver`

**注：若APP安装成功后，未自动启动，在确保正确安装并配置了Launcher后，执行`adb shell am start -n com.zxedu.launcher/net.ischool.launcher.HomeActivity`。**

### 更新CMDB ID

**前置条件：保证APP在运行状态下。**

* 有校园服务器：执行 `adb shell am broadcast -a net.ischool.isus.cmdbid  --es cmdb_id "XXX" -n com.zxedu.classcard/net.ischool.isus.broadcast.CMDBReceiver`。
* 无校园服务器：执行 `adb shell am broadcast -a net.ischool.isus.cmdbid  --es cmdb_id "${cmdb_id}_${school_id}_${pass_code}" -n com.zxedu.classcard/net.ischool.isus.broadcast.CMDBReceiver`


### 全量同步用户信息

**前置条件：设备已正确完成初始化。**

执行：`adb shell am broadcast -a net.ischool.isus.sync -n com.zxedu.swipe/net.ischool.isus.broadcast.UserSyncReceiver`

成功执行命令后，应用会进入到同步页面，进度条显示当前同步进度，同步完毕后，该页自动退出。
</del>

### Launcher
由于海康设备需要先安装Launcher才可开启ADB功能，因此提供海康版Launcher下载地址：  
http://release-android.i-school.net/archive/launcher/campus_launcher_1.3_hikvision.apk  
其余设备仍需要使用部署工具直接进行安装

### 校园安全控制台

## 重要事项：由于身份证读卡器问题，项目在6.0+设备上运行，会导致无法读取身份证照片信息，目前无解决方案；需要读取身份证功能的学校，必须使用5.1系统的设备 ##

<markdown>
| 渠道 | 版本 | 版本号 | 发布日期 | 适配设备 | 适配读卡器 | 说明 | 
| --- | --- | --- | --- | --- | --- | --- | --- |  
| 爱上学 | 未签名 | 1.3.9 | 2020-07-15 | 触沃 | 模拟键盘；华大；因纳伟盛；海康威视；世纪凯城串口|  
| 爱上学 | rk3368_rk3288_Android5.1 |1.3.9|2020-07-15|触沃|模拟键盘；华大；因纳伟盛；海康威视；世纪凯城串口|  
| 爱上学 | 海康威视专版 | 1.3.9 | 2020-07-15 | 海康威视 | 模拟键盘；华大；因纳伟盛；海康威视；世纪凯城串口|  
| 爱上学 | Pad专版 | 1.3.9 | 2020-07-15 | Pad | NA |  
| 和教育 | 未签名|1.2.8|2019-09-26|触沃|模拟键盘；华大；因纳伟盛|  
| 和教育 | rk3368_rk3288_Android5.1 |1.2.8|2019-09-26|触沃|模拟键盘；华大；因纳伟盛|  
| 云校通 | 未签名|1.2.8|2019-09-26|触沃|模拟键盘；华大；因纳伟盛|  
| 云校通 | rk3368_rk3288_And roid5.1 |1.2.8|2019-09-26|触沃|模拟键盘；华大；因纳伟盛|  
| 紫岩书院 | 未签名|1.2.8|2019-09-26|触沃|模拟键盘；华大；因纳伟盛|  
| 紫岩书院 | rk3368_rk3288_Android5.1 |1.2.8|2019-09-26|触沃|模拟键盘；华大；因纳伟盛|  
| 和教育(四川) | 未签名|1.3.3|2019-11-15| 触沃 | 模拟键盘；华大；因纳伟盛；海康威视；世纪凯城串口|  
| 和教育(四川) | rk3368_rk3288_Android5.1 |1.3.3|2019-11-15| 触沃 | 模拟键盘；华大；因纳伟盛；海康威视；世纪凯城串口|  
| 和教育(四川) | 海康威视专版 | 1.3.3 | 2019-11-15 | 海康威视 | 模拟键盘；华大；因纳伟盛；海康威视；世纪凯城串口|  
| 和教育(四川) | Pad专版 | 1.3.3 | 2019-11-15 | Pad | NA |  
| 内江 | 未签名 | 1.3.5 | 2019-12-30 | 触沃 | 模拟键盘；华大；因纳伟盛；海康威视；世纪凯城串口|  
| 内江 | rk3368_rk3288_Android5.1 |1.3.5|2019-12-30|触沃|模拟键盘；华大；因纳伟盛；海康威视；世纪凯城串口|  
| 内江 | 海康威视专版 | 1.3.5 | 2019-12-30 | 海康威视 | 模拟键盘；华大；因纳伟盛；海康威视；世纪凯城串口|  
| 内江 | Pad专版 | 1.3.5 | 2019-12-30 | Pad | NA |  


</markdown>

### 电子班牌

##!!2.0.2增加首页班级信息自动更细功能（每分钟自动更新）!！##

##!!2.0.1及以上版本，与19年海康设备存在人脸兼容性问题!!##
由于20年的海康设备，内置的检测方案作了升级，导致APP必须要对应升级SDK，新版本的SDK与19年的海康设备不兼容，因此需要手动升级19年海康设备的服务程序。  

### 如果测试人脸登录过程中，遇到一下情况其一，则需要升级服务程序###
1. 提示：人脸抓拍失败：错误码  
2. 无法识别人脸，人脸周围没有显示绿框  

### 升级方式 ###
1. 下载海康提供的20年最新的服务程序，地址：http://release-android.i-school.net/archive/vender/hikvision/FACE_SDK-20200509.apk  
2. 将下载好的APK安装至设备（adb install -r xxx.apk）  

##!!1.2.5及以上版本，需要同步升级Launcher到1.3及以上版本!!##

####1.2.5及以上版本，首页数据更新频率说明####  
  - 通知：每分钟更新一次，如果更新失败，会进行三次重试，每次重试间隔10秒
  - 班级相册：每分钟更新一次，如果更新失败，会进行三次重试，每次重试间隔10秒
  - 天气预报：每30分钟更新一次，如果更新失败，会进行三次重试，重试间隔分别为：8秒，64秒，512秒；启动APP时，会存在0-5分钟随机延迟更新，避免CDN服务器缓存问题（即启动后最长5分钟之内，可能会无法显示天气预报数据）
  - 底部入口菜单：每分钟更新一次，如果更新失败，会进行三次重试，每次重试间隔10秒；当首页从不可见变为可见时（即从其他页面回到首页），会尝试更新一次。

<markdown>
渠道|版本|版本号|发布日期|适配设备|适配读卡器|说明  
---|---|---|---|---|---|---|---  
爱上学| 未签名 |1.2.5|2020-07-17|触沃|模拟键盘；华大；绵竹串口；纵横六合USBM1；海康威视；世纪凯城串口|  
爱上学| rk3368_rk3288_Android5.1_Android7.1 |1.2.5|2020-07-17|触沃|模拟键盘；华大；绵竹串口；纵横六合USBM1；海康威视；世纪凯城串口|  
爱上学| 海康威视专版 |1.2.5|2020-07-17|海康威视|模拟键盘；华大；绵竹串口；纵横六合USBM1；海康威视；世纪凯城串口|  
爱上学| 誉鼎专版 |1.2.3|2020-06-09|誉鼎46寸大屏|模拟键盘；华大；绵竹串口；纵横六合USBM1；海康威视；世纪凯城串口|  
和教育|未签名|1.0.9||2019-09-25|触沃|模拟键盘；华大；绵竹串口；纵横六合USBM1|  
和教育| rk3368_rk3288_Android5.1_Android7.1 |1.0.9||2019-09-25|触沃|模拟键盘；华大；绵竹串口；纵横六合USBM1|  
云校通|未签名|1.0.9||2019-09-25|触沃|模拟键盘；华大；绵竹串口；纵横六合USBM1|  
云校通| rk3368_rk3288_Android5.1_Android7.1 |1.0.9||2019-09-25|触沃|模拟键盘；华大；绵竹串口；纵横六合USBM1|  
紫岩书院|未签名|1.0.9||2019-09-25|触沃|模拟键盘；华大；绵竹串口；纵横六合USBM1|  
紫岩书院| rk3368_rk3288_Android5.1_Android7.1 |1.0.9||2019-09-25|触沃|模拟键盘；华大；绵竹串口；纵横六合USBM1|  
内江| 未签名 |1.1.8|2019-12-30|触沃|模拟键盘；华大；绵竹串口；纵横六合USBM1；海康威视；世纪凯城串口|  
内江| rk3368_rk3288_Android5.1_Android7.1 |1.1.8|2019-12-30|触沃|模拟键盘；华大；绵竹串口；纵横六合USBM1；海康威视；世纪凯城串口|  
内江| 海康威视专版 |1.1.8|2019-12-30|海康威视|模拟键盘；华大；绵竹串口；纵横六合USBM1；海康威视；世纪凯城串口|  

</markdown>

### IC刷卡考勤

## 该项目由于无CDN服务器部署在学校，直接访问公网，所以设备本身就充当CDN服务器接收RabbitMQ下发的数据。需要在CMDB后台首页，开启 **启用CDN服务器** 设置，否则无法正常收到远程推送的相关信息。

## ！！！旧版本升级到1.1.7或之后的版本，升级后需要清除APP数据，进行重新配置！！！
## ！！！遇到问题，首先查日志，日志路径：192.168.1.10:/home/ftp/logs/ischool/eqpt-swipe/info.log！！！
## ！！！绑定的通道方向，需要使用 “基于时间”！！！

<markdown>
渠道|版本|版本号|发布日期|适配设备|适配读卡器|下载链接|说明  
---|---|---|---|---|---|---|---  
爱上学-学生|未签名|1.1.9|2020-07-20|触沃，天波|纵横六合串口；木兰串口；华大IC；模拟键盘；海康威视；世纪凯城串口|  
爱上学-学生| rk3368_rk3288_Android5.1_Android7.1 |1.1.9|2020-07-20|触沃，天波|纵横六合串口；木兰串口；华大IC；模拟键盘；海康威视；世纪凯城串口|  
爱上学-学生| 海康威视专版 |1.1.9|2020-07-20|海康威视|纵横六合串口；木兰串口；华大IC；模拟键盘；海康威视；世纪凯城串口|  
爱上学-教师|未签名|1.1.9|2020-07-20|触沃，天波|纵横六合串口；木兰串口；华大IC；模拟键盘；海康威视；世纪凯城串口|  
爱上学-教师| rk3368_rk3288_Android5.1_Android7.1 |1.1.9|2020-07-20|触沃，天波|纵横六合串口；木兰串口；华大IC；模拟键盘；海康威视；世纪凯城串口|  
爱上学-教师| 海康威视专版 |1.1.9|2020-07-20|海康威视|纵横六合串口；木兰串口；华大IC；模拟键盘；海康威视；世纪凯城串口|  
内江-学生|未签名|1.1.6|2019-11-20|触沃，天波|纵横六合串口；木兰串口；华大IC；模拟键盘；海康威视；世纪凯城串口|  
内江-学生| rk3368_rk3288_Android5.1_Android7.1 |1.1.6|2019-11-20|触沃，天波|纵横六合串口；木兰串口；华大IC；模拟键盘；海康威视；世纪凯城串口|  
内江-学生| 海康威视专版 |1.1.6|2019-11-20|海康威视|纵横六合串口；木兰串口；华大IC；模拟键盘；海康威视；世纪凯城串口|  
内江-教师|未签名|1.1.6|2019-11-20|触沃，天波|纵横六合串口；木兰串口；华大IC；模拟键盘；海康威视；世纪凯城串口|  
内江-教师| rk3368_rk3288_Android5.1_Android7.1 |1.1.6|2019-11-20|触沃，天波|纵横六合串口；木兰串口；华大IC；模拟键盘；海康威视；世纪凯城串口|  
内江-教师| 海康威视专版 |1.1.6|2019-11-20|海康威视|纵横六合串口；木兰串口；华大IC；模拟键盘；海康威视；世纪凯城串口|  
</markdown>

### 可视电话
<markdown>
渠道|版本|版本号|发布日期|适配设备|适配读卡器|下载链接|说明  
---|---|---|---|---|---|---|---  
爱上学|未签名|0.94|2019-09-26|触沃|UDP推送|http://release-android.i-school.net/archive/ischool/dev/ischool_vision_0.94.apk|  
爱上学|rk3368_rk3328_Android5.1_Android7.1|0.94|2019-09-26|触沃|UDP推送|http://release-android.i-school.net/archive/ischool/dev/ischool_vision_0.94_rk3368_3328.apk|  
紫岩书院|未签名|0.94|2019-09-26|触沃|UDP推送|http://release-android.i-school.net/archive/zysy/dev/zysy_vision_0.94.apk|  
紫岩书院|rk3368_rk3328_Android5.1_Android7.1|0.94|2019-09-26|触沃|UDP推送|http://release-android.i-school.net/archive/zysy/dev/zysy_vision_0.94_rk3368_3328.apk|  
</markdown>

### 校园电话助手
<markdown>
渠道|版本号|发布日期|下载链接|说明  
---|---|---|---|---
紫岩书院|0.6|2019-09-10|http://release-android.i-school.net/archive/zysy/dev/zysy_school_helper_0.6.apk  
</markdown>


### 海康设备部署助手
<markdown>
渠道|版本号|发布日期|下载链接|说明  
---|---|---|---|---
-|1.0|2019-11-18|http://release-android.i-school.net/archive/ischool/dev/hikvision_demo.apk  
-|1.0|2019-11-18|http://release-android.i-school.net/archive/ischool/dev/ischool_billboard_1.1.4_tmp.apk  
</markdown>

### 大华设备设置升级软件
##！！！大华设备厂家处于安全考虑，部分出厂设备禁用了adb调试功能，如果在设置页开发者选项入口中，未找到开启adb入口，则需要下载安装此软件对设置进行升级，升级后可开启adb远程调试！！！
<markdown>
适用厂商|下载链接|说明  
---|---|---|---|---
大华|http://release-android.i-school.net/archive/vender/dahua/Settings.apk
</markdown>

### 厂家工具资源集

<markdown>
适用厂商|下载链接|说明  
---|---|---|---|---
大华|http://release-android.i-school.net/archive/vender/dahua/Settings.apk|带开发者选项的设置软件
海康威视|http://release-android.i-school.net/archive/vender/hikvision/DevelopmentTools_1.0_build190704135548.apk|用于卸载设备自带的电子班牌软件
海康威视|http://release-android.i-school.net/archive/vender/hikvision/FACE_SDK-20200509.apk|用于进行人脸检测的服务程序，20年设备的自带软件，19年设备需要升级安装该软件
海康威视|http://release-android.i-school.net/archive/vender/hikvision/FACE_SDK-20190821.apk|用于进行人脸检测的服务程序，19年设备的自带软件
</markdown>

### 世纪凯城适配设备说明
1. 型号：yx_rk3288  
2. Android版本：5.1.1  
3. 内核版本：3.10.0 / yx1@yz1 #421 / Fri Sep 28 14:54:46 CST 2018  
4. 版本号：rk3288-userdebug 5.1.1 LMY48W eng.yx1.20180718-1030  
5. 内置存储：16GB  
6. 运行内存：2GB  
7. 读卡器挂载点：/dev/ttyS3  
8. 读卡器比特率：9600