Hassle-free Obfuscator-Enabled Apple Clang without any sort of compromise.
Please refer to License.
Note that this linked version of license text overrides any artifact left in source code
Due to its hackish nature (Which is why I don't want to do this in the first place), you should probably know some LLVM/macOS Hooking/Binary Patching and stuff to debug this thing
- Extract the zipped file and move two extracted dylibs under
/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin
- Download libsubstitute.dylib and move it to
/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin
- See Patching. Ignore library not found in that release version
$(LLVM_SOURCE_PATH)
The path that stored Hikari's main repo with submodules properly fetched. It's suggested to use a Hikari branch that matches your Apple Clang's LLVM version. See Release Versioning Scheme to see how to find the LLVM version of your Clang${LLVM_BUILD_PATH}
The path you prepare to build in. Note that you need a seperate folder and must not reuse existing build for upstream Hikari
git clone https://github.com/HikariObfuscator/Hanabi.git $(LLVM_SOURCE_PATH)/projects/
- Under
$(LLVM_SOURCE_PATH)
, rungit submodule update --init --recursive --remote
to make sure submodules are fully updated
cmake $(LLVM_SOURCE_PATH) -DCMAKE_BUILD_TYPE=Release -DLLVM_ABI_BREAKING_CHECKS=FORCE_OFF -G Ninja
ninja LLVMHanabi
- Copy
$(LLVM_BUILD_PATH)/lib/libLLVMHanabiDeps.dylib
to/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/
- Copy
$(LLVM_BUILD_PATH)/lib/libLLVMHanabi.dylib
to/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/
- Copy
$(LLVM_SOURCE_PATH)/projects/Hanabi/libsubstitute.dylib
to/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/
You need to build https://github.com/alexzielenski/optool
and put it in your $PATH, then you need to patch two libraries into Clang/SwiftC.
!!!ORDER IS VERY IMPORTANT!!!
sudo optool install -c load -p @executable_path/libLLVMHanabiDeps.dylib -t /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang
sudo optool install -c load -p @executable_path/libLLVMHanabi.dylib -t /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang
- LLVM 6.0.1 (which Xcode 10.1 and before is using) has bugs related to
indirectbr
CodeGeneration, you might get a crash if you enableINDIBRAN
. Try updating your Xcode version
- Strictly speaking, many changes are done to the Hikari Core to reduce LLVM library dependencies.
- Loader's linking options is modified to link to no LLVM library and fully resolve them at runtime in a flat namespace, this loader is also known as
libLLVMHanabi.dylib
- Then, we ship a custom mimimal subset of LLVM Core Libraries which serves as the fallback plan for symbols that are not exported in Apple's binaries, this is known as
libLLVMHanabiDeps.dylib
. - By not linking the full LLVM suite, we are allowed to reduce build time and more importantly, allows us to pass arguments like we normally would. (
-mllvm
)
The releases has a versioning scheme like 6.0@9ab263@LoaderV3
where the first part represents LLVM base version, the second represents Hikari Core's git commit hash and the third one represents the Loader implementation version. In this case, it means the release is tested to work on a Xcode version that uses LLVM6.0. You can refer to Toolchain version history
in Xcode - Wikipedia and uses the LLVM
column to find the matching Xcode version, which is this case is Xcode 10.0
and Xcode 10.1
. This release uses Core at 9ab263 and V3 of the loader
- Thanks to @AloneMonkey for compiling substitute and ship it with his amazing project MonkeyDev
- Thanks to @UESTC-LXY for testing and discussion because I didn't bother to do so.
- Thanks to@qokelate for initially discovering the broken CMake script and testing the new fix as well as suggestions to this README