Skip to content
This repository has been archived by the owner on Oct 4, 2019. It is now read-only.

Using dyci

Jump to bottom
Orta edited this page Apr 23, 2015 · 23 revisions

At first, please, look to example, that goes with the main project. Really:)

#0 Installation

Make sure you've installed dyci via install.sh script, like described here

#1 Adding sources

There's plenty ways to add dyci to your project, but these two are the most preferable

###As CocoaPod Just add this line in your PodFile
pod 'dyci', :git => 'https://github.com/DyCI/dyci-main.git'
FYI, CocoaPods are great! :)

Or as static precompiled framework

  1. Download dyci.framework v0.1.5.6
  2. Add Framework to your project
  3. Make sure that you have -ObjC flag in Other Linker Flags setting

Or build framework from latest sources

  1. Clone the master repository
  2. Run ./build_framework.sh ind Dynamic Code Injection directory
  3. Grab compiled framework out of the output directory
  4. Add Framework to your project
  5. Make sure that you have -ObjC flag in Other Linker Flags setting

###Or as subproject Just grab dyci project to your workspace Add it as dependecy in your project Adding as static library

#2 Enabling Dyci

All you need to enable dyci is to correctly perform the previous task.
That's all. Dyci is enabled on your project now, so you can use it.
If all went ok, then you'l see log, that will have announce about dyci enabled state.

###First-time recompilation. At the same first time you need clean your project and recompile. In other case, you won't be able to use dyci, since, it wont be able to compile your file correctly

#3 Using!

###Recompile and Inject If you successfully installed dyci, you have additional menu item in "Product" menu in Xcode, with "Recompile and Inject ^X" name.
Note that, you need your application to be running, to use this tool :)
Each time, you pressing '^X', your class is being injected to your running application.
If you have errors in your code, then Xcode will fail and show alert with notification that code cannot be compiled.
If all went good, you see alot of information about injection in Console. Read it carefully. At least first time.

================================================= 
Found new DCI ... Loading
objc[4334]: Class DYCIViewController is implemented in both ... One of the two will be used. Which one is undefined.
DCI was successfully loaded
Searching classes to inject
Injecting  class : DYCIViewController
Injecting meta class : DYCIViewController
Class (DYCIViewController) and their subclasses instances would be notified with
 - (void)updateOnClassInjection 
Class was successfully injected

If you don't see these lines, then something went wrong. Recheck your previous steps.

====

#4 Success

If you don't see changes read further

Clone this wiki locally