HiddenApiRefinePlugin 常见问题解决方案

HiddenApiRefinePlugin 常见问题解决方案

HiddenApiRefinePlugin A Gradle plugin that improves the experience when developing Android apps, especially system tools, that use hidden APIs. 项目地址: https://gitcode.com/gh_mirrors/hi/HiddenApiRefinePlugin

1. 项目基础介绍和主要编程语言

项目名称：HiddenApiRefinePlugin

项目简介： HiddenApiRefinePlugin 是一个 Gradle 插件，旨在优化开发 Android 应用程序时使用隐藏 API 的体验，尤其是系统工具。它通过修改类名来解决使用隐藏 API 过程中出现的问题，使得开发者在开发系统工具时更加便捷。

主要编程语言： Java, Kotlin

2. 新手常见问题及解决步骤

问题一：如何配置项目以使用 HiddenApiRefinePlugin？

解决步骤：

1. 创建一个新的 Android 库模块。
2. 添加以下依赖到你的 build.gradle 文件中：

   dependencies {
       annotationProcessor 'dev.rikka.tools.refine:annotation-processor:<version>'
       compileOnly 'dev.rikka.tools.refine:annotation:<version>'
   }
   

3. 替换 <version> 为插件当前版本。

问题二：如何添加隐藏类到项目中？

解决步骤：

1. 在你的 Android 库模块中，创建一个包含隐藏类的 Java 或 Kotlin 文件。
2. 使用 @RefineAs 注解标记那些需要重命名的类或成员。
3. 确保你的主 Android 模块中 compileOnly 依赖了包含隐藏类的库模块。

问题三：遇到 "Bridge classes" 问题怎么办？

问题描述： 当只隐藏类中的某些成员时，Kotlin 会尝试链接从 stub 模块中的公共类，这可能会导致问题。

解决步骤：

1. 在你的主 Android 模块中创建一个额外的 Java-only 模块，用来 compileOnly 依赖包含 stub 类的库模块。
2. 在这个额外的 Java-only 模块中，创建与 stub 模块中相同名称的公共类，但不包含任何实现。
3. 这样做可以防止 Kotlin 链接这些公共类，从而解决 "Bridge classes" 问题。

以上步骤可以帮助新手开发者更好地理解和使用 HiddenApiRefinePlugin，避免在开发过程中遇到常见问题。

HiddenApiRefinePlugin A Gradle plugin that improves the experience when developing Android apps, especially system tools, that use hidden APIs. 项目地址: https://gitcode.com/gh_mirrors/hi/HiddenApiRefinePlugin