DeviceInfo-Sample

Simple, single class wrapper to get device information from an android device.

This library provides an easy way to access all the device information without having to deal with all the boilerplate stuff going on inside.

As part of the process of my learning kotlin, I migrated the library to support Kotlin as well. If you would like to view the Kotlin version of the library - please checkout branch migrate_to_kotlin

Library also provides option to ask permissions for Marshmellow devices!

Sample App

Donwload the sample app on the Google Play Store and check out all the features

How to integrate the library in your app?

Gradle Dependecy

dependencies {
        implementation 'com.an.deviceinfo:deviceinfo:0.1.5'
}

Maven Dependecy

<dependency>
  <groupId>com.an.deviceinfo</groupId>
  <artifactId>deviceinfo</artifactId>
  <version>0.1.5</version>
  <type>pom</type>
</dependency>

Downloads

You can download the aar file from the release folder in this project.
In order to import a .aar library:
1) Go to File>New>New Module
2) Select "Import .JAR/.AAR Package" and click next.
3) Enter the path to .aar file and click finish.
4) Go to File>Project Settings (Ctrl+Shift+Alt+S).
5) Under "Modules," in left menu, select "app."
6) Go to "Dependencies tab.
7) Click the green "+" in the upper right corner.
8) Select "Module Dependency"
9) Select the new module from the list.

Usage

For easy use, I have split up all the device information by the following:
1. Location
2. Ads
3. App
4. Battery
5. Device
6. Memory
7. Network
8. User Installed Apps
9. User Contacts

Location

LocationInfo locationInfo = new LocationInfo(this);
DeviceLocation location = locationInfo.getLocation();

Value	Function Name	Returns
Latitude	getLatitude()	Double
Longitude	getLongitude()	Double
Address Line 1	getAddressLine1()	String
City	getCity()	String
State	getState()	String
CountryCode	getCountryCode()	String
Postal Code	getPostalCode()	String

Ads

No Google play services needed!

AdInfo adInfo = new AdInfo(this);
adInfo.getAndroidAdId(new new AdInfo.AdIdCallback() {
                         @Override
                         public void onResponse(Ad ad) {
                             String advertisingId = ad.getAdvertisingId();
                             Boolean canTrackAds = ad.isAdDoNotTrack();
                         }
                     });

Value	Function Name	Returns
AdvertisingId	getAdvertisingId()	String
Can Track ads	isAdDoNotTrack()	boolean

App

App app = new App(this);

Value	Function Name	Returns
App Name	getAppName()	String
Package Name	getPackageName()	String
Activity Name	getActivityName()	String
App Version Name	getAppVersionName()	String
App Version Code	getAppVersionCode()	Integer

Battery

Battery battery = new Battery(this);

Value	Function Name	Returns
Battery Percent	getBatteryPercent()	int
Is Phone Charging	isPhoneCharging()	boolean
Battery Health	getBatteryHealth()	String
Battery Technology	getBatteryTechnology()	String
Battery Temperature	getBatteryTemperature()	float
Battery Voltage	getBatteryVoltage()	int
Charging Source	getChargingSource()	String
Is Battery Present	isBatteryPresent()	boolean

Device

Device device = new Device(this);

Value	Function Name	Returns
Release Build Version	getReleaseBuildVersion()	String
Build Version Code Name	getBuildVersionCodeName()	String
Manufacturer	getManufacturer()	String
Model	getModel()	String
Product	getProduct()	String
Fingerprint	getFingerprint()	String
Hardware	getHardware()	String
Radio Version	getRadioVersion()	String
Device	getDevice()	String
Board	getBoard()	String
Display Version	getDisplayVersion()	String
Build Brand	getBuildBrand()	String
Build Host	getBuildHost()	String
Build Time	getBuildTime()	long
Build User	getBuildUser()	String
Serial	getSerial()	String
Os Version	getOsVersion()	String
Language	getLanguage()	String
SDK Version	getSdkVersion()	int
Screen Density	getScreenDensity()	String
Screen Height	getScreenHeight()	int
Screen Density	getScreenWidth()	int

Memory

Memory memory = new Memory(this);

Value	Function Name	Returns
Has External SD Card	isHasExternalSDCard()	boolean
Total RAM	getTotalRAM()	long
Available Internal Memory Size	getAvailableInternalMemorySize()	long
Total Internal Memory Size	getTotalInternalMemorySize()	long
Available External Memory Size	getAvailableExternalMemorySize()	long
Total External Memory Size	getTotalExternalMemorySize()	String

Network

Network network = new Network(this);

Value	Function Name	Returns
IMEI	getIMEI()	String
IMSI	getIMSI()	String
Phone Type	getPhoneType()	String
Phone Number	getPhoneNumber()	String
Operator	getOperator()	String
SIM Serial	getsIMSerial()	String
Network Class	getNetworkClass()	String
Network Type	getNetworkType()	String
Is SIM Locked	isSimNetworkLocked()	boolean
Is Nfc Present	isNfcPresent()	boolean
Is Nfc Enabled	isNfcEnabled()	boolean
Is Wifi Enabled	isWifiEnabled()	boolean
Is Network Available	isNetworkAvailable()	boolean

User Installed Apps

UserAppInfo userAppInfo = new UserAppInfo(this);
List<UserApps> userApps = userAppInfo.getInstalledApps(boolean includeSystemApps);

Value	Function Name	Returns
App Name	getAppName()	String
Package Name	getPackageName()	String
Version Name	getVersionName()	String
Version Code	getVersionCode()	int

User Contacts

UserContactInfo userContactInfo = new UserContactInfo(mActivity);
List<UserContacts> userContacts = userContactInfo.getContacts();

Value	Function Name	Returns
Contact Name	getDisplayName()	String
Mobile Number	getMobileNumber()	String
Phone Type	phoneType()	String

How to get Permissions for android 6+

Easy! I have provided a small, easy wrapper for getting permissions for marshmellow devices.

First, override onRequestPermissionsResult and call PermissionManager.handleResult(requestCode, permissions, grantResults);

PermissionManager permissionManager = new PermissionManager(this);
    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        permissionManager.handleResult(requestCode, permissions, grantResults);
    }

Now you can ask permission:

permissionManager.showPermissionDialog(permission)
                    .withDenyDialogEnabled(true)
                    .withDenyDialogMsg(mActivity.getString(R.string.permission_location))
                    .withCallback(new PermissionManager.PermissionCallback() {
                        @Override
                        public void onPermissionGranted(String[] permissions, int[] grantResults) {
                            //you can handle what to do when permission is granted
                        }

                        @Override
                        public void onPermissionDismissed(String permission) {
                           /**
                             * user has denied the permission. We can display a custom dialog 
                             * to user asking for permission
                           * */
                        }

                        @Override
                        public void onPositiveButtonClicked(DialogInterface dialog, int which) {
                          /**
                            * You can choose to open the
                            * app settings screen
                            * * */
                              PermissionUtils permissionUtils = new PermissionUtils(this);
                              permissionUtils.openAppSettings();
                        }

                        @Override
                        public void onNegativeButtonClicked(DialogInterface dialog, int which) {
                          /**
                            * The user has denied the permission!
                            * You need to handle this in your code
                            * * */
                        }
                    })
                    .build();

Various options available in PermissionManager

Value	Function Name	Returns
To enable custom dialog when user has denied the permission	withDenyDialogEnabled()	boolean
To enable Rationale, explaining the need for the permission, the first time they have denied the permission	withRationaleEnabled()	boolean
Message to be displayed in the custom dialog	withDenyDialogMsg()	String
Title to be displayed in the custom dialog	withDenyDialogTitle()	String
Postive Button text to be displayed in the custom alert dialog	withDenyDialogPosBtnText()	String
Negative Button text to be displayed in the custom alert dialog	withDenyDialogNegBtnText()	String
Should display the negative button flag	withDenyDialogNegBtn()	boolean
Flag to cancel the dialog	isDialogCancellable()	boolean

Created and maintained by:

Anitaa Murthy [email protected]