TweakologyEngine

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

Installation

tweakology is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'TweakologyEngine'

If you experience issues with the SDWebImage, GCDWebServer dependencies also add:

pod 'SDWebImage', '4.4.2', :modular_headers => true
pod 'GCDWebServer', '3.4.2', :modular_headers => true

Usage

Initializing the TweakologyAgent in your ideally in your the app's main function will allow you apply existing tweak configurations as well as creating new tweaks with the help of the Tweakology App. For production usecases only initialize the TweakologyEngine and keep the TweakologyAgent disabled.

Swift

import TweakologyEngine

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var tweakologyAgent: TweakologyAgent?

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    ...
    tweakologyAgent = TweakologyAgent(name: "MyApp")
    tweakologyAgent?.start()
    ...
  }
}

ObjectiveC

If your Objective C project has no Swift support, please make sure you enable it. To do so add any .swift file to the project. XCode will likely ask you to add bridging header - e.g. MyApp-Bridging-Header.h, if not please do so manually. Then in the build settings of your app target set:

1. Define Modules - 'Yes'
2. Always Embed Swift Standard Libraries - 'Yes'
3. Install Objective-C compatibility header - 'Yes'
4. Objective C Bridging Header - 'MyApp-Bridging-Header.h'

@import TweakologyEngine;

int main(int argc, char * argv[])
{
    @autoreleasepool {
        TweakologyAgent *agent = [[TweakologyAgent alloc] initWithName:@"MyApp"];
        [agent start];
        return UIApplicationMain(argc, argv, nil, NSStringFromClass([MyAppDelegate class]));
    }
}

Author

Nikolay Ivanov, velikolay@gmail.com

License

tweakology is available under the MIT license. See the LICENSE file for more info.