install roothide/theos

bash -c "$(curl -fsSL https://raw.githubusercontent.com/roothide/theos/master/bin/install-theos)"

and it's always automatically synchronized and maintains 100% compatibility with the original theos.

Build package for roothide

for those simple tweaks that don't use the file api to access jailbreak files, just

make package with THEOS_PACKAGE_SCHEME=roothide

Using roothide APIs if you need to use the file apis to access jailbreak files in source code

#include <roothide.h>

//then using roothide api to access jailbreak files

const char* c_path = jbroot("/path/to/jb/file");

NSString* objc_path = jbroot(@"/path/to/jb/file");

std::string cpp_path = jbroot(std::string("/path/to/jb/file"));

the jbroot API can be used in C/C++/Objective-C/Swift and its fully compatible with building rootful/rootless package

In Swift project, it's better to use a swift bridging header file for #include <roothide.h> instead of using import roothide in swift source files. this will ensure your project is compatible with building rootful/rootless, ref to https://theos.dev/docs/swift#:~:text=Objective%2DC%20to%20Swift

Add these entitlements to your executable/app to make them work correctly with roothide:

<key>platform-application</key>
<true/>
<key>com.apple.private.security.no-sandbox</key>
<true/>
<key>com.apple.private.security.storage.AppBundles</key>
<true/>
<key>com.apple.private.security.storage.AppDataContainers</key>
<true/>

If you want to build your project with Xcode instead of theos,
here is the roothide sdk: devkit.zip

roothide/theos is now compatible with building roothide packages from existing tweak projects that use rootless path macros, there is a warning message to ensure you have read this document and you can define the DISABLE_ROOTLESS_COMPAT_WARNING macro to silence the message.

For more details about roothide, please refer to