资讯详情

从源码构建LSFG-Android实战指南:NDK 27、CMake 3.22与git子模块环境搭建全流程

📅 2026/10/29 19:50:16 | 华诺云谱 👁 阅读
从源码构建LSFG-Android实战指南:NDK 27、CMake 3.22与git子模块环境搭建全流程
【免费下载链接】LSFG-AndroidLossless Scaling Frames Generator (LSFG) Application for Android项目地址https://gitcode.com/gh_mirrors/ls/LSFG-Android点击查看免费下载LSFG-Android 是一款运行在安卓设备上的帧生成应用Lossless Scaling Frames Generator通过 MediaProjection 截屏流 系统叠层在 GPU 上执行 LSFG_3_1 插帧流水线。本文带你完整走一遍 LSFG-Android 源码构建流程NDK 27.0.12077973 与 CMake 3.22.1 工具链配置、git 子模块初始化直到一条命令打包出可直接安装的 APK。上图是构建完成并装进真机后的实际帧生成效果左上角 HUD 显示real 30 fps / total 61 fps与帧时序曲线正是源码构建要达到的最终目标。 项目结构一个应用 一个帧生成子模块仓库根目录本身并不是 Gradle 工程真正的构建入口分散在两个 git 子模块中目录角色LSFG-Android-Application/Android Studio 工程Kotlin Jetpack Compose UI、JNI/C 渲染循环gradlew就在这里lsfg-vk-android/Vulkan 帧生成库 framegen附带 Android 专属补丁#ifdef __ANDROID__隔离不影响 Linux 构建路径两者的衔接在 CMakeLists.txt 中完成CMake 通过相对路径../../../../../lsfg-vk-android直接add_subdirectory()编译framegen静态库并链接进liblsfg-android.so——不需要预编译的 .so构建 App 即构建帧生成库。⚠️ 两个关键推论子模块必须检出否则 CMake 会直接FATAL_ERROR提示 Did you clone the submodules?两个目录不能移动或改名否则会破坏相对路径引用native 构建必然失败。子模块定义在 .gitmodules分别指向lsfg-vk-androidrelease 分支与LSFG-Android-Application。 git 子模块环境搭建一步克隆到位推荐克隆时直接加--recurse-submodules避免漏掉子模块初始化git clone --recurse-submodules https://gitcode.com/gh_mirrors/ls/LSFG-Android cd LSFG-Android如果已经克隆过、或子模块目录是空的补跑git submodule update --init --recursive git submodule status # 确认两个子模块都已就位常见坑个别环境下子模块无法从其源地址拉取可手动修改 .gitmodules 中对应的url字段为可访问的镜像仓库地址再重新执行git submodule update --init。️ 工具链清单NDK 27 与 CMake 3.22 装哪些版本构建参数在 app/build.gradle.kts 中被硬性锁定请严格对齐组件要求版本配置位置Android StudioLadybug 及以上AGP 8.5.2IDENDK27.0.12077973ndkVersionCMake3.22.1externalNativeBuild.cmake.versionJDK17sourceCompatibilityGradle8.9gradle-wrapper.propertieswrapper 自动下载C 标准C20CMakeLists.txtminSdk / targetSdk29 / 35Android 10 / 15defaultConfig操作步骤Android Studio →SDK Manager → SDK Tools勾选安装NDK (Side by side) 27.0.12077973和CMake 3.22.1。若本机已装其他 NDK 版本以build.gradle.kts中的ndkVersion声明为准缺失时 Gradle 会直接报错提示版本。另外注意 ABI 策略splits.abi同时构建arm64-v8a生产真机与x86_64仅模拟器各产出一个 APK。⚡ 执行构建一条 gradlew 命令产出 APKcd LSFG-Android/LSFG-Android-Application ./gradlew :app:assembleDebugAPK 输出在app/build/outputs/apk/debug/按 ABI 各一个如app-arm64-v8a-debug.apk安装到设备adb install -r app/build/outputs/apk/debug/app-arm64-v8a-debug.apkRelease 构建签名参数不入库参照 gradle.properties.example把LSFGAndroid_STORE_FILE等 4 个变量复制到用户级~/.gradle/gradle.propertiesWindows 为%USERPROFILE%\.gradle\gradle.properties。未配置时 release 会静默回退到 debug 签名。生成 keystorekeytool -genkey -v -keystore my-release.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-key-aliasrelease 构建还会启用 ThinLTONDK r27 稳定支持与 R8 混淆链接时间更长但包体更小。 构建失败高频原因排查现象原因解决CMakeFATAL_ERRORCant find lsfg-vk sources … Did you clone the submodules?子模块未初始化git submodule update --init --recursive报同样错误但目录看起来存在移动/重命名过lsfg-vk-android或LSFG-Android-Application恢复为仓库根目录并排布局找不到 CMake 3.22.1SDK Tools 未安装对应版本SDK Manager 勾选安装NDK 版本不匹配报错未安装 27.0.12077973 或路径指向了别的 NDK按上表版本安装并核对ndkVersion改了 framegen 源码但没重新编译一般不会遇到工程已通过CMAKE_CONFIGURE_DEPENDS把 framegen 全树纳入监听无需手工干预 构建成果验证真机上跑起帧生成装好后授予悬浮窗与 MediaProjection 录屏权限即可使用。硬件门槛Vulkan 1.2 与VK_EXT_robustness2Adreno 7xx 级及以上 GPU 验证可用缺少时应用只会退化为纯镜像模式。另外该应用仅限侧载分发且需要你自备正版Lossless.dll应用会在设备上提取着色器后删除 DLL 副本。设置抽屉可实时调节帧倍率2×–8×、Flow scale、pacing 预设与 vsync 对齐多数参数走热更新不需要重建 Vulkan 上下文。HUD 的real X fps / total Y fps计数与帧节奏图是验证帧生成是否真正生效最直观的方式。延伸阅读均在仓库内根目录 README.md构建说明、平台限制与组件总览lsfg-vk-android/README.mdframegen 库与 Android 补丁的逐文件差异lsfg-vk-android/framegen/CMakeLists.txt帧生成静态库的源码清单赞分享【免费下载链接】LSFG-AndroidLossless Scaling Frames Generator (LSFG) Application for Android项目地址https://gitcode.com/gh_mirrors/ls/LSFG-Android点击查看免费下载相关推荐用 OpenCore Legacy Patcher 4 步给老 Mac 装上最新 macOS完整指南用 OpenCore Legacy Patcher 4 步给老 Mac 装上最新 macOS完整指南 OpenCore Legacy Patcher下称桌面应用操作系统固件DroidVM从源码构建APK完整教程Android Studio、NDK与CMake配置全流程DroidVM从源码构建APK完整教程Android Studio、NDK与CMake配置全流程 DroidVM 是一款运行在安卓手机上的虚拟机管理器 支持Krita Android 构建实战指南从 NDK/SDK 环境搭建到 APK 安装与崩溃调试Krita Android 构建实战指南从 NDK/SDK 环境搭建到 APK 安装与崩溃调试 Krita 是构建在 KDE 与 Qt 框架之上的开源跨平台数图形学桌面应用上一篇为什么 V3SP3R 是 2026 年最强大的 AI 硬件控制神器新手必读指南下一篇Booth实战指南用CMake的find_package(Booth)把CUDA内核编译融入你的项目构建创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
📝

华诺云谱内容团队

资深建站顾问 · 行业研究员

10年+企业数字化服务经验,专注智能建站、SEO优化与品牌营销,持续输出建站技巧、行业洞察与营销干货,已帮助5000+企业实现数字化增长。

你可能需要的服务

订阅华诺云谱资讯周报

每周一封,精选建站技巧、SEO与营销干货,直达邮箱。已有 8,000+ 企业主订阅,助你少走弯路。

↑