||2 weeks ago|
|docs||2 months ago|
|src||2 weeks ago|
|.gitignore||3 weeks ago|
|AUTHORS||2 months ago|
|LICENSE||2 months ago|
|README.md||3 weeks ago|
ObjGTKGen is a utility that generates Objective-C language bindings for ObjGTK using GObject Introspection (parsing GIR files). ObjGTKGen is free software, licensed under the GNU LGPL.
The ObjGTK code base should be compatible with the Objective C dialect of GCC ("Objective C 2.0") as introduced as of Mac OS X 10.5. So there should be no need to use clang. There are plans to implement advanced support of clang language features, especially memory management via Automatic Reference Counting (ARC).
Currently there are only untested, unstable preview releases of ObjGTK. Take care when using. API is going to change. See milestones for the further release plan.
Hacking / How it works
The generator does the following currently:
- It parses a GIR file (.gir) using
XMLReaderinto object instances of the GIR classes (see directory
src/GIR) (source models)
Gir2Objcthen maps the information of the GIR models into the models prefixed with
src/Generator) (target models). Please note that these models still hold API/class informationen using C names and types as used by the Glib/GObject libraries. These models provide methods to transform their Glib ("c") data/names/types into Objective C classes/names/types.
OGTKClassWriteris called which writes out ObjC class definitions. Doing so it maps GObject types to Objective C / OGTK types (swaps them) by using
- When all classes are written, necessary base classes at
src/BaseClassesare added to
Output(the generated library) to actually make it compile and run. Please note that the classes at
src/BaseClassesare not used by the generator itself at any time.
You will find the main business logik in
OGTKMapper for multiple loops through all the parsed (Gobj) class/API information to complete dependency information (naming of parent classes) and the dependency graph (parent classes, depending classes). This is necessary to correctly insert
@class statements when generating the ObjC class definitions without getting stuck in a circular dependency loop.