Foxy Droid源码编译教程：从零配置SDK、签名并构建安装（开发者指南）
【免费下载链接】foxy-droidYet another F-Droid client项目地址: https://gitcode.com/gh_mirrors/fo/foxy-droid
Foxy Droid 是一款经典风格的 F-Droid 客户端（非官方第三方应用商店），本教程带你完成Foxy Droid 源码编译全流程：配置 Android SDK、生成签名密钥、执行 Gradle 构建，最终得到一个可安装的 APK。项目采用 Kotlin 开发，依赖极少、构建简单，非常适合新手作为第一个 Android 源码编译练习。
Foxy Droid 是什么？
在开始编译前，先了解一下你正在构建的应用。Foxy Droid 是一款"Yet another F-Droid client"，主打经典简洁的 F-Droid 风格：
- 📦 管理 F-Droid 仓库，快速同步索引
- ⚡ 无卡片式布局、无花哨动画，标准 Android 组件
- 🔒 无需特权扩展、无需 root 安装
- 📄 开源协议：GNU GPLv3+
编译成功后，你会看到类似下面的界面：浅色/深色主题下的"可安装 / 已安装 / 更新"标签页，以及应用详情页。
编译环境准备清单
根据 build.gradle 中的配置，项目使用了较旧的构建栈，请按以下版本准备环境：
| 组件 | 版本要求 | 说明 |
|---|---|---|
| JDK | 8（推荐） | 项目编译目标为 Java 8 |
| Gradle | 5.1.1 | 由 gradle/wrapper/gradle-wrapper.properties 自动指定 |
| Android Gradle Plugin | 3.4.1 | 见 build.gradle |
| Kotlin | 1.3.72 | 自动下载 |
| Android SDK Platform | API 29 | compileSdkVersion 29 |
| Build-Tools | 29.0.3 | buildToolsVersion '29.0.3' |
| 应用最低版本 | Android 5.0（API 21） | minSdkVersion 21 |
💡 提示：使用 Android Studio 的 SDK Manager 安装 "Android 10 (API 29)" 和 "Build-Tools 29.0.3" 即可。
第一步：获取源码
将项目克隆到本地（仓库地址见上文说明处统一提供，此处以 git clone 为例）：
git clone https://gitcode.com/gh_mirrors/fo/foxy-droid.git cd foxy-droid项目结构非常精简，核心目录如下：
- src/main/kotlin/nya/kitsunyan/foxydroid/ —— 全部 Kotlin 源码，按 content / database / entity / network / screen / service 等模块组织
- src/main/AndroidManifest.xml —— 应用清单，声明了网络、安装/卸载包等权限
- build.gradle —— 构建与签名配置
- gradle.properties —— 启用 AndroidX
第二步：配置 Android SDK 路径
构建脚本需要知道 Android SDK 的位置，两种方式任选其一：
方式一：设置环境变量ANDROID_HOME
# Linux / macOS（写入 ~/.bashrc 或 ~/.zshrc 可持久化） export ANDROID_HOME=/path/to/android-sdk方式二：创建local.properties文件
在项目根目录新建local.properties（该文件已被 .gitignore 排除，不会提交到仓库）：
sdk.dir=/path/to/android-sdk第三步：生成签名密钥并配置 keystore.properties
Foxy Droid 的签名配置是"可选"的：build.gradle 会自动检测根目录下的keystore.properties文件，存在时即为 debug 和 release 两个构建类型统一签名（对应逻辑见 build.gradle 第 82~110 行的 keystore 检测段落）。
1. 使用 keytool 生成密钥库
keytool -genkeypair -v \ -keystore my-release-key.keystore \ -alias my-key-alias \ -keyalg RSA -keysize 2048 \ -validity 10000按提示输入密码、姓名、组织等信息（Subject 信息可随意填写，个人编译用途即可）。
2. 创建keystore.properties
在项目根目录创建该文件，内容如下：
store.file=/path/to/my-release-key.keystore store.password=key-store-password key.alias=my-key-alias key.password=key-password⚠️ 注意：
store.file使用绝对路径最稳妥；key.alias要与 keytool 中的 alias 一致。🔐 安全提示：
keystore.properties和密钥库文件包含密码，切勿提交到代码仓库或分享给他人。
第四步：执行 Gradle 构建
在项目根目录运行构建命令（首次运行会自动下载 Gradle 5.1.1 和依赖，耗时较长）：
# 构建 release 包（带 R8 混淆，见 proguard.pro） ./gradlew assembleRelease # 或者只构建 debug 包（速度更快） ./gradlew assembleDebugWindows 用户请使用 gradlew.bat：
gradlew.bat assembleRelease构建成功后，APK 输出位置（archivesBaseName为foxy-droid）：
build/outputs/apk/release/foxy-droid-release.apk build/outputs/apk/debug/foxy-droid-debug.apk应用包名为nya.kitsunyan.foxydroid，版本号为 1.3（versionCode 4）。
第五步：安装到设备
将 APK 拷贝到手机并安装即可（Android 5.0 及以上）：
# 连接设备后，直接用 adb 安装 adb install build/outputs/apk/release/foxy-droid-release.apk安装完成后打开应用，在菜单中添加 F-Droid 仓库（默认官方仓库），同步后即可浏览和更新软件：
常见编译问题排查
| 问题 | 原因与解决 |
|---|---|
SDK location not found | 未配置 SDK 路径，按第二步设置ANDROID_HOME或local.properties |
| 依赖下载失败 | build.gradle 使用jcenter()仓库（已停用），可将其替换为google()+mavenCentral() |
Unsupported class file major version | JDK 版本过高，AGP 3.4.1 请使用 JDK 8 |
| 签名配置未生效 | 检查keystore.properties四项是否齐全且路径正确，四项任一为空则跳过签名配置 |
小结
本文完成了 Foxy Droid 源码编译的完整流程：
- ✅ 准备 JDK 8 + Android SDK（API 29 / Build-Tools 29.0.3）
- ✅ 克隆源码并配置
ANDROID_HOME或local.properties - ✅ 用 keytool 生成密钥，编写
keystore.properties自动签名 - ✅ 运行
./gradlew assembleRelease产出 APK - ✅ 通过 adb 或手动安装到设备
Foxy Droid 源码结构清晰、依赖极简（Kotlin + OkHttp + RxJava3 + Jackson），如果你掌握了这篇Foxy Droid 源码编译教程，再去阅读 src/main/kotlin/ 下的仓库同步逻辑（RepositoryUpdater.kt）或下载服务（DownloadService.kt）也会轻松很多。祝你编译顺利！
【免费下载链接】foxy-droidYet another F-Droid client项目地址: https://gitcode.com/gh_mirrors/fo/foxy-droid
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
