tree: a10c04e880ea532ca4303e833f65f57387ef10e2 [path history] [tgz]
  1. .gitignore
  2. build.sh
  3. cipd.yml
  4. clean.sh
  5. install-dependencies.sh
  6. package.sh
  7. README.md
  8. release.sh
skolo/ios/skia-imobiledevice/README.md

Driving iOS tests with Raspberry Pi's

The tools in this directory allow iOS apps built on a Mac run on iOS devices attached to a Raspberry Pi.

The ideal workflow is to run the ‘build.sh’ script on the target platform and then manually install the generated package for local testing or copy it for remote installation.

Scripts

install-dependencies.sh

Installs all packages necessary for development.

build.sh

Checks out the libimobiledevice family of tools (see http://www.libimobiledevice.org/) and builds them. This is intended to be run a Raspberry Pi, but should work on most (Debian-based) Linux distributions. We roll 1 big package containing what several Debian-proper ones do, just to reduce paperwork, since we have to build everything from source anyway atop our patched libimobiledevice.

package.sh

Builds a Debian package of the tools. This should work on x86 desktops as well as Raspberry Pi's.

clean.sh

Removes all files created by build.sh.

Troubleshooting

When installing in a chroot, the post-installation script may fail because it is unable to reload systemd. This shouldn't cause any problems and is just an artifact of using the shared release.sh script.

udev is sometimes shy about triggering for devices that were already plugged in before usbmuxd was installed. This happens when a previous version of usbmuxd was terminated with kill rather than systemctl stop usbmuxd. Symptoms are that the iOS device won‘t show up in idevice_id -l and usbmuxd won’t be running. Rebooting fixes it.

Deployment Notes

To make the USB connection to the iOS device more stable it is recommended to remove the ‘libmtp9’ and ‘libmtp-common’ packages and their dependencies.

Version History

1.0

Original version, with Ben Wagner's patches, intended for use with pushk.

1.1

Same patches, rebased on the latest upstreams, a bit after the 1.3.0 release of libimobiledevice. Add Conflicts and Breaks metadata so we can install it atop the upstream Debian packages and have them leap out of the way.