os-updater

OS Updater (Android App)

Skip staged rollout queues and update your OPPO/OnePlus/realme device ASAP!

Installation

These are the two places where we publish new versions; all others should not be trusted:

• Google Play Store (Android App Bundles)
• GitHub releases page (APKs)

We highly recommend downloading & installing the app from Google Play Store, as it has several benefits: much smaller download sizes, auto-updates (including in-app updates), Play Protect, etc.

Note: installing via GitHub still supports auto-updates via the Play Store. Both releases are completely identical (except for format differences: AAB vs APK), since they’re built on the exact same codebase & commit. Usually, we release on the Play Store first (100% rollout target), and a GitHub release follows shortly after.

Star History

Development

The app targets API 37 (Android 17), with a minimum API level of 23 (Android 6/Marshmallow). Make sure both SDK platforms (and optionally sources) are installed via SDK Manager.

Setup

This app uses Google & Firebase APIs, so app/google-services.json needs to exist. For development purposes, you’ll need to create your own Firebase project.

KeyStore

Running non-debug variants of the app requires two things: generating a Java KeyStore and referencing it in keystore.properties. Java KeyStores can be created in Android Studio itself: Build → Generate Signed Bundle / APK → Next → Create new… (under key store path). If you’re not using Android Studio, check the instructions for your specific IDE. Otherwise you’ll need to create one via CLI.

Store the JKS anywhere you want, though we’d recommend keeping it in the app directory. This git project has been configured to ignore all JKS files, so there’s no danger of accidentally committing secrets.

Once that’s done, create a keystore.properties file in this project’s root directory and fill in the fields correctly:

storePassword=<store-password>
keyPassword=<key-password>
keyAlias=<alias>
storeFile=<jks-location>

Note: if you saved the JKS file in the app directory, storeFile doesn’t need an absolute path (it’s relative to app)

License

This repository has no license. Default copyright laws apply, as mentioned in GitHub’s “Licensing a repository” page:

[…] without a license, the default copyright laws apply, meaning that you retain all rights to your source code and no one may reproduce, distribute, or create derivative works from your work. […].

For legal purposes, the owner of this organization (Adhiraj Singh Chauhan) is to be considered as the owner of this project, and all its associated files and build outputs (APKs, AABs, etc.). Contributors of this project agree to transfer copyrights to the owner of this organization, with some exceptions:

• Code owners share ownership of that file, and are entitled to the same copyright laws as the owner of the organization. Code owners are usually marked with the @author annotation on a class/method/variable.
• If any source file within this repository has license information as part of the file, that license overrides.

This means that you are not permitted to redistribute and/or modify both the source code of this project, and the relevant build outputs without our explicit permission. You can contact us on our official Discord server, or over email.

You can still view/fork this repository, submit PRs, and/or raise issues. This is in accordance with GitHub’s Terms of Service:

[…] By setting your repositories to be viewed publicly, you agree to allow others to view and “fork” your repositories […]

Contributing

All help is welcome, so if you’d like to contribute to the app’s code or translations check out CONTRIBUTING.md.