# device-year-class

**Repository Path**: HarmonyOS-tpc/device-year-class

## Basic Information

- **Project Name**: device-year-class
- **Description**: Device Year Class is an openharmony library that implements a simple algorithm that maps a device's RAM, CPU cores, and clock speed to the year
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2021-04-01
- **Last Updated**: 2024-05-30

## Categories & Tags

**Categories**: harmony

**Tags**: None

## README

# Device Year Class

Device Year Class is an openharmony library that implements a simple algorithm that maps
a device's RAM, CPU cores, and clock speed to the year where those combination
of specs were considered high end. This allows a developer to easily modify
application behavior based on the capabilities of the phone's hardware.

Mappings as of this writing (RAM is a ceiling):

| RAM | condition | Year Class |
|----:|----------:|-----------:|
|768MB| 1 core    | 2009 |
|     | 2+ cores  | 2010 |
|  1GB| <1.3GHz   | 2011 |
|     | 1.3GHz+   | 2012 |
|1.5GB| <1.8GHz   | 2012 |
|     | 1.8GHz+   | 2013 |
|  2GB|           | 2013 |
|  3GB|           | 2014 |
|  5GB|           | 2015 |
| more|           | 2016 |


### Download

Download the latest HARs or grab via Gradle:
```
implementation 'io.openharmony.tpc.thirdlib:yearclass:1.0.0'

or Maven:

<dependency>
  <groupId>io.openharmony.tpc.thirdlib</groupId>
  <artifactId>yearclass</artifactId>
  <version>1.0.0</version>
</dependency>
```

### Calculate Device Year Class
Calculating the current device's Year Class is simple.

```java
int year = YearClass.get(getApplicationContext());
```

Then, later on, you can use the year class to make decisions in your app, or
send it along with your analytics.

```java
if (year >= 2013) {
    // Do advanced animation
} else if (year > 2010) {
    // Do simple animation
} else {
    // Phone too slow, don't do any animations
}
```

See the `yearclass-sample` project for more details.

## Improve Device Year Class!
See the [CONTRIBUTING.md](https://github.com/facebook/device-year-class/blob/master/CONTRIBUTING.md) file for how to help out.

## License
Device Year Class is [BSD-licensed](https://github.com/facebook/device-year-class/blob/master/LICENSE). We also provide an additional patent grant.