/AndroidDeviceNames

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

Primary LanguageJavaApache License 2.0Apache-2.0

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

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:

// Retruns "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 S7 Edge"
    String model = info.model;                // "SAMSUNG-SM-G935A"
    String codename = info.codename;          // "hero2lte"
    String deviceName = info.getName();       // "Galaxy S7 Edge"
    // FYI: We are on the UI thread.
  }
});

The above code loads JSON from a generated list of device names based on Google's maintained list. It will be up-to-date with Google's supported device list so that you will get the correct name for new or unknown devices. This supports over 10,000 devices.

This will only make a network call once. The value is saved to SharedPreferences for future calls.

Download

Download the latest AAR or grab via Gradle:

compile 'com.jaredrummler:android-device-names:1.1.4'

Or simply copy the DeviceName class intro your project, update the package declaration, and you are good to go.

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.