WinterWolfVN/Support-Old-Android-Docs
GitHub: WinterWolfVN/Support-Old-Android-Docs
该项目提供了一套配置指南，通过脱糖技术和字节码修补使旧版 Android 设备能够支持现代 Java 17 特性及 NIO 框架。
Stars: 1 | Forks: 0
# 支持 Android 旧版文档
一份在旧版 Android 设备 (API 21+) 上实现现代 Java 特性和框架的技术指南和资源库。
## 概述
随着 Android 开发迈向 API 34+，许多开发者由于缺乏现代 Java API 支持（如 `java.nio.file`）以及无法运行现代修改框架而放弃了对旧版本的支持。本项目提供了一种经过验证的配置，通过高级脱糖技术和手动字节码修补来弥补这一差距。
## 案例研究：Android 7.1.1 (API 25) 上的 LSPatch
LSPatch/NPatch 的标准实现通常针对 Android 8.1+ (API 27+)。通过此处记录的方法，我们已成功在一台运行 **Android 7.1.1** 的 **Oppo F5** 上启用了这些框架。
### 关键组件：`desugar_jdk_libs_nio:2.1.5`
通过利用最新的脱糖库，我们可以将以下内容向后移植到旧版设备：
* **Java 11/17 语法：** 在 API 21+ 上使用现代编码标准。
* **NIO 支持：** 启用 `java.nio.file` 和相关文件操作 API。
* **现代时间 API：** 完全支持 `java.time`。
## 1. Gradle 配置
根据您的项目结构，选择以下方法之一来实现现代 Java 支持。
## 选项 A：经典实现（直接）
适用于快速测试或尚未使用 Version Catalogs 的旧项目。
更新您的 `build.gradle` (Module: app)：
```
android {
compileOptions {
// Enable Core Library Desugaring
coreLibraryDesugaringEnabled true
sourceCompatibility JavaVersion.VERSION_17
targetCompatibility JavaVersion.VERSION_17
}
}
dependencies {
// Direct dependency for java.nio and Java 17 support
coreLibraryDesugaring("com.android.tools:desugar_jdk_libs_nio:2.1.5")
}
```
## 选项 B：现代实现（Version Catalog）
推荐使用 Gradle 7.4+ 的专业项目，以便更好地管理依赖。
**步骤 1**：添加到 `gradle/libs.versions.toml`
```
[versions]
desugar_jdk_libs = "2.1.5"
[libraries]
desugar-jdk-libs-nio = { group = "com.android.tools", name = "desugar_jdk_libs_nio", version.ref = "desugar_jdk_libs" }
```
**步骤 2**：应用到 `build.gradle` (Module: app)：
```
android {
compileOptions {
coreLibraryDesugaringEnabled true
sourceCompatibility JavaVersion.VERSION_17
targetCompatibility JavaVersion.VERSION_17
}
}
dependencies {
// Reference from the Version Catalog
coreLibraryDesugaring(libs.android.tools.desugarJdkLibsNio)
}
```
### 选项 C：Kotlin DSL (`build.gradle.kts`)
对于使用基于 Kotlin 构建脚本的项目：
```
android {
compileOptions {
isCoreLibraryDesugaringEnabled = true
}
}
dependencies {
coreLibraryDesugaring(libs.android.tools.desugarJdkLibsNio)
// OR
coreLibraryDesugaring("com.android.tools:desugar_jdk_libs_nio:2.1.5")
}
```
## 2. 代码实现与修补
这不仅仅是添加依赖项；更重要的是修改核心逻辑以有效地利用向后移植的 API。
## 在旧版设备上使用 NIO（Java 示例）
一旦启用脱糖，您就可以安全地使用 java.nio.file.Files 在修改框架中处理复杂的文件结构，而不会在 Android 7 上触发 NoClassDefFoundError：
```
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
public class LegacyFileHandler {
public static void processModFiles(String targetPath) {
try {
Path path = Paths.get(targetPath);
if (!Files.exists(path)) {
Files.createDirectories(path);
}
// Safely read/write bytes using modern NIO on API 25
byte[] modData = Files.readAllBytes(path);
} catch (Exception e) {
e.printStackTrace();
}
}
}
```
## Smali 注入流程
对于已经编译好的框架，仅依赖 Gradle 是不够的。我们利用 MT Manager 等工具手动编辑 Smali 逻辑，并将现代 API 调用映射到由 R8 生成的脱糖类。
**步骤 1**：反编译目标 APK（例如 Discord 或 NPatch 框架）。
**步骤 2**：找到指向 Ljava/nio/file/Files; 的 invoke-static 或 invoke-virtual 调用。
**步骤 3**：确保脱糖后的 DEX 类 (j$.nio.file.*) 已正确打包，并重定向 Smali 逻辑（如果 Epic Framework 需要手动映射才能成功 Hook）。
## 为什么旧版支持很重要
虽然“计划性报废”在科技行业很常见，但全球仍有数百万设备运行在 Android 5.0 至 7.1 上。通过适当的优化和手动代码调整，这些设备无需彻底重写源代码即可保持功能性并与现代工具兼容。
## 项目里程碑
* **2026-04-08：** 官方仓库启动和技术文档发布。
* **2026-04-08：** 在发布后仅 **30 分钟**内，便在 `r/AndroidDev` 上跻身 **Top 3 Trending**（热门趋势前三）。
* **概念验证：** 在运行现代 Java 17 和基于 NIO 的框架的 Oppo F5 (Android 7.1.1 / API 25) 上成功验证。
* **2026-04-09：** 全球浏览量超过 **1,200+**，并在 `r/AndroidDev` 上跻身当日 **Top 13 Trending Post**（热门帖子第 13 名）。
* **社区影响：** 获得开发者社区的高度参与，证明了旧版设备优化的持续相关性。
## 常见问题
## Q：这会显著影响 APK 大小吗？
A：由于脱糖库的存在，会有轻微的开销，但这是在旧版 API 级别上获得完整 Java 17/NIO 支持所必需的权衡。
## Q：此配置稳定吗？
A：是的。它已在真实硬件（Oppo F5, API 25）上经过重度修改工具的彻底测试。
标签：Android 7.1.1, Android开发, Android旧版兼容, API 21+, Desugaring, Gradle配置, Java 11, Java 17, java.nio.file, java.time, JS文件枚举, LSPatch, NPatch, Oppo F5, 代码混淆, 反向移植, 后台面板检测, 字节码修补, 框架兼容, 移动应用安全