Repository files navigation

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⌃ +⌥ +⌘ +R

Builds and runs the app on all attached devices.

Stop Everywhere⌃ +⌥ +⌘ +.

Stops the app on all attached devices.

Two options here:

RunEverywhere is available through theAlcatraz Xcode plugin management system.

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

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

It's specifically tested and known to work on:

• Xcode 5.1.0 + Mac OS X 10.9.2
• Xcode 6.0.1 + Mac OS X 10.9.5
• Xcode 6.3.0 + Mac OS X 10.10.3
• Xcode 7.0.1 + Mac OS X 10.11.0
• Xcode 7.1.0 + Mac OS X 10.11.1

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 inissue #17.

Built withDelisa Mason's super handyXcode Plugin Template.

Inspiration was drawn from a couple of Stack Overflow threads:

• How to 'Build & Run' on multiple destinations at once in Xcode?

• Xcode 4 - One Click Build to Multiple Devices?

• Run on simulator and phone with one click

• Is it possible to run an app on two devices with one click on the build and run button in Xcode 5?

Eric Mika
github.com/kitschpatrol
@kitschpatrol

MIT