jaredrummler / AndroidDeviceNames

A small Android library to get the market name of an Android device.
Apache License 2.0
1.38k stars 184 forks source link
android android-device android-library device-detection

Android Device Names

Maven Central License API Twitter Follow

A small Android library to get the market name of an Android device.

On many popular devices the market name of the device is not available. For example, on the Samsung Galaxy S7 the value of Build.MODEL could be "SAMSUNG-SM-G930A", "SM-G930F", "SM-G930K", "SM-G930L", etc.

This small library gets the market (consumer friendly) name of a device.

Usage

Setup the library

DeviceName.init(this);

Get the name of the current device:

String deviceName = DeviceName.getDeviceName();

The above code will get the correct device name for the top 600 Android devices. If the device is unrecognized, then Build.MODEL is returned. This can be executed from the UI thread.

Get the name of a device using the device's codename:

// Returns "Moto X Style"
DeviceName.getDeviceName("clark", "Unknown device");

Get information about the device:

DeviceName.with(context).request(new DeviceName.Callback() {

  @Override public void onFinished(DeviceName.DeviceInfo info, Exception error) {
    String manufacturer = info.manufacturer;  // "Samsung"
    String name = info.marketName;            // "Galaxy S8+"
    String model = info.model;                // "SM-G955W"
    String codename = info.codename;          // "dream2qltecan"
    String deviceName = info.getName();       // "Galaxy S8+"
    // FYI: We are on the UI thread.
  }
});

The above code queries a database included in the library based on Google's maintained list . This supports over 27,000 devices.

Download

Download the latest AAR or grab via Gradle:

implementation('com.jaredrummler:android-device-names:2.1.1') 

License

Copyright (C) 2015 Jared Rummler

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.