Home

Awesome

RunEverywhere Xcode Plugin


Overview

An Xcode 7 plugin to build and run an app across multiple iOS devices with one click.

Gone are the days of manually switching between device destinations and fiddling with the "play" and "stop" buttons. RunEverywhere streamlines development and testing across multiple iPhone / iPod models. This is especially handy if you're building multi-player games, universal apps, or networked apps in general.

The plugin adds two new commands to Xcode's "Product" menu.

Run Everywhere <kbd></kbd> + <kbd></kbd> + <kbd></kbd> + <kbd>R</kbd>

Builds and runs the app on all attached devices.

Stop Everywhere <kbd></kbd> + <kbd></kbd> + <kbd></kbd> + <kbd>.</kbd>

Stops the app on all attached devices.

<img src="screenshot-readme.png" width="300" height="376" />

Installation

Two options here:

Via Alcatraz

RunEverywhere is available through the Alcatraz Xcode plugin management system.

From source

Simply build the Xcode project and restart Xcode. The plugin will automatically install to ~/Library/Application Support/Developer/Shared/Xcode/Plug-ins/.

To uninstall, just remove the plugin from the above directory, and restart Xcode:

rm -rf ~/Library/Application\ Support/Developer/Shared/Xcode/Plug-ins/KPRunEverywhereXcodePlugin.xcplugin

Compatibility

KPRunEverywhere is compatible with Xcode 5, 6, and 7.

It's specifically tested and known to work on:


Limitations

This isn't going to work on the simulator.

Running everywhere might not work if Xcode loses focus during to app-launch process. I recommend giving Xcode a second to collect itself after invoking Run Everywhere. This is an unfortunate side-effect of the menu-manipulating implementation.

Unfortunately, Apple removed support for traditional plugins in Xcode 8, and the new official APIs do not allow the functionality implemented in KPRunEverywhere. Any progress on this front will be tracked in issue #17.


Thanks

Built with Delisa Mason's super handy Xcode Plugin Template.

Inspiration was drawn from a couple of Stack Overflow threads:


Author

Eric Mika
github.com/kitschpatrol
@kitschpatrol


License

MIT