Awesome Open Source
Awesome Open Source

Android Device Names Build Status

This tiny Android library transforms a device model name into something people can understand. For example, a useless SM-N910W8 becomes Samsung Galaxy Note4 with a single method call. 🎉 It currently recognizes about 15k devices, including all Google Play supported devices.

It does not require network connectivity, ever. No, really.

To use it, add the following to your list of dependencies:

compile 'com.github.tslamic:dn3:3.0'

There are two classes you can use:

  1. DeviceNames use this if all you need is a single query.
  2. DeviceNamesDatabase for multiple queries. Don't forget to close it afterwards!

RxJava2 is supported out of the box. Obtaining a DeviceNames instance is easy:

AndroidDeviceNames.deviceNames(context)
  .subscribeOn(Schedulers.io())
  .observeOn(AndroidSchedulers.mainThread())
  .subscribe(names -> doSomethingWith(names));

but good ol' callbacks are supported too, in case you don't feel reactive:

AndroidDeviceNames.deviceNames(context,
  new AndroidDeviceNames.Callback<DeviceNames>() {
    @Override 
    public void onReady(@NonNull DeviceNames instance) {
      String name = instance.currentDeviceName(); 
    }
  });

You can obtain an instance of DeviceNamesDatabase in a similar fashion. After you're done using it, don't forget to explicitly call close(). For example:

@Override
protected void onStart() {
  super.onStart();
  AndroidDeviceNames.deviceNamesDatabase(this,
    new AndroidDeviceNames.Callback<DeviceNamesDatabase>() {
      @Override
      public void onReady(@NonNull DeviceNamesDatabase instance) {
        database = instance;
      }
    });
}

@Override
protected void onStop() {
  super.onStop();
  if (database != null) {
    database.close();
  }
}

Both DeviceNames and DeviceNamesDatabase come with three methods:

method description
currentDeviceName() Returns a user-friendly current device name, or null if the model is unknown.
currentDeviceName(String fallback) Same as above, but returns fallback if the model is unknown.
deviceName(String model, String fallback) Returns a user-friendly name for the specified model, or fallback, if model is unknown.

Not backwards compatible with v1 or v2, sorry.

If you've been using AndroidDeviceNames v1 or v2, please note that this version is not backwards compatible. Updating should be trivial, result in minimal code change and is highly encouraged.

Contributions

Special thanks to @corcoran for making numerous improvements to the lib.

In the wild

Here's the list of apps using this lib:

If you're using it in your app, and want to be on the above list, please let me know (create a pull request or open an issue).

License

Copyright 2017 Tadej Slamic

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.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
android (6,118) 
kotlin (3,398) 
library (1,277) 
offline (158) 

Find Open Source By Browsing 7,000 Topics Across 59 Categories

Advertising 📦 10
All Projects
Application Programming Interfaces 📦 124
Applications 📦 192
Artificial Intelligence 📦 78
Blockchain 📦 73
Build Tools 📦 113
Cloud Computing 📦 80
Code Quality 📦 28
Collaboration 📦 32
Command Line Interface 📦 49
Community 📦 83
Companies 📦 60
Compilers 📦 63
Computer Science 📦 80
Configuration Management 📦 42
Content Management 📦 175
Control Flow 📦 213
Data Formats 📦 78
Data Processing 📦 276
Data Storage 📦 135
Economics 📦 64
Frameworks 📦 215
Games 📦 129
Graphics 📦 110
Hardware 📦 152
Integrated Development Environments 📦 49
Learning Resources 📦 166
Legal 📦 29
Libraries 📦 129
Lists Of Projects 📦 22
Machine Learning 📦 347
Mapping 📦 64
Marketing 📦 15
Mathematics 📦 55
Media 📦 239
Messaging 📦 98
Networking 📦 315
Operating Systems 📦 89
Operations 📦 121
Package Managers 📦 55
Programming Languages 📦 245
Runtime Environments 📦 100
Science 📦 42
Security 📦 396
Social Media 📦 27
Software Architecture 📦 72
Software Development 📦 72
Software Performance 📦 58
Software Quality 📦 133
Text Editors 📦 49
Text Processing 📦 136
User Interface 📦 330
User Interface Components 📦 514
Version Control 📦 30
Virtualization 📦 71
Web Browsers 📦 42
Web Servers 📦 26
Web User Interface 📦 210