Skip to content

Latest commit

 

History

History
38 lines (24 loc) · 1.57 KB

README.md

File metadata and controls

38 lines (24 loc) · 1.57 KB
Raw

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.