编译 OLLVM环境准备

这里使用的是AGP 7.2.2NDK 25.2.9519653llvm 14.0.7cmake 3.22.1python39

git

用来下载源码

python

搞到这一步环境变量里应该已经有python了吧

NDK

AGP 的 7.2.2 版本默认使用的 NDK 版本为21.4.7075529,对应的 LLVM 为9.0.9

需要根据实际情况选择 NDK 对应的 LLVM 版本,编译 OLLVM,LLVM 版本号可以通过Sdk_DIR\ndk\$version\toolchains\llvm\prebuilt\windows-x86_64\AndroidVersion.txt文件看到,如SDK Manager 中的最新版本25.2.9519653为:

14.0.7based on r450784d1for additional information on LLVM revision and cherry-picks, see clang_source_info.md

在 module 的build.gradle中指定 NDK 版本

android {    ndkVersion "25.2.9519653"}

OLLVM

可以在 github/heroims/obfuscator 仓库的分支中找到对应的移植源码,

13x14x版本也可以在 github/yangyiyu08/ollvm-project 仓库的对应分支中获取。14x版本还可以直接在 Releases 中下载作者编译好的文件,跳过编译的步骤。但这个文件在我的环境下会有NDK编译错误的情况,我自己编译出来的文件运行正常。

这里使用NDK 25.2.9519653,需要下载 14x 的源码。

CMAKE

AGP 的 7.2.2 版本默认使用的 cmake 版本为3.18.1,在指定 NDK 版本到 25.2.9519653 后,会在编译时提示需要升级到 3.19 版本以上的信息。所以这里在编译前就通过 SDK Manager 下载 3.22.1 版本,并把所在目录添加到环境变量

同时在build.gradleCMakeLists中修改工程的 cmake 版本。

开始编译

在源码的目录执行以下命令构建 cmake 配置
cmake -S llvm -B build -G Ninja -DLLVM_ENABLE_PROJECTS="clang" -DCMAKE_BUILD_TYPE=Release -DLLVM_INCLUDE_TESTS=OFF -DLLVM_ENABLE_NEW_PASS_MANAGER=OFF

对应的参数:

-G Ninja: 使用 ninja 进行编译源码
-DLLVM_ENABLE_PROJECTS=”clang”: 启用clang,有多个选择 但我们只需要clang,官方文档有说明
-DCMAKE_BUILD_TYPE=Release: 构建 release 版本,比 debug 版本编译快很多
-DLLVM_INCLUDE_TESTS=OFF: 关闭 llvm 的头文件测试,也是为了加快编译速度
-DLLVM_ENABLE_NEW_PASS_MANAGER=OFF: 这个非常重要,llvm-12.x 开始默认使用 newPM进行编译源码,导致 ollvm 不起作用!因此,需要加上这个参数禁用掉 newPM。(在每个编译时增加flag -flegacy-pass-manager 让 llvm 不走 newPM 编译也可以,但没必要)

执行以上命令后若提示 Configuration done. 则配置成功。接下来执行以下命令开始编译:
cmake --build build -j16

其中-j16为指定的线程数,需要根据 CPU 调整。然后等待编译完成

编译完成

编译完成后打开build/bin目录,找到clang.execlang++.execlang-cl.exe,可以看到三个文件的MD5是相同的。

编译后的文件大小为 137MB,对比 NDK 目录下的 clang.exe 仅有 88.6MB。编译后的文件可以通过strip clang.exe命令剥离可执行文件减小到 113MB。

替换到 NDK 环境备份与替换

首先打开当前 NDK 的 llvm 目录,将clang.execlang++.execlang-cl.exe备份,然后把上一步编译后的文件复制到当前目录。

复制 lib 库

此时编译会出现找不到libunwind等库的错误,错误信息显示目录文件不存在

  CMake Error at SDK_DIR/cmake/3.22.1/share/cmake-3.22/Modules/CMakeTestCCompiler.cmake:69 (message):    The C compiler        "SDK_DIR/ndk/25.2.9519653/toolchains/llvm/prebuilt/windows-x86_64/bin/clang.exe"      is not able to compile a simple test program.      It fails with the following output:        Change Dir: APPLICATION_DIR/app/.cxx/RelWithDebInfo/703a16l3/arm64-v8a/CMakeFiles/CMakeTmp            Run Build Command(s):SDK_DIR\\cmake\3.22.1\bin\ninja.exe cmTC_c87d1 && [1/2] Building C object CMakeFiles/cmTC_c87d1.dir/testCCompiler.c.o      [2/2] Linking C executable cmTC_c87d1      FAILED: cmTC_c87d1       cmd.exe /C "cd . && SDK_DIR\\ndk\25.2.9519653\toolchains\llvm\prebuilt\windows-x86_64\bin\clang.exe --target=aarch64-none-linux-android26 --sysroot=SDK_DIR/ndk/25.2.9519653/toolchains/llvm/prebuilt/windows-x86_64/sysroot -g -DANDROID -fdata-sections -ffunction-sections -funwind-tables -fstack-protector-strong -no-canonical-prefixes -D_FORTIFY_SOURCE=2 -Wformat -Werror=format-security -static-libstdc++ -Wl,--build-id=sha1 -Wl,--no-rosegment -Wl,--fatal-warnings -Wl,--no-undefined -Qunused-arguments CMakeFiles/cmTC_c87d1.dir/testCCompiler.c.o -o cmTC_c87d1  -latomic -lm && cd ."      ld: error: unable to find library -latomic      ld: error: cannot open SDK_DIR/ndk/25.2.9519653/toolchains/llvm/prebuilt/windows-x86_64/lib/clang/14.0.0/lib/linux/libclang_rt.builtins-aarch64-android.a: No such file or directory      ld: error: unable to find library -l:libunwind.a      ld: error: cannot open SDK_DIR/ndk/25.2.9519653/toolchains/llvm/prebuilt/windows-x86_64/lib/clang/14.0.0/lib/linux/libclang_rt.builtins-aarch64-android.a: No such file or directory      ld: error: unable to find library -l:libunwind.a      clang: error: linker command failed with exit code 1 (use -v to see invocation)      ninja: build stopped: subcommand failed.                        CMake will not be able to correctly generate this project.  Call Stack (most recent call first):    CMakeLists.txt:10 (project)

需要把SDK_DIR/ndk/25.2.9519653/toolchains/llvm/prebuilt/windows-x86_64/lib64/目录下的calng目录,复制到/lib目录中,并把clang/14.0.7修改为14.0.0

这里的14.0.0是根据错误日志中出现的路径提取出来的,在控制台中输入clang -v查看当前 clang 的版本,按照日志中出现或当前使用的 clang 版本调整。

至此,NDK 中 集成 OLLVM 已经完成了。接下来是配置和使用 OLLVM。

配置 OLLVM

这部分网上参考的文档很多,这里也只是简单介绍一下参数

参数

参数说明
-mllbm -sub激活指令替换
-mllvm -sub_loop=3如果激活了传递,则在函数上应用3次。默认值:1
-mllvm -bcf激活虚假控制流程
-mllvm -bcf_loop=3如果激活了传递,则在函数上应用3次。默认值:1
-mllvm -bcf_prob=40如果激活了传递,基本块将以40%的概率进行模糊处理。默认值:30
-mllvm -fla激活控制流扁平化
-mllvm -split激活基本块分割。在一起使用时改善展平
-mllvm -split_num=3如果激活了传递,则在每个基本块上应用3次。默认值:1

拓展参数

heroims在移植 OLLVM 时,集成了Armariris的字符串混淆功能。

参数说明
-mllvm -sobf编译时候添加选项开启字符串加密
-mllvm -seed=指定随机数生成器种子

使用

可以在build.gradle中进行配置,如:

android {    defaultConfig {        extrnalNativeBuild {            cmake {                cppFlags '-mllvm -fla'            }        }    }}

也可以在CMakeLists中进行配置,如:

SET(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -mllvm -fla -mllvm -sub -mllvm -sobf")SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -mllvm -fla -mllvm -sub -mllvm -sobf")

输出比对

以配置了-fvisibility=hidden -ffunction-sections -fdata-sections 的获取 updatemark 为例,源码为:

static jstring getUpdate(JNIEnv *env, jobject clazz) {    struct stat sb{};    int updates = 0;    int updatens = 0;    if (stat("/data/data", &sb) == -1) {        //获取失败    } else {        updatens = (int) sb.st_atim.tv_nsec;        updates = (int) sb.st_atim.tv_sec;    }    std::string idRes = std::to_string(updates) + "." + std::to_string(updatens);    return env->NewStringUTF(idRes.c_str());}

before

after

遇到的问题虚假控制流程的问题

实际编译的过程中,增加了-mllvm -bcf参数后,编译超过半个小时还是没有完成,移除后正常编译。
搜索了相关的问题后,发现可能是 ndk 的编译器优化 flag 在 release 时是 -O2 导致的。

This is specifically an issue with llvm / android-ndk when compiling with thumb mode. You’ll either need to disable thumb compilation (annoying) or patch the llvm to not generate this type of instructions; it’s not actually an obfuscator-llvm issue.

Potentially try upgrading your ndk as well, though I’m doubtful that will fix this issue. If I have extra time later I can try to find the patch I needed to create for llvm to specifically work around this issue.

但在我这边,debug 依然是没有响应,只能是去掉-bcf

CMAKELIST 的 Release 不生效问题

CMAKE_C_FLAGSCMAKE_C_FLAGS_DEBUG配置的参数都可以正常生效,但CMAKE_C_FLAGS_RELEASE配置无法在 release 时生效。只能配置在CMAKE_C_FLAGS中,然后在 CMakeLists 中判断当前环境是否为 DEBUG。

参考资料

  • yangyiyu08/【清羽】Windows10下编译OLLVM-14.x
  • heroims/OLLVM代码混淆移植与使用
  • obfuscator/issues/-bcf crashes when compiling ndk project