revanced-patcher

ReVancedGPL-3.0更新放缓

用 Kotlin 编写的 Android 应用补丁框架,可解析 APK 的 Dalvik 字节码与资源并注入自定义修改,是 ReVanced 生态打补丁的底层引擎。

💉 ReVanced Patcher used to patch Android applications

v22.0.1发布于 2026-03-13 22:58 UTC3,555star +2 / 7 天305fork同步于 2026-11-10 17:41 UTC

怎么上手

由 README 提炼,执行前请确认
dependencies {
    implementation("app.revanced:revanced-patcher:{$version}")
}
硬件要求按 README 说明

README 未说明

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

用于给 Android 应用打补丁的 Kotlin 库,支撑 ReVanced Manager 与 CLI

用 Kotlin 编写的 Android 应用补丁框架,可解析 APK 的 Dalvik 字节码与资源并注入自定义修改,是 ReVanced 生态打补丁的底层引擎。

核心能力

  • 反汇编并重新汇编 Dalvik VM 字节码
  • 解码与重建 Android APK 资源
  • 直接读写 APK 内的任意文件
  • 提供 API 编写模块化补丁

容易踩的坑

需先把 GitHub Packages 仓库添加到项目才能拉取依赖;这是库而非独立工具,实际打补丁要配合 ReVanced CLI 或 Manager 使用

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v22.0.1
  1. v22.1.0-dev.1pre-release2026-06-09 · 2026-06-09 19:15 UTC
    查看更新说明

    22.1.0-dev.1 (2026-06-09)

    Bug Fixes

    • Handle exceptions when trying to read the list of classes from invalid patches files (ff66ffd)
    • Set the correct patch type for raw resource patches (fee79af)

    Features

    • Add ResourcePatchContext#packageVersionName and ResourcePatchContext#packageName (457dfd4)
    • Add ResourcePatchContext#inputApkFileInputStream for patches to be able to read the full input APK (22365a9)
    • Deprecate unnecessary toMutable extension functions (023afba)

    Performance Improvements

    • Unpin classes before starting to write them so they can be garbage collected. (d166863)
    • Use existing ExtFile from apkInfo to read the original APK file contents (afae858)
  2. v22.0.2-dev.1pre-release2026-03-17 · 2026-03-17 20:39 UTC
    查看更新说明

    22.0.2-dev.1 (2026-03-17)

    Bug Fixes

    • Use PathClassLoader to fix not being able to load patches on Android 8 or below (f4b65f5)
  3. v22.0.1最新正式版2026-03-13 · 2026-03-13 22:58 UTC

    22.0.1 (2026-03-13)

    Bug Fixes

    • Add missing instructions matching overload (cde646f)
    • Add missing type parameter to match (4a506b7)
    • Use API available below SDK 35 (92fec83)
    • Write the patches results only on access of the fields to be able to control the time of write (57c3358)
  4. v22.0.1-dev.3pre-release2026-03-13 · 2026-03-13 22:22 UTC
    查看更新说明

    22.0.1-dev.3 (2026-03-13)

    Bug Fixes

    • Write the patches results only on access of the fields to be able to control the time of write (57c3358)
  5. v22.0.1-dev.2pre-release2026-03-11 · 2026-03-11 10:27 UTC
    查看更新说明

    22.0.1-dev.2 (2026-03-11)

    Bug Fixes

    • Add missing instructions matching overload (cde646f)

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    💉 ReVanced Patcher

    GitHub Workflow Status (with event) GPLv3 License

    ReVanced Patcher used to patch Android applications.

    ❓ About

    ReVanced Patcher is a library that is used to patch Android applications.
    It powers ReVanced Manager, ReVanced CLI and ReVanced Library and a rich set of patches have been developed using ReVanced Patcher in the ReVanced Patches repository.

    💪 Features

    Some of the features the ReVanced Patcher provides are:

    • 🔧 Patch Dalvik VM bytecode: Disassemble and assemble Dalvik bytecode
    • 📦 Patch APK resources: Decode and build Android APK resources
    • 📂 Patch arbitrary APK files: Read and write arbitrary files directly from and to APK files
    • 🧩 Write modular patches: Extensive API to write modular patches that can patch Dalvik VM bytecode, APK resources and arbitrary APK files

    🚀 How to get started

    To use ReVanced Patcher in your project, follow these steps:

    1. Add the repository to your project

    2. Add the dependency to your project:

       dependencies {
           implementation("app.revanced:revanced-patcher:{$version}")
       }
      

    For a minimal project configuration, see ReVanced Patches template.

    📚 Everything else

    📙 Contributing

    Thank you for considering contributing to ReVanced Patcher. You can find the contribution guidelines here.

    🛠️ Building

    To build ReVanced Patcher, you can follow the ReVanced documentation.

    📃 Documentation

    The documentation contains the fundamentals of ReVanced Patcher and how to use ReVanced Patcher to create patches. You can find it here.

    📜 License

    ReVanced Patcher is licensed under the GPLv3 license. Please see the license file for more information. tl;dr you may copy, distribute and modify ReVanced Patcher as long as you track changes/dates in source files. Any modifications to ReVanced Patcher must also be made available under the GPL, along with build & install instructions.