Automatically enable/disable app extensions from Xcode build
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Automatically enable/disable app extensions from Xcode build

Keep your project compiling on multiple versions of Xcode by removing incompatible app extensions from the build

Read Simultaneous Xcode 7 and Xcode 8 compatibility for more information about this project.

FeaturesUsageInstallationMore info



Say you have an iOS app. You want to add some iOS 10 app extensions to the project, but you still need to build for iOS 9, and you want to avoid branching. You configure your project just right to allow this, but what do you do with app extensions that only compile with Xcode 8?

Simple! You remove them from the "Target Dependencies" and "Embed App Extensions" build phases of the app target before you commit:

configure_extensions remove MyApp.xcodeproj MyAppTarget NotificationsUI Intents

This keeps Xcode 7 compatibility. Want to work on iOS 10 features? Add them back in an instant:

configure_extensions add MyApp.xcodeproj MyAppTarget NotificationsUI Intents

No branching necessary.

(You can also use configure_extensions to add a "fast mode" to your automated build server that skips compilation of unnecessary app extensions)


Here's full syntax of the tool:

configure_extensions <mode> <project> <app_target> <extensions...>

Add and remove app extensions from Xcode build

   add    - enables passed app extension targets
   remove - disables extensions from being built and embedded in the app

   path to the Xcode project file

   name of the main (app) target in which extensions are to be enabled/disabled

   names of app extension targets to be enabled/disabled


configure_extensions add MyApp.xcodeproj MyApp NotificationsUI Share
configure_extensions remove Foo.xcodeproj Foo-iOS Share


sudo gem install configure_extensions

More like this

If you like configure_extensions, be sure to check out "Simultaneous Xcode 7 and Xcode 8 compatibility" where I explain in detail how to keep a single Xcode project running on multiple versions of Xcode without branching.

And if you're into Swift, you might also like SwiftyUserDefaults and SwiftyTimer.


If you have comments, complaints or ideas for improvements, feel free to open an issue or a pull request. Or ping me on Twitter.

Author and license

Radek Pietruszewski

configure_extensions is available under the MIT license. See the LICENSE file for more info.