Skip to content

Anabranch CoreJava 8 与 Android 多源分块下载库

零第三方依赖、适配 minSdk 21 的纯 Java 分块调度核心,支持多镜像竞速、失败切源、跨源续传与逐块 SHA-256 校验,另有独立封装的可选 aria2 JNI 后端。

能力定位与明确边界 ​

能做到什么程度(已实现能力)

  • 零依赖纯 Java 8 多源并发:仅 19 个 Apache-2.0 源文件(零 android.* 与三方库,兼容 minSdk 21 免 desugaring),支持 Policy.fastestFirst()(EMA 吞吐/并发)与 weighted() 并发调度及 .part + anabranch-meta/2 跨源断点续传。
  • 失败预算熔断与强摘要检验:默认单块 6 次退避与 chunkRetryBudgetMs(60s 纯失败计时),逐块与整份 SHA-256 检验后原子重命名;支持插拔自定义 Engine(如 OkHttp)、Policy 与 Source.Resolver。
  • 可选 aria2 原生后端隔离:通过独立 GPL-3.0-or-later anabranch-aria2 AAR 无缝切换 libaria2,不污染纯 Java 调用方许可证与体积。

明确不能做什么(非目标与硬限制)

  • 严格无状态下载库:不内置镜像 URL 清单、不持久化全局配置、不承担压缩包解压或 APK 安装、不构建 UI 或 Android 前台服务。
  • 已知契约与发版约束:Source.maxChunks 目前仅作元数据尚未做单源并发硬限;Aria2Downloader 全局 BUSY 串行且不走 Core Policy;Maven Central 为手动发版(集成前须先确认在线可用或直接编源码)。

架构全景 ​

多源分块调度与状态持久化架构(基于 Archify 的交互式拓扑,支持平移/缩放/探查)

最小调用示例 ​

java
Downloader dl = Downloader.newBuilder()
    .defaultChunks(8)
    .maxConcurrent(4)
    .chunkRetryBudgetMs(60_000)
    .build();

SourceSet sources = new SourceSet(Arrays.asList(
    Source.ofBase("cdn-a", "https://cdn-a.example.test/pkg/"),
    Source.ofBase("cdn-b", "https://cdn-b.example.test/pkg/")),
    Policy.fastestFirst());

Result res = dl.download(
    new Request("app.bin", new File("out/app.bin"), integrity, 8, true),
    sources, Listener.NONE, Cancellation.NONE);

文档分层导航 ​

按照读者需求快速跳转