Skip to content

Simple to use root checking Android library and sample app

License

Notifications You must be signed in to change notification settings

zhengoogle/rootbeer

Repository files navigation

RootBeer image

A tasty root checker library and sample app. We've scoured the internets for different methods of answering that age old question... Has this device got root?

#Root checks These are the current checks/tricks we are using to give an indication of root.

Java checks

  • CheckRootManagementApps
  • CheckPotentiallyDangerousAppss
  • CheckRootCloakingApps
  • CheckTestKeys
  • checkForDangerousProps
  • checkForBusyBoxBinary
  • checkForSuBinary
  • checkSuExists
  • checkForRWSystem

Native checks

We call through to our native root checker to run some of it's own checks. Native checks are typically harder to cloak, so some root cloak apps just block the loading of native libraries that contain certain key words.

  • checkForSuBinary

##Disclaimer and limitations!

We love root! both Scott and Mat (the main contributors) use rooted devices. But we appreciate sometimes you might want to have a indication your app is running on a rooted handset. Plus we wanted to see if we could beat the root cloakers. So that's what this library gives you, an indication of root.

Remember root==god, so there's no 100% way to check for root.

Root cloakers

Rootbeer can be defeated by using a combination of some of the root cloaks apps in that require xposded / cyida frameworks.

Tested cloakers (requires both to be installed and active):

##Usage

        RootBeer rootBeer = new RootBeer(context);
        if(rootBeer.isRooted()){
            //we found indication of root

        }else{
            //we didn't find indication of root

        }

You can also call each of the checks individually as the sample app does.

###Dependency

dependencies {
    compile('com.scottyab:rootbeerlib:0.0.1')
}

Building

The native libs are included however if you want to change them you'll need the ndk

For those unfamilar with NDK builds, if you make changes to the native code you'll have to run build.sh (in the /rootbeerlib/jni/ folder) to compile the native libraries and copy to /libs. Hopefully with the new Android Studio support for NDK this step will be part of the gradle build.

Sample app

TODO add screen shot and play store

##Contributing

There must be more root checks to make this more complete. If you have one please do send us a pull request.

###Thanks

##Other libraries If you dig this, you might like:

#Licence

Apache License, Version 2.0

Copyright (C) 2015, Scott Alexander-Bown, Mat Rollings

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.

About

Simple to use root checking Android library and sample app

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 88.4%
  • C++ 8.2%
  • Makefile 2.1%
  • C 1.3%