)
Foxy Droid源码编译教程从零配置SDK、签名并构建安装开发者指南【免费下载链接】foxy-droidYet another F-Droid client项目地址: https://gitcode.com/gh_mirrors/fo/foxy-droidFoxy 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 中的配置项目使用了较旧的构建栈请按以下版本准备环境组件版本要求说明JDK8推荐项目编译目标为 Java 8Gradle5.1.1由 gradle/wrapper/gradle-wrapper.properties 自动指定Android Gradle Plugin3.4.1见 build.gradleKotlin1.3.72自动下载Android SDK PlatformAPI 29compileSdkVersion 29Build-Tools29.0.3buildToolsVersion 29.0.3应用最低版本Android 5.0API 21minSdkVersion 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.propertiesFoxy 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.passwordkey-store-password key.aliasmy-key-alias key.passwordkey-password⚠️ 注意store.file使用绝对路径最稳妥key.alias要与 keytool 中的 alias 一致。 安全提示keystore.properties和密钥库文件包含密码切勿提交到代码仓库或分享给他人。第四步执行 Gradle 构建在项目根目录运行构建命令首次运行会自动下载 Gradle 5.1.1 和依赖耗时较长# 构建 release 包带 R8 混淆见 proguard.pro ./gradlew assembleRelease # 或者只构建 debug 包速度更快 ./gradlew assembleDebugWindows 用户请使用 gradlew.batgradlew.bat assembleRelease构建成功后APK 输出位置archivesBaseName为foxy-droidbuild/outputs/apk/release/foxy-droid-release.apk build/outputs/apk/debug/foxy-droid-debug.apk应用包名为nya.kitsunyan.foxydroid版本号为 1.3versionCode 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 versionJDK 版本过高AGP 3.4.1 请使用 JDK 8签名配置未生效检查keystore.properties四项是否齐全且路径正确四项任一为空则跳过签名配置小结本文完成了 Foxy Droid 源码编译的完整流程✅ 准备 JDK 8 Android SDKAPI 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),仅供参考