diff --git a/.gitignore b/.gitignore
index a1fc39c..603b140 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,14 +1,14 @@
+*.iml
.gradle
-/build/
-
-# Ignore Gradle GUI config
-gradle-app.setting
-
-# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
-!gradle-wrapper.jar
-
-# Cache of project
-.gradletasknamecache
-
-# # Work around https://youtrack.jetbrains.com/issue/IDEA-116898
-# gradle/wrapper/gradle-wrapper.properties
+/local.properties
+/.idea/caches
+/.idea/libraries
+/.idea/modules.xml
+/.idea/workspace.xml
+/.idea/navEditor.xml
+/.idea/assetWizardSettings.xml
+.DS_Store
+/build
+/captures
+.externalNativeBuild
+.cxx
diff --git a/README.md b/README.md
index bf3d8c3..b849570 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,80 @@
# RestrictionBypass
Android API restriction bypass for all Android Versions
+
+## Description
+
+Small library to access hidden API restricted by https://developer.android.com/distribute/best-practices/develop/restrictions-non-sdk-interfaces
+
+## Supported Android Versions
+
+Android API 19 - 30
+
+## Examples
+
+#### getDeclaredField(...)
+
+Original reflection call
+
+```
+ Class.forName("android.app.ActivityThread").getDeclaredField(
+ "mResourcesManager"
+ )
+```
+
+Call with RestrictionBypass
+
+```
+ RestrictionBypass.getDeclaredField(
+ Class.forName("android.app.ActivityThread"),
+ "mResourcesManager"
+
+ )
+```
+
+#### getMethod(...)
+
+Original reflection call
+
+
+```
+ Class.forName("android.app.ActivityThread").getMethod(
+ "getPackageInfo", String::class.java, Class.forName("android.content.res.CompatibilityInfo"), Integer.TYPE
+ )
+```
+Call with RestrictionBypass
+
+```
+ RestrictionBypass.getMethod(
+ Class.forName("android.app.ActivityThread"),
+ "getPackageInfo", String::class.java, Class.forName("android.content.res.CompatibilityInfo"), Integer.TYPE
+ )
+```
+
+#### getDeclaredMethod(...)
+Original reflection call
+
+```
+ Class.forName("android.app.ActivityThread").getDeclaredMethod(
+ "getPackageInfo", String::class.java, Class.forName("android.content.res.CompatibilityInfo"), Integer.TYPE
+ )
+```
+Call with RestrictionBypass
+
+```
+ RestrictionBypass.getDeclaredMethod(
+ Class.forName("android.app.ActivityThread"),
+ "getPackageInfo", String::class.java, Class.forName("android.content.res.CompatibilityInfo"), Integer.TYPE
+ )
+```
+
+## Integration
+
+Just take the maven repository:
+
+```
+WIP
+```
+
+Or take the prebuilt aar library: [restrictionbypass.aar](prebuild/restrictionbypass.aar)
+
+## Troubleshooting
\ No newline at end of file
diff --git a/app/.gitignore b/app/.gitignore
new file mode 100644
index 0000000..796b96d
--- /dev/null
+++ b/app/.gitignore
@@ -0,0 +1 @@
+/build
diff --git a/app/build.gradle b/app/build.gradle
new file mode 100644
index 0000000..cd39abe
--- /dev/null
+++ b/app/build.gradle
@@ -0,0 +1,38 @@
+apply plugin: 'com.android.application'
+apply plugin: 'kotlin-android'
+apply plugin: 'kotlin-android-extensions'
+
+android {
+ compileSdkVersion 29
+ buildToolsVersion "29.0.3"
+
+ defaultConfig {
+ applicationId "org.chickenhook.restrictionbypass.app"
+ minSdkVersion 19
+ targetSdkVersion 30
+ versionCode 1
+ versionName "1.0"
+
+ testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+ }
+
+ buildTypes {
+ release {
+ minifyEnabled false
+ proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+ }
+ }
+
+}
+
+dependencies {
+ implementation fileTree(dir: 'libs', include: ['*.jar'])
+ implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
+ implementation 'androidx.appcompat:appcompat:1.1.0'
+ implementation 'androidx.core:core-ktx:1.2.0'
+ implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
+ testImplementation 'junit:junit:4.12'
+ androidTestImplementation 'androidx.test.ext:junit:1.1.1'
+ androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
+ implementation project(':restrictionbypass')
+}
diff --git a/app/proguard-rules.pro b/app/proguard-rules.pro
new file mode 100644
index 0000000..f1b4245
--- /dev/null
+++ b/app/proguard-rules.pro
@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+# http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+# public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile
diff --git a/app/src/androidTest/java/org/chickenhook/restrictionbypass/app/KotlinExamples.kt b/app/src/androidTest/java/org/chickenhook/restrictionbypass/app/KotlinExamples.kt
new file mode 100644
index 0000000..992bac1
--- /dev/null
+++ b/app/src/androidTest/java/org/chickenhook/restrictionbypass/app/KotlinExamples.kt
@@ -0,0 +1,43 @@
+package org.chickenhook.restrictionbypass.app
+
+import junit.framework.Assert.assertNotNull
+import org.chickenhook.restrictionbypass.RestrictionBypass
+import org.junit.Test
+
+class KotlinExamples {
+
+ @Test(expected = NoSuchFieldException::class) // will fail due to api restrictions
+ fun accessResourcesManagerWithoutBypass() {
+ Class.forName("android.app.ActivityThread").getDeclaredField(
+ "mResourcesManager"
+ )
+ }
+
+ @Test
+ fun accessResourcesManagerWithBypass() {
+ assertNotNull(
+ RestrictionBypass.getDeclaredField(
+ Class.forName("android.app.ActivityThread"),
+ "mResourcesManager"
+
+ )
+ )
+ }
+
+ @Test(expected = NoSuchMethodException::class) // will fail due to api restrictions
+ fun invokeGetPackageInfoWithoutBypass() {
+ Class.forName("android.app.ActivityThread").getMethod(
+ "getPackageInfo", String::class.java, Class.forName("android.content.res.CompatibilityInfo"), Integer.TYPE
+ )
+ }
+
+ @Test
+ fun invokeGetPackageInfoWithBypass() {
+ assertNotNull(
+ RestrictionBypass.getMethod(
+ Class.forName("android.app.ActivityThread"),
+ "getPackageInfo", String::class.java, Class.forName("android.content.res.CompatibilityInfo"), Integer.TYPE
+ )
+ )
+ }
+}
\ No newline at end of file
diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml
new file mode 100644
index 0000000..d6bf057
--- /dev/null
+++ b/app/src/main/AndroidManifest.xml
@@ -0,0 +1,21 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/app/src/main/java/org/chickenhook/restrictionbypass/app/MainActivity.kt b/app/src/main/java/org/chickenhook/restrictionbypass/app/MainActivity.kt
new file mode 100644
index 0000000..cd7c415
--- /dev/null
+++ b/app/src/main/java/org/chickenhook/restrictionbypass/app/MainActivity.kt
@@ -0,0 +1,12 @@
+package org.chickenhook.restrictionbypass.app
+
+import androidx.appcompat.app.AppCompatActivity
+import android.os.Bundle
+
+class MainActivity : AppCompatActivity() {
+
+ override fun onCreate(savedInstanceState: Bundle?) {
+ super.onCreate(savedInstanceState)
+ setContentView(R.layout.activity_main)
+ }
+}
diff --git a/app/src/main/res/drawable-v24/ic_launcher_foreground.xml b/app/src/main/res/drawable-v24/ic_launcher_foreground.xml
new file mode 100644
index 0000000..2b068d1
--- /dev/null
+++ b/app/src/main/res/drawable-v24/ic_launcher_foreground.xml
@@ -0,0 +1,30 @@
+
+
+
+
+