README.chromium
1Name: AndroidHiddenApiBypass
2URL: https://github.com/LSPosed/AndroidHiddenApiBypass
3Version: b16cc3934a27e55e51f00f5504c7f49e7c8cfab7
4License: Apache 2.0
5License File: LICENSE
6Security Critical: no
7Shipped: no
8
9Description:
10AndroidHiddenApiBypass enables reflection on APIs that are meant to be guarded
11by Android's API Blocklist.
12
13Local Modifications:
14* Removed files related to Gradle.
15* Added local_modifications/.../BuildConfig.java to replace what Gradle would
16 have generated.
17* Added BUILD.gn
18
README.md
1# AndroidHiddenApiBypass
2
3[](https://github.com/LSPosed/AndroidHiddenApiBypass/actions/workflows/android.yml)
4
5Bypass restrictions on non-SDK interfaces.
6
7## Why AndroidHiddenApiBypass?
8
9- Pure Java: no native code used.
10- Reliable: does not rely on specific behaviors, so it will not be blocked like meta-reflection or `dexfile`.
11- Stable: `unsafe`, art structs and `setHiddenApiExemptions` are stable APIs.
12
13[How it works (Chinese)](https://lovesykun.cn/archives/android-hidden-api-bypass.html)
14
15## Integration
16
17Gradle:
18
19```gradle
20repositories {
21 mavenCentral()
22}
23dependencies {
24 implementation 'org.lsposed.hiddenapibypass:hiddenapibypass:4.3'
25}
26```
27
28## Usage
29
301. Invoke a restricted method:
31 ```java
32 HiddenApiBypass.invoke(ApplicationInfo.class, new ApplicationInfo(), "usesNonSdkApi"/*, args*/)
33 ```
341. Invoke restricted constructor:
35 ```java
36 Object instance = HiddenApiBypass.newInstance(Class.forName("android.app.IActivityManager$Default")/*, args*/);
37 ```
381. Get all methods including restricted ones from a class:
39 ```java
40 var allMethods = HiddenApiBypass.getDeclaredMethods(ApplicationInfo.class);
41 ((Method).stream(allMethods).filter(e -> e.getName().equals("usesNonSdkApi")).findFirst().get()).invoke(new ApplicationInfo());
42 ```
431. Get all non-static fields including restricted ones from a class:
44 ```java
45 var allInstanceFields = HiddenApiBypass.getInstanceFields(ApplicationInfo.class);
46 ((Method).stream(allInstanceFields).filter(e -> e.getName().equals("longVersionCode")).findFirst().get()).get(new ApplicationInfo());
47 ```
481. Get all static fields including restricted ones from a class:
49 ```java
50 var allStaticFields = HiddenApiBypass.getStaticFields(ApplicationInfo.class);
51 ((Method).stream(allInstanceFields).filter(e -> e.getName().equals("HIDDEN_API_ENFORCEMENT_DEFAULT")).findFirst().get()).get(null);
52 ```
531. Get specific class method or class constructor
54 ```java
55 var ctor = HiddenApiBypass.getDeclaredConstructor(ClipDrawable.class /*, args */);
56 var method = HiddenApiBypass.getDeclaredMethod(ApplicationInfo.class, "getHiddenApiEnforcementPolicy" /*, args */);
57 ```
581. Add a class to exemption list:
59 ```java
60 HiddenApiBypass.addHiddenApiExemptions(
61 "Landroid/content/pm/ApplicationInfo;", // one specific class
62 "Ldalvik/system" // all classes in packages dalvik.system
63 "Lx" // all classes whose full name is started with x
64 );
65 ```
66 if you are going to add all classes to exemption list, just leave an empty prefix:
67 ```java
68 HiddenApiBypass.addHiddenApiExemptions("");
69 ```
70## License
71
72 Copyright 2021 LSPosed
73
74 Licensed under the Apache License, Version 2.0 (the "License");
75 you may not use this file except in compliance with the License.
76 You may obtain a copy of the License at
77
78 https://www.apache.org/licenses/LICENSE-2.0
79
80 Unless required by applicable law or agreed to in writing, software
81 distributed under the License is distributed on an "AS IS" BASIS,
82 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
83 See the License for the specific language governing permissions and
84 limitations under the License.
85
){kind=link}