DeviceInfo采集android设备信息工具🔥🔥

库介绍

功能

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

Collect Android device information and output it in the form of Json

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

You can freely customize the type of device to be collected, the details of the displayed device information, etc.

特性

• 通过继承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等）

如何使用

添加依赖库

库版本号 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 v1.0.1
 */

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（2018.06.23）
• 添加CPU、设备基本信息采集支持，更新Sim注释，发布v1.0.1（2018.06.23）
• 添加更多信息采集模板类（Battery,NFC,Camera...），统一输出（Json）中key的命名规范（2018.06.26）
• 添加了系统描述相关信息的采集，修改了Demo.apk中的Json的显示方式（2018.06.29）

感谢

• 库内使用了 严振杰 的AndPermission库

扯扯淡

• 源码地址：https://github.com/appzy/DeviceInfo

• 如果觉得有用，欢迎Stars

• If you find it useful, welcome to Stars