remap
0.7.1indexedEnables compile-time access to hidden system APIs via ASM bytecode transformation, remapping types and resolving hidden overload method conflicts through annotation-based configuration.
2
Stars
—
Used by
dependents
—
Health
/ 100
remap
A Gradle plugin that uses ASM bytecode transformation to enable compile-time access to Android hidden APIs.
- RemapType: Remap a type to another type for access hidden types.
- RemapMethod: Remap a method to another method for access hidden overload conflict methods.
Usage
# gradle/libs.versions.toml
[versions]
loc = "<version>" # https://github.com/lisonge/remap/releases
[libraries]
remap-processor = { module = "li.songe.remap:remap-processor", version.ref = "remap" }
remap-annotation = { module = "li.songe.remap:remap-annotation", version.ref = "remap" }
[plugins]
remap = { id = "li.songe.remap", version.ref = }
// build.gradle.kts
plugins {
alias(libs.plugins.loc) apply false
}
// hidden_api/build.gradle.kts
dependencies {
compileOnly(libs.remap.annotation)
annotationProcessor(libs.remap.processor)
}
// app/build.gradle.kts
plugins {
alias(libs.plugins.remap)
}
dependencies {
compileOnly(project(":hidden_api"))
}
Access hidden types
android.app;
android.os.Build;
li.songe.remap.RemapType;
{
OP_POST_NOTIFICATION;
String {
();
}
{
();
}
}
AppOpsManagerHidden is a hidden type, it will be remapped to AppOpsManager.
// app/src/main/kotlin/example/app/Example.kt
package example.app
import android.app.AppOpsManager
import android.app.AppOpsManagerHidden
fun test(manger: AppOpsManager){
manger is AppOpsManagerHidden // true
AppOpsManagerHidden.opToName(AppOpsManagerHidden.OP_POST_NOTIFICATION) // "POST_NOTIFICATION"
(manger as AppOpsManagerHidden).clearHistory() // will Clears all app ops history
}
Access hidden overload conflict methods
getInstalledPackagesV17 is a hidden overload conflict method, it will be remapped to getInstalledPackages.
you can check its signature changes at https://diff.songe.li/i/IPackageManager.getInstalledPackages
// app/src/main/kotlin/example/app/Example.kt
package example.app
import android.content.IPackageManager
android.content.PackageInfo
android.content.PackageInfoList
android.os.Build
: List<PackageInfo> {
( (Build.VERSION.SDK_INT >= Build.VERSION_CODES.CINNAMON_BUN) {
manger.getInstalledPackagesV17(flags, userId)
} (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
manger.getInstalledPackages(flags, userId)
} {
manger.getInstalledPackages(flags.toInt(), userId)
}).list
}