DeviceInfo采集android设备信息工具

2018-02-27 11:20:33来源:https://www.jianshu.com/p/aaa0f8a8096e作者:appzy人点击

分享


库介绍
功能

采集Android设备信息,以Json形式输出


可自由定制要采集的设备类型,显示的设备信息详情等


特性
通过继承BaseDeviceInfoCollector类,配合DeviceInfoManager以获取任意设备信息
通过DeviceInfoManager管理每个设备信息采集器(下简称:Collector),可自由添加Collector,以同时采集N多种软硬件设备信息
Collector分为自动采集和手动采集两种采集方式。
自动采集:Manager控制自发进行的采集
手动采集:需要用户参与交互的数据采集过程

Manager管理的多个Collector做并发自动采集,手动采集可以配置在自动采集动作结束后自行开始
每个Collector独立管理各自所需要的权限,在Manager中统一申请(SDK_VERSION >= 23)
可选择获取所有的模块的设备信息(Json),也可以选择只输出单一模块(Json)
提供丰富的状态回调接口DeviceInfoCollectListener,可以监听采集结束等各种状态
输出示例
默认输出:
{
"board": {"boardName": "MSM8939"},
"sim": [{
"dataState": "0",
"imsi": "460036820263837",
"isNetworkRoaming": "false",
"networkOperatorName": "China Telecom",
"networkType": "14",
"phoneType": "2",
"simCountryIso": "cn",
"simOperator": "46003",
"simSerialNumber": "89860315844110607274",
"simState": "0"
}]
}

自定义设备信息
DeviceInfoManager.NewInstance(this)
.addCollector(new PhoneBasicInfoCollector(this, "basic")) //Andorid设备基本信息(PhoneBasicInfoCollector)
.addCollector(new SimInfoCollector(this, "sim")) //Sim卡信息(SimInfoCollector)同时识别多张Sim卡
.addCollector(new CpuInfoCollector(this, "cpu")) //Cpu信息(CpuInfoCollector)
.addCollector(new BoardInfoCollector(this, "board")) //主板信息(BoardInfoCollector)
.addCollector(new BatteryInfoCollector(this, "battery")) //电池信息(BatteryInfoCollector)
.addCollector(new StorageInfoCollector(this, "storage")) //存储信息(RAM & SD)(StorageInfoCollector)
.addCollector(new CameraInfoCollector(this, "camera", true)) //摄像头信息(CameraInfoCollector)
.addCollector(new ScreenInfoCollector(this, "screen")) //屏幕信息(ScreenInfoCollector)
.addCollector(new UiInfoCollector(this, "ui")) //Ui信息(UiInfoCollector)
.addCollector(new SensorInfoCollector(this, "sensor")) //传感器列表(SensorInfoCollector)
.addCollector(new NfcInfoCollector(this, "nfc")) //NFC信息(NfcInfoCollector)
.addCollector(new SystemInfoCollector(this, "system")) //系统相关信息(Build.prop等)
.autoStartManualCollection(true)
.bindListener(mDeviceInfoCollectListener)
.start();

当然也可以通过重写每个Collector的public String getJsonInfo();以自定义Json的输出内容
目前可获取的设备信息(只作为模板用途,建议使用时自行定制)
Andorid设备基本信息(PhoneBasicInfoCollector)
Sim卡信息(SimInfoCollector)
同时识别多张Sim卡

主板信息(BoardInfoCollector)
Cpu信息(CpuInfoCollector)
电池信息(BatteryInfoCollector)
屏幕信息(ScreenInfoCollector)
NFC信息(NfcInfoCollector)
传感器列表(SensorInfoCollector)
摄像头信息(CameraInfoCollector)
存储信息(RAM & SD)(StorageInfoCollector)
Ui信息(UiInfoCollector)
系统相关信息(Build.prop等)
如何使用
添加依赖库

[https://jitpack.io]
[GitHub issues]



库版本号 version 请看上方 JitPack 的最新版本号,如v1.0.2,并不是 *xxx* (推荐使用最新版)



Gradle

Step 1.Add it in your root build.gradle at the end of repositories


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


Step 2.Add the dependency


    dependencies {
compile 'com.github.guyuepeng:DeviceInfo:xxx'
}


Maven

Step 1.Add it in your root build.gradle at the end of repositories


    <repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>


Step 2.Add the dependency


    <dependency>
<groupId>com.github.guyuepeng</groupId>
<artifactId>DeviceInfo</artifactId>
<version>xxx</version>
</dependency>


使用方法
拓展自定义Collector

通过继承BaseDeviceInfoCollector抽象类进行功能拓展,以采集更多信息,或输出自定义的Json内容



public DemoCollector(Context context, String collectorName)中的collectorName

public abstract boolean needCollectManually();返回自定义Collector是否需要手动收集
public abstract String[] getRequiredPermissions();返回自定义Collector所需要的权限(每个Collector独立管理权限,Manager统一申请)
protected abstract void doCollectAutomatically();Collector做自动采集的方法
protected abstract void doCollectManually();Collector做手动采集的方法,若采用Manager统一管理,需要needCollectManually()的返回值为true此方法才会被调用
package ltns.deviceinfolib.collector;
import android.content.Context;
/**
* @date 创建时间:2018/1/8
* @author appzy
* @Description
* @version
*/
public class DemoCollector extends BaseDeviceInfoCollector {
public DemoCollector(Context context, String collectorName) {
super(context, collectorName);
}
@Override
public boolean needCollectManually() {
return false;
}
@Override
public String[] getRequiredPermissions() {
return new String[0];
}
@Override
protected void doCollectAutomatically() {
}
@Override
protected void doCollectManually() {
}
}

通过Manager管理多个Collector

为了代码简洁易读,我把它设计成这样:(不知道这样写会不会违背什么设计模式,如果有请issues告诉我,谢谢:D)


DeviceInfoManager.NewInstance(this)
.addCollector(new BoardInfoCollector(MainActivity.this, "board"))
.addCollector(new SimInfoCollector(MainActivity.this, "sim"))
.autoStartManualCollection(true)
.bindListener(mDeviceInfoCollectListener)
.start();


addCollector(BaseDeviceInfoCollector)添加一个新的Collector到Manager中
autoStartManualCollection(boolean)默认是true,自动采集全部完成后立即开启手动采集队列

在DeviceInfoCollectListener中监听采集状态:



mDeviceInfoManager.getDeviceJsonInfo();方法获取到Manager中所有Collector采集到的信息
mCollector.getJsonInfo();方法获取单个Collector中的信息
void onStart();Manager调用start()时回调
void onSingleSuccess(BaseDeviceInfoCollector mCollector);当有某个Collector成功采集到信息后回调
void onSingleFailure(BaseDeviceInfoCollector mCollector, String mErrorInfo);当有某个Collector采集信息失败后回调(并不一定没有采集到数据,已经采集到的信息仍会被以Json格式输出)
void onAllDone(DeviceInfoManager mDeviceInfoManager);通过addCollector(...)方法添加到Manager中的所有Collector均完成采集动作后回调,需要说明的是,不一定是全部采集成功了,只是采集动作完成了
void onAutoAllDone(DeviceInfoManager mDeviceInfoManager);当抛开需要手动收集的收集器,其他的收集器全部完成采集动作后回调


注意:onSingleFailure(BaseDeviceInfoCollector mCollector, String mErrorInfo)中也可能存在数据,即mCollector.getJsonInfo();也可能会有数据,具体原因可参考源码和下方 注意事项



    private DeviceInfoCollectListener mDeviceInfoCollectListener = new DeviceInfoCollectListener() {
@Override
public void onStart() {
}
@Override
public void onSingleSuccess(BaseDeviceInfoCollector mCollector) {
//mCollector.getJsonInfo();
}
@Override
public void onSingleFailure(BaseDeviceInfoCollector mCollector, String mErrorInfo) {
//mCollector.getJsonInfo();
}
@Override
public void onAllDone(DeviceInfoManager mDeviceInfoManager) {
// mDeviceInfoManager.getDeviceJsonInfo();
}
@Override
public void onAutoAllDone(DeviceInfoManager mDeviceInfoManager) {
}
};

Collector单独跑也是支持的

(支持但不推荐)


当然还是推荐使用Manager :D。就是想要自己单独跑也可以,接着~



特别说明:Collector单独跑需要调用者自行申请权限,因此方便起见,推荐使用Manager统一管理



BoardInfoCollector为例:


BoardInfoCollector mCollector = new BoardInfoCollector(MainActivity.this, "board");
mCollector.bindObserver(mStateObserver);
mCollector.startCollectAutomatically();//启动自动采集
mCollector.startCollectManually();//启动手动采集

CollectorStateObserver中监听Collector状态:



void onCollectionSuccess(BaseDeviceInfoCollector mCollector);当手动采集和自动收集均成功完成采集时调用
void onCollectionFailure(BaseDeviceInfoCollector mCollector,String mErrorInfo);
void onManualCollectionSuccess(BaseDeviceInfoCollector mCollector,boolean startNext); 当手动参与的信息收集成功时调用。 P.s. 此方法回调时会同时回调onCollectionSuccess(),具体看源码
void onManualCollectionFailure(BaseDeviceInfoCollector mCollector,String mErrorInfo,boolean startNext); 当手动参与的信息收集失败时调用。 P.s. 此方法回调时会同时回调onCollectionFailure(...)
void onNeedManualCollect(BaseDeviceInfoCollector mCollector);该采集器需要手动采集时回调,具体回调时间请看源码
    private CollectorStateObserver mStateObserver=new CollectorStateObserver() {
@Override
public void onCollectionSuccess(BaseDeviceInfoCollector mCollector) {
}
@Override
public void onCollectionFailure(BaseDeviceInfoCollector mCollector, String mErrorInfo) {
}
@Override
public void onManualCollectionSuccess(BaseDeviceInfoCollector mCollector, boolean startNext) {
}
@Override
public void onManualCollectionFailure(BaseDeviceInfoCollector mCollector, String mErrorInfo, boolean startNext) {
}
@Override
public void onNeedManualCollect(BaseDeviceInfoCollector mCollector) {
}
};

注意事项
多个Collector的自动采集过程是并发的,运行在子线程中;手动采集方法运行在主线程中
Manager的监听回调不一定在主线程,因此若操作涉及线程安全,如更新UI,建议使用Handler
Manager的boolean isManualCollectionStartAutomatically默认为true,若要更改需要手动配置autoStartManualCollection(boolean)为false。若设置为false,需要调用startCollectByHand开启手动采集队列;当然也可以单独开启某个Collector的手动采集
onSingleFailure(BaseDeviceInfoCollector mCollector, String mErrorInfo)回调中通过调用mCollector.getJsonInfo();方法仍可以获取到doCollectAutomatically();方法中采集到的自动收集部分的设备信息
库内内置了AndPermission库以处理权限相关,Gson以处理Json相关
库内所有的Collector实现类只做模板使用,建议使用时自行继承BaseDeviceInfoCollector实现;若要使用库内Collector,需要在 Manifests.xml 中声明对应权限后才能正常使用
更新日志
上传库,提供Sim&Board信息采集支持,更新README(2017.06.23)
添加CPU、设备基本信息采集支持,更新Sim注释,发布v1.0.1(2017.06.23)
添加更多信息采集模板类(Battery,NFC,Camera...),统一输出(Json)中key的命名规范(2017.06.26)
添加了系统描述相关信息的采集,修改了Demo.apk中的Json的显示方式(2017.06.29)
感谢
库内使用了 严振杰 的AndPermission库
扯扯淡
源码地址:https://github.com/appzy/DeviceInfo
如果觉得有用,欢迎Stars







最新文章

123

最新摄影

闪念基因

微信扫一扫

第七城市微信公众平台