iPhone headers translator: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | *(iOS only)* | |
| 2 | 2 | ||
| 3 | 3 | ## Pascal iPhone header translator | |
| 4 | 4 | ||
| 5 | 5 | ### Author | |
| 6 | 6 | ||
| 7 | 7 | Anton e-mail: ast DOT a_s AT mail DOT ru | |
| 8 | 8 | ||
| 9 | 9 | ### Introduction | |
| 10 | 10 | ||
| 11 | 11 | Because no one can redistribute Pascal units for iOS SDK we need a tool that can produce such units from official C headers. Of course everyone can take original headers and manually translate them but it is not the simplest work. Indeed this process can be (at least partially) automated. I'd like to present iPhone headers translator that is written in FPC. | |
| 12 | 12 | ||
| 13 | 13 | ### File structure | |
| 14 | 14 | ||
| 15 | 15 | There are several files zip available fro download page: | |
| 16 | 16 | ||
| 17 | 17 | - parser.pas - main program; | |
| 18 | 18 | - htranslator.pas - contains main class that perform translation (indeed it only manage this process); | |
| 19 | 19 | - hscanner.pas - contains "c-header scanner" class; | |
| 20 | 20 | - hparser.pas - contains common c-header parser, that translates c declarations (without helper functions with implementations (bodies)); | |
| 21 | 21 | - bparser.pas - extends header parser to handle functions with bodies too; | |
| 22 | 22 | - ocparser.pas - extends parser to handle objective-c declarations; | |
| 23 | 23 | - decltypes.pas - contains class to manage translated types; | |
| 24 | 24 | - declids.pas (since 20120410) - contains class to manage globally declared symbols (constants, variables and functions). | |
| 25 | 25 | ||
| 26 | 26 | ### Features (main goals of project) | |
| 27 | 27 | ||
| 28 | 28 | - do not require any additional (input) files, only iPhone SDK C-headers; | |
| 29 | 29 | - produced Pascal units must not need any manual fixes to be compiled; | |
| 30 | 30 | - translate also implementations of helper functions | |
| 31 | 31 | ||
| 32 | 32 | ### Version review | |
| 33 | 33 | ||
| 34 | 34 | - Initial version from 2012-03-19: can translate UIKit and related frameworks. | |
| 35 | 35 | ||
| 36 | 36 | ||
| 37 | 37 | Translation process was tested for the following SDKs: | |
| 38 | 38 | ||
| 39 | 39 | ||
| 40 | 40 | ||
| 41 | 41 | **iPhoneSimulator** 3.0, 3.2, 4.0, 4.1, 4.2, 4.3, 5.0; | |
| 42 | 42 | ||
| 43 | 43 | ||
| 44 | 44 | ||
| 45 | 45 | **iPhoneOS** 5.0. | |
| 46 | 46 | ||
| 47 | 47 | ||
| 48 | 48 | Compilation of produced units was tested only for iPhoneSimulator 5.0. | |
| 49 | 49 | ||
| 50 | 50 | Test project can be found on download page (ipt.zip contains Lazarus project, notes about its compilation can be found in next section). | |
| 51 | 51 | ||
| 52 | 52 | - ip_pars20120410: can translate almost all frameworks from SDK 5.0. | |
| 53 | 53 | ||
| 54 | 54 | ||
| 55 | 55 | Some frameworks (applicationservices, coreservices, accelerate, carbon) for now are translated to empty units because translation of "nested frameworks" is not implemented yet. Parsing process was tested for iPhoneSimulator 5.0 and iPhoneOS 5.0, compilation was tested only for simulator. | |
| 56 | 56 | ||
| 57 | 57 | ### How to parse | |
| 58 | 58 | ||
| 59 | 59 | To build parser "fpc parser" is enough. Of course you need to install iPhone SDK. Cause I have only simulator, I will use its SDK. Typically it is installed to /Developer/Platforms/iPhoneSimulator/Developer/SDKs/iPhoneSimulator5.0.sdk (for 5.0 version). The path to SDK will be used as a parameter of parser. Indeed, it's time to start it. Parser contains a little help, so it can be used (--help or without parameters). | |
| 60 | 60 | ||
| 61 | 61 | Parser parameters: | |
| 62 | 62 | ||
| 63 | 63 | 1. one of parameter must be sdk="path_to_sdk" (mandatory); | |
| 64 | 64 | 2. there can be parameter dest="output_path" (to place Pascal units, if not specified "src" is used); | |
| 65 | 65 | 3. all other parameters are regarded as names of frameworks to parse. | |
| 66 | 66 | ||
| 67 | 67 | Example: | |
| 68 | 68 | ||
| 69 | - | ||
| 69 | + | ```text | |
| 70 | + | $ ./parser sdk=/Developer/Platforms/iPhoneSimulator/Developer/SDKs/iPhoneSimulator5.0.sdk UIKit | |
| 71 | + | ``` | |
| 70 | 72 | ||
| 71 | 73 | will translate UIKit and all dependant frameworks (cfnetwork, corefoundation, coregraphics, coreimage, corevideo, foundation, opengles, security). I've tested it for SDKs 3.0, 3.2, 4.0, 4.1, 4.2, 4.3, 5.0. Although now it works good there are some "todo's" and unimplemented parts. | |
| 72 | 74 | ||
| 73 | 75 | *ip_pars20120410.zip* contains two scripts that can be used to start translation process: | |
| 74 | 76 | ||
| 75 | 77 | 1. **start_ios.sh** for iPhoneOS 5.0 SDK; | |
| 76 | 78 | 2. **start_sim.sh** for iPhoneSimulator 5.0 SDK. | |
| 77 | 79 | ||
| 78 | 80 | Notes: | |
| 79 | 81 | ||
| 80 | 82 | - Before starting these scripts you will need execute *chmod +x* for them. | |
| 81 | 83 | - These scripts cannot be used for SDKs of different versions because trying to parse missing framework leads to fatal error. | |
| 82 | 84 | ||
| 83 | 85 | ### Testing | |
| 84 | 86 | ||
| 85 | 87 | My test program is also attached (*ipt.zip* contains Lazarus project). Project output directory must be changed. In order to run it in Simulator I have created empty XCode project "iphone_test" and run it. After that I've closed XCode and run only simulator - it has contained my new program "iphone_test". After that I've simply replaced binary /Users/macuser/Library/Application Support/iPhone Simulator/5.0/Applications/C93F7A57-E612-4A40-B155-DB106CA860D6/iphone_test.app/iphone_test | |
| 86 | 88 | ||
| 87 | 89 | ### Download | |
| 88 | 90 | ||
| 89 | 91 | From here: <http://sourceforge.net/projects/p-tools/files/iPhone%20headers%20translator/> | |
| 90 | 92 | ||
| 91 | 93 | <https://github.com/odisey1245/ip_parse> | |
| 92 | 94 | ||
| 93 | 95 | ## See Also | |
| 94 | 96 | ||
| 95 | 97 | - [[iPhone/iPod development]] | |
| 96 | 98 | ||
| 97 | 99 | --- | |
| 98 | 100 | *From the Free Pascal wiki, page "iPhone headers translator", as it stood on 2015-03-07 after a change by Penilopa P, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* | |
| 99 | 101 | Category: iOS |