Install and debug iPhone apps from the command line, without using Xcode
C
Pull request Compare This branch is 23 commits ahead, 3 commits behind ghughes:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
Entitlements.plist
Info.plist
LICENSE
Makefile
MobileDevice.h
README.md
ResourceRules.plist
demo.c
fruitstrap.c

README.md

fruitstrap

Install and debug iPhone apps without using Xcode. Designed to work on unjailbroken devices.

Requirements

  • Mac OS X. Tested on Snow Leopard only.
  • You need to have a valid iPhone development certificate installed.
  • Xcode must be installed, along with the SDK for your iOS version.

Usage

fruitstrap [-q/--quiet] [-t/--timeout timeout(seconds)] [-v/--verbose] <command> [<args>]

Commands available:

  • install [-i/--id device_id] -b/--bundle bundle.app [-a/--args arguments]: Install the specified app with optional arguments to the specified device, or all attached devices if none are specified.

  • uninstall [-i/--id device_id] -b/--bundle bundle.app: Removed the specified bundle identifier (eg com.foo.MyApp) from the specified device, or all attached devices if none are specified.

  • list-devices: List all attached devices.

  • debug [-w/--wait] [-n/--no-mount] [-b/--bundle bundle.app [-a/--args arguments] Debug the app with the specified bundle identifier. Optional wait instead of running gdb automatically. Opt-out of mounting the developer image.

Demo

  • The included demo.app represents the minimum required to get code running on iOS.
  • make install will install demo.app to the device.
  • make debug will install demo.app and launch a GDB session.

Notes

  • With some modifications, it may be possible to use this without Xcode installed; however, you would need a copy of the relevant DeveloperDiskImage.dmg (included with Xcode). GDB would also run slower as symbols would be downloaded from the device on-the-fly.