Android-versions NPM

Android Versions

A node module to get Android versions by API level, semantic version, or version name.

Versions are referenced from source.android.com/docs/setup/reference/build-numbers. The version for "Current Development Build" ("CUR_DEVELOPMENT") is not included in the list of VERSIONS.

Release dates are referenced from https://en.wikipedia.org/wiki/Android_version_history.

Install

# NPM
npm install android-versions --save
# YARN
yarn add android-versions

Usage

View the tests for more advanced usage.

const android = require('android-versions')

Get by API level:

console.log(android.get(23))

=> { api: 23, semver: "6.0", name: "Marshmallow", versionCode: "M" }

Get by version:

console.log(android.get("2.3.3"))

=> { api: 10, semver: "2.3.3", name: "Gingerbread", versionCode: "GINGERBREAD_MR1" }

Get all by predicate:

android.getAll((version) => {
  return version.api >= 12 && version.api < 15
}).map((version) => version.versionCode)

=> [ "HONEYCOMB_MR1", "HONEYCOMB_MR2", "ICE_CREAM_SANDWICH" ]

Access a specific version with all info:

android.LOLLIPOP

=> { api: 21, semver: "5.0", name: "Lollipop", versionCode: "LOLLIPOP" }

Access the complete reference of Android versions with all info:

android.VERSIONS

=> {
  BASE:    { api: 1,  semver: "1.0", name: "(no code name)", versionCode: "BASE", releaseDate: "23 Sep 2008" },
  ...
  N:       { api: 24, semver: "7.0", name: "Nougat",         versionCode: "N",    releaseDate: "22 Aug 2016" }
  ...
}