RocooFix 开源项目快速入门指南

RocooFix 开源项目快速入门指南

RocooFix another hotfix framework 项目地址: https://gitcode.com/gh_mirrors/ro/RocooFix

1. 项目目录结构及介绍

RocooFix 是一个热修复框架，其目录结构设计清晰，便于开发者理解和定制。以下是该项目的主要目录结构：

RocooFix/
├── app                 # 示例应用程序模块
│   ├── src              # 应用程序源代码
│   │   └── main        # 主要代码目录，含Java代码和资源文件
│   ├── build.gradle    # 应用模块构建脚本
│   └── AndroidManifest.xml
├── build.gradle       # 根项目构建脚本
├── README.md           # 项目简介与使用说明
├── LICENSE             # 许可证文件，采用MIT协议
├── roc...              # 各种辅助文件，如git配置、忽略文件等
└── ...                 # 其他配置和文档文件

• app 目录包含了示例应用的完整实现，展示如何集成RocooFix。
• build.gradle 文件位于根目录和子目录中，定义了项目构建规则。
• README.md 提供了项目的核心信息、安装步骤和主要特性。

2. 项目启动文件介绍

在集成RocooFix时，主要的启动点在于你的应用Application类。你需要继承自RocooApplication（或者在自己的Application类中正确调用RocooFix的初始化方法），以下是一个简化的启动文件示例：

public class MyApplication extends Application {
    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        // 初始化RocooFix，这是应用启动的关键部分
        RocooFix.init(this);
        
        // 若要进行动态修复测试，可以使用以下方式之一：
        // RocooFix.initPathFromAssets(this, "patch.dex");
        // 或
        // RocooFix.applyPatch(this, "/path/to/your/patch.dex");
    }
}

记得在AndroidManifest.xml中声明你的Application类为启动类：

<application
    android:name=".MyApplication"
    ...>
    <!-- activities, services, etc -->
</application>

3. 项目的配置文件介绍

Gradle构建配置

RocooFix的集成主要依赖于Gradle构建系统。你需要在项目的两个关键Gradle文件中进行配置：

根目录下的build.gradle

引入RocooFix插件及其依赖库到你的构建脚本中:

dependencies {
    classpath 'com.dodola:rocoofix:1.2.6'
}

repositories {
    jcenter()
}

应用模块的build.gradle

应用这些配置并确保RocooFix插件被正确应用：

apply plugin: 'com.dodola.rocoofix'

repositories {
    jcenter()
}

rocoo_fix {
    includePackage = ['com/dodola/rocoosample']  // 指定需要制作补丁的包名
    excludeClass = ['BaseApplication.class']     // 排除不需要加入补丁的类
    preVersionPath = '1'                         // 版本控制，用于打补丁前的版本识别
    enable = true                                // 是否启用补丁生成功能
    scanref = true                               // 解决ART虚拟机崩溃的问题，此功能处于Beta阶段
}

dependencies {
    compile 'com.dodola:rocoo:1.1'
}

请注意，随着时间的推移，版本号和仓库路径可能会变化，实际使用时应检查最新文档和依赖版本。此外，配置中的preVersionPath需要根据你的实际版本管理策略调整，并且在制作新补丁时更新以反映正确的前一版本号。

RocooFix another hotfix framework 项目地址: https://gitcode.com/gh_mirrors/ro/RocooFix