如何快速从源码构建 Seal Plus:本地编译、开发环境配置与贡献者入门指南
如何快速从源码构建 Seal Plus:本地编译、开发环境配置与贡献者入门指南
Seal Plus 是一款运行在 Android 上的视频/音频下载器,基于 yt-dlp 支持从 1000+ 平台下载视频。想要本地编译、打包出属于自己的 APK,或为这个开源项目贡献代码?这篇指南带你从零配置开发环境到产出可安装的 Seal Plus 安装包,新手也能一次跑通。
构建 Seal Plus 前的环境准备
Seal Plus 是一个标准的 Android 工程,采用 Kotlin + Jetpack Compose 开发。按照 gradle/libs.versions.toml 中锁定的版本,本地编译需要满足以下条件:
- Android Studio:建议使用较新的稳定版(官方贡献文档建议使用最新版,见 CONTRIBUTING.md)
- JDK 21:工程在 app/build.gradle.kts 中通过
jvmToolchain(21)要求 Java 21,编译源码兼容级别同样锁定为JavaVersion.VERSION_21 - Android SDK 37:
compileSdk = 37、targetSdk = 37,首次构建时 Android Studio 会自动提示安装缺失的 SDK 组件 - Android 设备:应用
minSdk = 24,即 Android 7.0 及以上的真机或模拟器均可运行
💡 建议在 Android Studio 中安装 Android 37 的 System Image,并预留约 10 GB 磁盘空间用于 Gradle 依赖下载。
了解项目结构:三个 Gradle 模块
打开工程后,可以在 settings.gradle.kts 中看到工程名 "Seal Plus" 以及两个子模块:
| 模块 | 路径 | 职责 |
|---|---|---|
:app |
app/ | 应用主体:UI、下载引擎、数据库 |
:color |
color/ | 内置的 Monet 动态取色库,用于 Gradient Dark 主题 |
buildSrc |
buildSrc/ | 存放版本号定义 Version.kt,所有模块可直接引用 currentVersion |
几个对开发者很关键的文件:
- gradle.properties:全局 Gradle 参数,其中
ABI_FILTERS=arm64-v8a指定了默认打包的 CPU 架构,org.gradle.jvmargs=-Xmx4096m为构建过程分配了 4 GB 堆内存 - app/build.gradle.kts:应用级构建配置,包含应用 ID、签名、APK 拆分等
- app/proguard-rules.pro:release 构建的混淆规则
一键导入与首次编译步骤
-
克隆仓库到本地:
git clone https://gitcode.com/gh_mirrors/se/Sealplus -
用 Android Studio 打开项目根目录,选择 "Open" 后等待 Gradle Sync 完成(首次同步会下载全部依赖,耗时取决于网络)。
-
连接真机或启动模拟器,点击工具栏 Run ▶ 按钮,即可安装 debug 版本到设备。debug 变体会自动附加
.debug的应用 ID 与-debug版本名后缀(见 app/build.gradle.kts)。 -
如果只需要命令行构建,可以直接使用工程内置的 Gradle Wrapper:
./gradlew assembleDebug
产出 APK:理解构建产物命名规则
在 app/build.gradle.kts 中,产物文件名被统一设置为 SealPlus-<版本名>-<架构>.apk。默认情况下工程启用了 ABI 拆分(splits.abi),会同时为 arm64-v8a、armeabi-v7a、x86、x86_64 四种架构各生成一个 APK,外加一个 universal 全量包。
构建完成后,APK 位于 app/build/outputs/apk/ 目录下,直接用数据线或 adb 推送即可安装。
编译常见问题排查
- Gradle 同步失败 / 内存不足:在
gradle.properties中确认-Xmx4096m生效;低内存机器可临时调小,但 KSP + Compose 编译器对内存较敏感。 - 找不到 Android 37 SDK:打开 Android Studio 的 SDK Manager 安装对应 Platform 后重新 Sync。
- release 构建缺少签名:release 渠道依赖根目录下的
keystore.properties文件(见 app/build.gradle.kts)。该文件不在仓库中,本地没有它时构建会自动跳过签名配置,日常开发用 debug 变体即可,无需配置。 - 格式检查不通过:工程集成了 ktfmt(
kotlinLangStyle()),提交前可执行./gradlew ktfmtCheck校验代码风格。
参与贡献:从源码构建到提交 PR
完成本地构建后,你已经具备了提交贡献的基础。项目对贡献流程的说明见 CONTRIBUTING.md:
- 提交 Bug 报告前先搜索已有 issue(包括已关闭的),并使用现有模板提供足够信息;
- 功能请求以"为通用模式增加快捷选项"为原则,Seal Plus 定位为 yt-dlp 的图形化封装;
- 直接提交代码前,请先在相关 issue 下留言说明改动内容,避免多人重复实现;
- 新手建议从带有 👋 good first issue 标签的问题入手,仓库还准备了多语言翻译目录 translations/,本地化翻译是很友好的入手点。
行为准则参考 CODE_OF_CONDUCT.md,项目遵循开源许可 LICENSE 条款。
常见问题(FAQ)
Q:为什么必须用 Java 21?
A:工程通过 jvmToolchain(21) 锁定语言工具链,Gradle 会自动下载对应的 JDK 21 运行时,一般无需手动安装。
Q:构建速度太慢怎么办?
A:gradle.properties 中已启用配置缓存(org.gradle.configuration-cache=true),二次构建会明显提速;可考虑在配置中打开 org.gradle.parallel=true 并行编译。
Q:编译出来的 APK 能直接发布吗? A:本地构建的 debug 包适合自用与测试;release 包需要项目维护者的签名配置,普通贡献者无需关心。

