Releases

Ongoing development takes place in the dev branch. When features and fixes have been tested and are stable they are merged into the master branch. Releases are created from the master branch at least once a month and sometimes more frequently.

Binaries corresponding to releases are published to JCenter via Bintray. We also produce binaries for interim builds sometimes; these are available from the MSOpenTech Bintray repo. If you'd like to refer to them in your build scripts, make sure your root build.gradle script in Android Studio includes a reference to this repository. Your script will look similar to the following:

allprojects {
    repositories {
        jcenter()

        maven {
            url  "https://dl.bintray.com/msopentech/Maven"
        }
    }
}

Our versioning will follow Semantic Versioning 2.0, but this is largely irrelevant till we reach 1.0. Until then, we intend to increment the minor version number for breaking and other significant changes. For example, 0.10.1 introduced changes to the Credentials-related interfaces.

For production use, we strongly recommended that you specify a specific version, such as 0.13.0. This eliminates the small possibility that new patch versions of our libraries will break your build at an inconvenient time.

For development and testing, you may choose not to specify a version, thus retrieving the latest binaries on every build, or use a version string like [0.9,0.10) or [0.10,0.11) to retrieve the latest patch for a given minor version range. Here's a handy chart on Maven version syntax.

To be notified immediately when new versions are published, watch our Bintray repo.