Building for iPhone
<= Previous Change | Next Change =>
| Diff Summary | ||
|---|---|---|
| Title | ||
| Date | 2009-02-02 15:49 | 2009-08-27 12:43 |
| Editor | Andrew Plotkin (zarf) | Aaron Griffith (agrif) |
| 2009-02-02 15:49 by Andrew Plotkin | 2009-08-27 12:43 by Aaron Griffith | ||||
|---|---|---|---|---|---|
| n | 1 | This page will tell you how to get boodler running | n | 1 | This page will tell you how to get Boodler running |
| > | on the iPhone. If you have any questions or want | > | on the iPhone. If you have any questions or want | ||
| > | anything cleared up, feel free to contact me at [a | > | anything cleared up, feel free to contact me at [a | ||
| > | argri@gmail.com](mailto:aargri@gmail.com). Note th | > | argri@gmail.com](mailto:aargri@gmail.com). This is | ||
| > | at ideally, you will be able to install boodler th | > | an extremely unofficial and unsupported platform | ||
| > | rough Cydia in the future (as a binary package), b | > | for Boodler, though. If you mess up your iPhone wh | ||
| > | ut I'm still working on that. I don't really know | > | ile doing this, it's not my fault. | ||
| > | zarf's opinion on binary distributions, either. | ||||
| 2 | 2 | ||||
| n | 3 | *(I love 'em. --Z)* | n | 3 | # Option 1: Install Boodler through Cydia |
| 4 | |||||
| 5 | If you have a jailbroken iPhone with Cydia install | ||||
| > | ed, you can just install Boodler from Cydia and av | ||||
| > | oid the mess of compiling it on your iPhone. This | ||||
| > | is certainly the easiest option. | ||||
| 6 | |||||
| 7 | First, open up Cydia and touch 'Manage' down at th | ||||
| > | e bottom. Then, click on 'Sources', then 'Edit', t | ||||
| > | hen 'Add'. In the box that pops up, type `http://g | ||||
| > | amma-level.com/forever/cydia-boodler/`. Then hit ' | ||||
| > | Add Source'. | ||||
| 8 | |||||
| 9 | > Note to zarf: I appreciate that you may want to | ||||
| > | keep this sort of stuff on boodler.org, as you did | ||||
| > | with the patch file. This repository is a directo | ||||
| > | ry of files, which can be found in a tarball [here | ||||
| > | ](http://gamma-level.com/forever/cydia-boodler.tar | ||||
| > | .gz). I'm perfectly fine with hosting it, however, | ||||
| > | and I'll keep it up-to-date with Boodler releases | ||||
| > | as they appear. | ||||
| 10 | |||||
| 11 | Now, hit 'Done', and Cydia will start to update it | ||||
| > | 's package information. Ignore any errors, I got q | ||||
| > | uite a few but it didn't seem to matter. Then, cli | ||||
| > | ck on the newly-added 'Boodler Cydia Repository', | ||||
| > | then the Boodler package, and you can install from | ||||
| > | there. You can also find Boodler in the 'Multimed | ||||
| > | ia' section. | ||||
| 12 | |||||
| 13 | You will still need some type of terminal to use B | ||||
| > | oodler, as there is no UI for it. I suggest Mobile | ||||
| > | Terminal, or an ssh server, such as OpenSSH, both | ||||
| > | of which you can install from Cydia. | ||||
| 14 | |||||
| 15 | # Option 2: Install Boodler from source | ||||
| 16 | |||||
| 17 | I would only recommend compiling from source if yo | ||||
| > | u *really* know what your doing. Installing throug | ||||
| > | h Cydia is easier, and it'll save you about 150MB | ||||
| > | of space that's taken up by the compiler and such. | ||||
| > | |||||
| 4 | 18 | ||||
| 5 | It looks long, but it's actually only verbose. If | 19 | It looks long, but it's actually only verbose. If | ||
| > | you have any experience with technology (i.e. you | > | you have any experience with technology (i.e. you | ||
| > | have compiled boodler before) this shouldn't be to | > | have compiled boodler before) this shouldn't be to | ||
| > | o hard. Otherwise, it should be easy enough to fol | > | o hard. Otherwise, it should be easy enough to fol | ||
| > | low. | > | low. | ||
| 6 | 20 | ||||
| n | 7 | # Prerequisites | n | 21 | ## Prerequisites |
| 8 | 22 | ||||
| 9 | These are some obvious and some not-so-obvious req | 23 | These are some obvious and some not-so-obvious req | ||
| > | uirements: | > | uirements: | ||
| 10 | 24 | ||||
| n | 11 | ## A *jailbroken* iPhone | n | 25 | ### A *jailbroken* iPhone |
| 12 | 26 | ||||
| 13 | There are many guides available for jailbreaking y | 27 | There are many guides available for jailbreaking y | ||
| > | our iPhone, just do a Google search. Unfortunately | > | our iPhone, just do a Google search. Unfortunately | ||
| > | , boodler is not likely to come to the official Ap | > | , boodler is not likely to come to the official Ap | ||
| > | p Store any time soon, because python, which boodl | > | p Store any time soon, because python, which boodl | ||
| > | er needs, would be a mad beast to port without ful | > | er needs, would be a mad beast to port without ful | ||
| > | l access to the phone's filesystem. | > | l access to the phone's filesystem. | ||
| 14 | 28 | ||||
| n | 15 | ## Cydia | n | 29 | ### Cydia |
| 16 | 30 | ||||
| 17 | Cydia is probably already on your phone if it's ja | 31 | Cydia is probably already on your phone if it's ja | ||
| > | ilbroken, and if it's not, then Installer probably | > | ilbroken, and if it's not, then Installer probably | ||
| > | is. You can install Cydia from Installer. | > | is. You can install Cydia from Installer. | ||
| 18 | 32 | ||||
| 19 | For those interested, Cydia is a port of debian's | 33 | For those interested, Cydia is a port of debian's | ||
| > | package management system to the iPhone, among oth | > | package management system to the iPhone, among oth | ||
| > | er things. It is immensely useful here. | > | er things. It is immensely useful here. | ||
| 20 | 34 | ||||
| n | 21 | ## Shell Access | n | 35 | ### Shell Access |
| 22 | 36 | ||||
| 23 | This can be done through SSH (preferred), or Mobil | 37 | This can be done through SSH (preferred), or Mobil | ||
| > | eTerminal (simpler). | > | eTerminal (simpler). | ||
| 24 | 38 | ||||
| n | 25 | You can install MobileTerminal through Cydia. Just | n | 39 | You can install MobileTerminal through Cydia. Just |
| > | launch it after it's done installing, and you hav | > | launch it after it's done installing, and you hav | ||
| > | e a shell open on your phone! | > | e a shell open on your phone! You will need to be | ||
| > | `root` to compile and install boodler, so type in | ||||
| > | `su` and your password ('alpine' if you don't know | ||||
| > | ). | ||||
| 26 | 40 | ||||
| n | 27 | If you want to use SSH (which is easier to work wi | n | 41 | If you want to use SSH (which is easier to work wi |
| > | th, but harder to set up) install the OpenSSH pack | > | th, but harder to set up) install the OpenSSH pack | ||
| > | age in Cydia. It may already be installed. Then, r | > | age in Cydia. It may already be installed. Then, r | ||
| > | estart your phone. Open up a terminal window in yo | > | estart your phone. Open up a terminal window in yo | ||
| > | ur *nix flavor of choice, and type '`ssh -l root i | > | ur *nix flavor of choice, and type '`ssh -l root i | ||
| > | phone.ip`' (replacing 'iphone.ip' with your iphone | > | phone.ip`' (replacing 'iphone.ip' with your iphone | ||
| > | 's IP address). Type in the password (if you don't | > | 's IP address). Type in the password (again, if yo | ||
| > | know your password, it's 'alpine'). You should no | > | u don't know your password, it's 'alpine'). You sh | ||
| > | w have a shell open on your phone. | > | ould now have a shell open on your phone. | ||
| 28 | 42 | ||||
| n | 29 | # Getting Ready to Install | n | 43 | ## Getting Ready to Install |
| 30 | 44 | ||||
| 31 | I highly recommend plugging your phone in and disa | 45 | I highly recommend plugging your phone in and disa | ||
| > | bling auto-lock in the settings. Some of this can | > | bling auto-lock in the settings. Some of this can | ||
| > | take a while, and auto-lock cancels them. Or, you | > | take a while, and auto-lock cancels them. Or, you | ||
| > | can just touch the screen occasionally. Just don't | > | can just touch the screen occasionally. Just don't | ||
| > | let it lock. | > | let it lock. | ||
| 32 | 46 | ||||
| 33 | OK. Lets go. | 47 | OK. Lets go. | ||
| 34 | 48 | ||||
| 35 | Type this in the shell (make sure cydia is closed) | 49 | Type this in the shell (make sure cydia is closed) | ||
| > | : | > | : | ||
| 36 | 50 | ||||
| 37 | apt-get install gzip iphone-gcc ldid make nano | 51 | apt-get install gzip iphone-gcc ldid make nano | ||
| > | python setuptools tar wget com.bigboss.20toolchai | > | python setuptools tar wget com.bigboss.20toolchai | ||
| > | n patch | > | n patch | ||
| n | n | 52 | |||
| 53 | (as of iPhone OS 3.0 \[or maybe earlier\], this co | ||||
| > | mmand exits with apt complaining about not being a | ||||
| > | ble to install libgcc, which is no longer necessar | ||||
| > | y. Go [here](http://www.telesphoreo.org/ticket/163 | ||||
| > | ) to get a dummy package that fools apt into think | ||||
| > | ing libgcc was installed) | ||||
| 38 | 54 | ||||
| 39 | It may ask some questions. Answer in a way that le | 55 | It may ask some questions. Answer in a way that le | ||
| > | ts the install continue (generally Y / yes). | > | ts the install continue (generally Y / yes). | ||
| 40 | 56 | ||||
| 41 | This can take a while as it downloads and installs | 57 | This can take a while as it downloads and installs | ||
| > | the stuff you need to continue. | > | the stuff you need to continue. | ||
| 42 | 58 | ||||
| 44 | 60 | ||||
| 45 | wget http://boodler.org/dl/Boodler-2.0.2.tar.g | 61 | wget http://boodler.org/dl/Boodler-2.0.2.tar.g | ||
| > | z | > | z | ||
| 46 | tar -xzvf ./Boodler-2.0.2.tar.gz | 62 | tar -xzvf ./Boodler-2.0.2.tar.gz | ||
| 47 | cd Boodler-2.0.2 | 63 | cd Boodler-2.0.2 | ||
| 48 | 64 | ||||
| n | 49 | ## Patching Boodler | n | 65 | ### Patching Boodler |
| 50 | 66 | ||||
| 51 | This part is only slightly necessary. It patches s | 67 | This part is only slightly necessary. It patches s | ||
| > | etup.py to search for headers somewhere else, and | > | etup.py to search for headers somewhere else, and | ||
| > | also lets boodler continue after you lock the phon | > | also lets boodler continue after you lock the phon | ||
| > | e. It's pretty handy, actually. | > | e. It's pretty handy, actually. | ||
| 52 | 68 | ||||
| 53 | If you want to do without, edit setup.py so the `o | 69 | If you want to do without, edit setup.py so the `o | ||
| > | sxaq` line searches for `CoreAudio/CoreAudio.h` an | > | sxaq` line searches for `CoreAudio/CoreAudio.h` an | ||
| > | d `AudioToolbox/AudioQueue.h` instead, and change | > | d `AudioToolbox/AudioQueue.h` instead, and change | ||
| > | setup.cfg so the `macosx` driver is not compiled. | > | setup.cfg so the `macosx` driver is not compiled. | ||
| 54 | 70 | ||||
| 57 | wget http://boodler.org/dl/etc/Boodler-2.0.2-i | 73 | wget http://boodler.org/dl/etc/Boodler-2.0.2-i | ||
| > | Phone.patch | > | Phone.patch | ||
| 58 | patch -p1 < Boodler-2.0.2-iPhone.patch | 74 | patch -p1 < Boodler-2.0.2-iPhone.patch | ||
| 59 | 75 | ||||
| 60 | That is a bit easier than hand-editing files, no? | 76 | That is a bit easier than hand-editing files, no? | ||
| 61 | 77 | ||||
| n | 62 | # Building and Installing Boodler | n | 78 | ## Building and Installing Boodler |
| 63 | 79 | ||||
| 64 | Finally, we're here. This is the home stretch. Run | 80 | Finally, we're here. This is the home stretch. Run | ||
| > | these now to build boodler and sign the driver: | > | these now to build boodler and sign the driver: | ||
| 65 | 81 | ||||
| 66 | python setup.py build | 82 | python setup.py build | ||
| 67 | ldid -S build/lib.darwin-10.5-arm-2.5/boodle/c | 83 | ldid -S build/lib.darwin-10.5-arm-2.5/boodle/c | ||
| > | boodle_osxaq.dylib | > | boodle_osxaq.dylib | ||
| 76 | 92 | ||||
| 77 | Boodler is now installed! | 93 | Boodler is now installed! | ||
| 78 | 94 | ||||
| 79 | # Test Boodler | 95 | # Test Boodler | ||
| 80 | 96 | ||||
| n | 81 | This is listed elsewhere, but still, listen to wha | n | 97 | This is listed elsewhere, but still, it's great to |
| > | t you have done. | > | listen to your handiwork. | ||
| 82 | 98 | ||||
| 83 | boodler.py --testsound | 99 | boodler.py --testsound | ||
| 84 | 100 | ||||
| t | 85 | it should work. If not, tell me and I'll try to he | t | 101 | If nothing plays, check your volume levels. If it |
| > | lp. Boodler can now be used like on a desktop syst | > | still doesn't work, email me and I'll try to help. | ||
| > | em, with one change. If you used ssh, you must alw | > | |||
| > | ays `su mobile` after logging in, as boodler-mgr.p | ||||
| > | y doesn't like installing packages as root on the | ||||
| > | iPhone. | ||||
| 102 | |||||
| 103 | Boodler can now be used like on a desktop system, | ||||
| > | with one change. If you used ssh, you must always | ||||
| > | `su mobile` after logging in, as boodler-mgr.py do | ||||
| > | esn't like installing packages as root on the iPho | ||||
| > | ne. | ||||
| 86 | 104 | ||||
| 87 | Have fun! | 105 | Have fun! | ||
Building for iPhone
- last changed 2009-08-27 12:48 by
Aaron Griffith (agrif)