库介绍

功能

采集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

        jitpack.iohttps://jitpack.io
  • Step 2.Add the dependency

        com.github.guyuepengDeviceInfoxxx

使用方法

拓展自定义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

文章来源于互联网,如有雷同请联系站长删除:DeviceInfo采集android设备信息工具

发表评论