MozStumbler构建与发布快速指南一条命令搞定三渠道GitHub/PlayStore/F-DroidGradle构建【免费下载链接】MozStumblerAndroid Stumbler for Mozilla项目地址: https://gitcode.com/gh_mirrors/mo/MozStumblerMozStumblerAndroid Stumbler for Mozilla是一款免费的 Android 应用用于采集 WiFi 信号强度、蜂窝基站与 GPS 定位数据并将结果提交到 Mozilla Location ServicesMLS地图服务。本文带你用根目录的 Makefile 配合 Gradle快速构建 Debug 版 APK以及面向GitHub、Google PlayPlayStore、F-Droid三个发布渠道的 Release 版 APK并附 Android Studio 调试配置技巧。一、项目结构先认识两个 Gradle 模块MozStumbler 的构建入口高度集中打开 settings.gradle 可以看到只注册了两个模块:android—— 应用主体地图界面、定位、上传等:libraries:stumbler—— 核心服务库扫描、存储、上传线程带有独立的 gradlew 与测试体系所有构建动作统一收敛到根目录的 Makefile 中无需记忆冗长的 Gradle 命令。二、一条命令构建 Debug 版在 Linux/macOS 终端中make debug它实际执行./gradlew assembleGithubDebug产出的 Debug 版 APK 位于android/build/outputs/apk/下。如果已连接手机可以直接make install_debug 小技巧Debug 版在 android/build.gradle 中设置了applicationIdSuffix .debug包名带.debug后缀可以与你手机上安装的正式版共存互不影响。三、三渠道 Release 构建详解 Makefile 为三个发行渠道各准备了一个 target一条命令即可出包渠道命令Gradle 任务发布前检查GitHubmake githubassembleGithubRelease✅ release_check.pyGoogle Playmake playstoreassemblePlaystoreRelease✅ release_check.pyF-Droidmake fdroidassembleFdroidRelease无使用仓库内公开密钥构建流程分为三步值得了解一下背后的设计1. 密钥预检查release_check.pyGitHub 与 PlayStore 渠道在执行构建前会先运行 release_check.py校验android/properties/private-渠道.properties文件中必须包含MapAPIKeyMapbox 地图密钥和MozAPIKeyMozilla Location Service 数据提交密钥防止因缺少密钥打包出残废版本。密钥模板见 android/properties/example.properties。2. Gradle 按 Flavor 注入配置android/build.gradle 中定义了productFlavorsflavorDimensions appstore每个 flavor 通过buildConfigField注入各自的MOZILLA_API_KEY与TILE_SERVER_URL。也就是说同一份源码三个渠道各带各的密钥互不干扰。F-Droid 渠道直接使用仓库内的公开配置 android/properties/private-fdroid.properties因此无需预检查。3. 按 Git 标签重命名产出 APK构建完成后rename_release.sh 会把MozStumbler-渠道-release.apk重命名为MozStumbler-git标签.apk并复制到outputs/目录方便直接分发。版本号规则同样定义在 android/build.gradleversionCode 主版本×1000000 次版本×10000 补丁×100例如 3.2.1 对应 3020100。# 完整发布流程示例 make github # 产出 outputs/MozStumbler-tag.apk四、Android Studio 中的构建运行配置想在 Android Studio 里一键构建安装只需配置一个 Gradle-aware Make 运行项新建 Android Application 配置在 Run 菜单选择 Edit Configurations点击添加Android Application见下图红箭头Installation Options 设为 Deploy Nothing——安装工作交给 Gradle 任务避免重复部署添加两个 Gradle 任务:android:assembleGithubDebug与:android:installGithubDebug。输入:android时 Android Studio 会自动补全任务名。配置完成后点击绿色运行按钮即可构建并安装 Debug 版到已连接的 USB 设备。五、单元测试与清理 Makefile 同样覆盖了测试与清理场景命令作用make test先跑库模块测试再执行testGithubUnittestmake libtest仅运行libraries/stumbler的单元测试make clean删除outputs/、库模块 build 目录并执行gradlew clean./test.sh 测试类名按类名过滤运行指定单元测试见 test.sh./test.sh ReporterTest # 只跑 ReporterTest 这一个测试类六、快速上手清单✅ 首次体验make debug→make install_debug五分钟跑起来✅ 发 GitHub 包备好private-github.properties密钥文件后执行make github✅ 发 F-Droid 包零配置直接make fdroid✅ 想深入源码核心扫描逻辑在 libraries/stumbler/src/main/java/org/mozilla/mozstumbler/service/stumblerthread/scanners/HTTP 提交在 libraries/stumbler/src/main/java/org/mozilla/mozstumbler/service/core/http/掌握这套 Makefile 三渠道构建体系后无论是本地调试还是为任意发行渠道打包MozStumbler 都能做到一条命令出包。祝你构建顺利【免费下载链接】MozStumblerAndroid Stumbler for Mozilla项目地址: https://gitcode.com/gh_mirrors/mo/MozStumbler创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考