【免费下载链接】fqapp内容聚合 Android 客户端小说/短剧/漫剧/听书/漫画Flutter UI 进程内 Rust 核心无自建服务器、无需 root项目地址https://gitcode.com/gh_mirrors/fq/fqapp点击查看免费下载本文是一份面向新手开发者的 fqapp什锦铺源码构建完整指南。fqapp 是一个小说/短剧/漫剧/听书/漫画内容聚合 Android 客户端采用 Flutter UI 进程内 Rust 核心的混合架构无需自建服务器、无需 root。文章将带你走通从环境准备、Rust 核心 NDK 交叉编译到最终 APK 打包、真机验证的全过程。一、动手之前先看懂这个混合架构在敲第一条构建命令前花两分钟理解项目结构能帮你少走很多弯路目录作用lib/Flutter UI、数据模型与本地状态rust/Rust 原生核心fqapi_core源码签名、解密、设备池、分发器native/自行实现的 CENC MP4 流式解密 C 库Gradle 构建时由 CMake 自动编译scripts/构建、验证与资源生成脚本android/Android 工程与 JVM 测试构建链路只有三件事Rust 源码 →libfqapi_core.soNDK 交叉编译、C 源码 →libshortplay_crypto.soCMake 自动生成、两者打进 APK。架构与部署细节可查阅官方开发者文档 DEVELOPMENT.md。 注意仓库不含任何预编译二进制两个.so都必须由你自己构建生成——这正是本教程的重点。二、构建环境准备工具链版本清单fqapp 对工具链版本有严格固定的要求版本表如下工具版本用途Flutter3.44.6 (stable)构建 AppDart SDK3.12随 Flutter 自带Ruststable编译原生核心fqapi_coreflutter_rust_bridge2.13.0生成 Flutter/Rust 绑定Android SDK36 Build-Tools编译 APKJDK17Android Gradle 构建Android NDK28.2.13676358交叉编译 Rust 核心与 C 解密库CMake3.22.1Android 构建自动编译 C 库用 SDK Manager 安装缺失组件sdkmanager platforms;android-36 sdkmanager ndk;28.2.13676358 sdkmanager cmake;3.22.1⚠️NDK 版本必须精确匹配28.2.13676358。构建脚本会硬性校验版本号指向其它 NDK 会直接报错退出不会静默回退到最新安装的 NDK——这是刻意设计防止工具链悄悄改变导致构建结果不可复现。三、克隆仓库与获取依赖git clone https://gitcode.com/gh_mirrors/fq/fqapp cd fqapp flutter pub get --enforce-lockfile--enforce-lockfile会强制使用 pubspec.lock 中锁定的依赖版本保证多人构建结果一致。四、NDK 交叉编译 Rust 核心一条命令生成 libfqapi_core.so这是整个构建里最关键的一步。项目提供了单一入口脚本Linux / macOSscripts/build_rust_backend.shWindows PowerShellscripts/build_rust_backend.ps1./scripts/build_rust_backend.sh脚本内部自动完成四件事生成绑定运行flutter_rust_bridge_codegen generate按 flutter_rust_bridge.yaml 的配置生成 Dart/Rust 双向 FFI 绑定输入rust/src/api输出lib/src/rust/交叉编译用 NDK 自带的 clang 工具链编译aarch64-linux-androidarm64-v8a与armv7-linux-androideabiarmeabi-v7a两个目标自动归位把libfqapi_core.so复制到android/app/src/main/jniLibs/abi/供 Gradle 直接打包打印 SHA-256方便你核对产物。常用开关绑定已是最新时可加速./scripts/build_rust_backend.sh --skip-codegen # 跳过绑定生成 ./scripts/build_rust_backend.sh --profile debug # 调试配置 ./scripts/build_rust_backend.sh --host-lib # 额外构建桌面 cdylibCargo 按目标缓存编译结果没有改动 Rust 源码时重建会很快。C 解密库不需要你手动编译native/下的 CENC 流式解密库由 Gradle 的externalNativeBuild通过 native/CMakeLists.txt 在 APK 构建阶段自动编译并打包同样显式设置了 16 KiB ELF 页对齐参数无需任何额外操作。五、构建 APKdebug 与 release 两种姿势# 当前 Rust 核心主要面向 arm64 设备显式指定目标 ABI flutter build apk --debug --target-platform android-arm64 flutter build apk --release --target-platform android-arm64生成结果位于build/app/outputs/flutter-apk/app-debug.apk或app-release.apk。release 构建不要加--no-pubintegration_test在dev_dependencies里flutter test会把它写进插件注册表跳过 pub 步骤后 Gradle 会报package dev.flutter.plugins.integration_test does not exist。六、安装到真机并验证# 真机开启 USB 调试连接后 adb install -r build/app/outputs/flutter-apk/app-debug.apk adb shell am start -n com.fqapp.fqapp/.MainActivity首次启动流程App 将 config.json、过滤器等资源部署到应用私有目录通过 flutter_rust_bridge 在进程内初始化 Rust 核心轮询/health健康检查通过后进入主界面。几个实用调试命令# 查看后端日志 adb shell run-as com.fqapp.fqapp cat files/backend/backend.log # loopback 端口转发核心默认监听 127.0.0.1:18921 adb forward tcp:18080 tcp:18921 curl http://127.0.0.1:18080/health # Flutter 日志 adb logcat -s flutter如果内容解密乱码一般是设备池过期删除files/backend/config/device_pool.json后重启 App 即可自动重注册。七、构建后验证测试与 16 KiB 对齐检查# 按模块秒级跑测试子串匹配测试文件名 ./scripts/test_quick.sh home ./scripts/test_quick.sh --all # 交付前收尾全量 # Rust 核心测试 cargo test --manifest-path rust/Cargo.toml --locked # 检查 .so 的 ELF 16 KiB 对齐 node scripts/check_native_alignment.cjs android/app/src/main/jniLibs/arm64-v8a/libfqapi_core.soscripts/test_quick.sh 支持按模块名快速迭代拼错的模块词会直接报错不会静默少跑。八、常见构建错误速查表问题解决方案找不到 NDK 28.2.13676358sdkmanager ndk;28.2.13676358或设置ANDROID_NDK_HOME指向它Unable to locate Android SDKflutter config --android-sdk 路径Flutter requires Android SDK 36sdkmanager platforms;android-36Could not close incremental caches项目已在gradle.properties关闭 Kotlin 增量编译无需处理偶发The settings are not yet available for buildGradle 9.1.0 偶发 bug重跑即可恢复maven.google.com 超时仓库已配置阿里云镜像见 android/settings.gradle.kts九、不想本地配环境看看 CI 云端编译.github/workflows/android-apk.yml 固定了与上文一致的 Flutter 3.44.6、Rust 工具链、flutter_rust_bridge 2.13.0、JDK 17、NDK 28.2.13676358 和 CMake 3.22.1。推送代码或手动触发 Run workflow 后可在运行记录的Artifacts中下载app-release.apk含 SHA-256 与签名报告保留 14 天。CI 每次都会完整跑 Rust 测试、Flutter 静态分析、全量单元/组件测试并验证最终 APK。总结fqapp 源码构建的核心路径可以浓缩为一句话flutter pub get→scripts/build_rust_backend.*交叉编译 Rust 核心 →flutter build apk --target-platform android-arm64→ 真机验证。C 解密库由 CMake 自动接管CI 帮你兜底验证整条链路没有自建服务器、不需要 root也无需任何私有检出。祝你构建顺利构建产物跑起来的那一刻就是理解这个项目架构最好的方式。赞分享【免费下载链接】fqapp内容聚合 Android 客户端小说/短剧/漫剧/听书/漫画Flutter UI 进程内 Rust 核心无自建服务器、无需 root项目地址https://gitcode.com/gh_mirrors/fq/fqapp点击查看免费下载相关推荐MAS 一键激活3 步完成 Windows 11 与 Office 永久激活MAS 一键激活3 步完成 Windows 11 与 Office 永久激活 MASMicrosoft Activation Scripts是一款完全开源运维Android上的CMake构建ndk-samples如何配置NDK编译初学者完整教程Android上的CMake构建ndk samples如何配置NDK编译初学者完整教程 在 Android 上用 C/C 开发绕不开 Android示例工程移动开发Voltius源码构建实战开发者必备的安装、开发与Docker交叉编译完整教程Voltius源码构建实战开发者必备的安装、开发与Docker交叉编译完整教程 Voltius 是一款基于 Rust Tauri 构建的本地优先Loca上一篇终极指南如何使用Nrfr免Root安全修改SIM卡国家码轻松解决国际漫游难题下一篇三步画出笔线段中枢ChanlunX 缠论可视化插件上手笔记创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考