krausefx-shenzhen 0.14.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e9dcf3992465f173b3273dd22c4bfd5d71b42dd7
+  data.tar.gz: c526db6c2bcc0fd7f45e9b2612d0a393f11670db
+SHA512:
+  metadata.gz: ae852791af679b572b4e39726a661a4cbcbac2d8dab9bc0c460fe0b7903b4369e83690b63d7eeb4ec244657f9c82e7c998de3e29b0de867de2f2153a4f6fba3d
+  data.tar.gz: f02238a3d2be2e1e02bada918969fe3031a78a50b342e945c42c1db77b82c86df2bd4adc6303a46b1476ba9963239f71e274d8812cd77dd89a484bc0ffc7d0ea

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,68 @@
+PATH
+  remote: .
+  specs:
+    krausefx-shenzhen (0.14.1)
+      aws-sdk (~> 1.0)
+      commander (~> 4.3)
+      dotenv (>= 0.7)
+      faraday (~> 0.8.9)
+      faraday_middleware (~> 0.9)
+      highline (>= 1.7.2)
+      json (~> 1.8)
+      net-sftp (~> 2.1.2)
+      plist (~> 3.1.0)
+      rubyzip (~> 1.1)
+      security (~> 0.1.3)
+      terminal-table (~> 1.4.5)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    aws-sdk (1.64.0)
+      aws-sdk-v1 (= 1.64.0)
+    aws-sdk-v1 (1.64.0)
+      json (~> 1.4)
+      nokogiri (>= 1.4.4)
+    commander (4.3.4)
+      highline (~> 1.7.2)
+    diff-lcs (1.2.5)
+    dotenv (2.0.1)
+    faraday (0.8.9)
+      multipart-post (~> 1.2.0)
+    faraday_middleware (0.9.1)
+      faraday (>= 0.7.4, < 0.10)
+    highline (1.7.2)
+    json (1.8.2)
+    mini_portile (0.6.2)
+    multipart-post (1.2.0)
+    net-sftp (2.1.2)
+      net-ssh (>= 2.6.5)
+    net-ssh (2.9.2)
+    nokogiri (1.6.6.2)
+      mini_portile (~> 0.6.0)
+    plist (3.1.0)
+    rake (10.4.2)
+    rspec (3.2.0)
+      rspec-core (~> 3.2.0)
+      rspec-expectations (~> 3.2.0)
+      rspec-mocks (~> 3.2.0)
+    rspec-core (3.2.3)
+      rspec-support (~> 3.2.0)
+    rspec-expectations (3.2.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-mocks (3.2.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-support (3.2.2)
+    rubyzip (1.1.7)
+    security (0.1.3)
+    terminal-table (1.4.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  krausefx-shenzhen!
+  rake
+  rspec

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2012–2015 Mattt Thompson (http://mattt.me/)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,198 @@
+![Shenzhen](https://raw.github.com/nomad/nomad.github.io/assets/shenzhen-banner.png)
+
+Create `.ipa` files and distribute them from the command line, using any of the following methods:
+
+- [iTunes Connect](https://itunesconnect.apple.com)
+- [HockeyApp](http://www.hockeyapp.net)
+- [Beta by Crashlytics](http://try.crashlytics.com/beta/)
+- [RivieraBuild](http://rivierabuild.com)
+- [TestFairy](https://www.testfairy.com/)
+- [DeployGate](https://deploygate.com)
+- [Fly It Remotely (FIR.im)](http://fir.im)
+- [蒲公英 (PGYER)](http://www.pgyer.com)
+- [Amazon S3](http://aws.amazon.com/s3/)
+- FTP / SFTP
+
+Less cumbersome than clicking around in Xcode, and less hassle than rolling your own build script, Shenzhen radically improves the process of getting new builds out to testers and enterprises.
+
+> `shenzhen` is named for [深圳](http://en.wikipedia.org/wiki/Shenzhen), the Chinese city famous for being the center of manufacturing for a majority of consumer electronics, including iPhones and iPads.
+> It's part of a series of world-class command-line utilities for iOS development, which includes [Cupertino](https://github.com/mattt/cupertino) (Apple Dev Center management), [Houston](https://github.com/mattt/houston) (Push Notifications), [Venice](https://github.com/mattt/venice) (In-App Purchase Receipt Verification), [Dubai](https://github.com/mattt/dubai) (Passbook pass generation), and [Nashville](https://github.com/nomad/nashville) (iTunes Store API).
+
+## Installation
+
+```
+$ gem install shenzhen
+```
+
+### JSON Build Error
+
+Users running Mac OS X Mavericks with Xcode 5.1 may encounter an error when attempting to install the `json` gem dependency. As per the [Xcode 5.1 Release Notes](https://developer.apple.com/library/ios/releasenotes/DeveloperTools/RN-Xcode/Introduction/Introduction.html):
+
+> The Apple LLVM compiler in Xcode 5.1 treats unrecognized command-line options as errors. This issue has been seen when building both Python native extensions and Ruby Gems, where some invalid compiler options are currently specified.
+
+To work around this, install the `json` gem first with the following command:
+
+```
+$ ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future gem install json
+```
+
+## Usage
+
+> For best results, set your environment localization to UTF-8, with `$ export LC_ALL="en_US.UTF-8"`. Otherwise, Shenzhen may return unexpectedly with the error "invalid byte sequence in US-ASCII".
+
+Shenzhen adds the `ipa` command to your PATH:
+
+```
+$ ipa
+
+Build and distribute iOS apps (.ipa files)
+
+  Commands:
+    build                       Create a new .ipa file for your app
+    distribute:rivierabuild     Distribute an .ipa file over [RivieraBuild](http://rivierabuild.com)
+    distribute:hockeyapp        Distribute an .ipa file over HockeyApp
+    distribute:crashlytics      Distribute an .ipa file over Crashlytics
+    distribute:deploygate       Distribute an .ipa file over deploygate
+    distribute:firim            Distribute an .ipa file over fir.im
+    distribute:itunesconnect    Upload an .ipa file to iTunes Connect for review
+    distribute:pgyer            Distribute an .ipa file over Pgyer
+    distribute:ftp              Distribute an .ipa file over FTP
+    distribute:s3               Distribute an .ipa file over Amazon S3
+    distribute:testfairy        Distribute an .ipa file over TestFairy
+    info                        Show mobile provisioning information about an .ipa file
+    help                        Display global or [command] help documentation.
+
+  Global Options:
+    -h, --help           Display help documentation
+    -v, --version        Display version information
+    -t, --trace          Display backtrace when an error occurs
+```
+
+### Building & Distribution
+
+```
+$ cd /path/to/iOS Project/
+$ ipa build
+$ ipa distribute
+```
+
+#### RivieraBuild Distribution
+
+```
+$ ipa distribute:rivierabuild -k API_TOKEN -a AVAILABILITY
+```
+
+> Shenzhen will load credentials from the environment variable `RIVIERA_API_TOKEN` unless otherwise specified.
+> To get the list of availability options, visit http://api.rivierabuild.com
+
+#### HockeyApp Distribution
+
+```
+$ ipa distribute:hockeyapp -a API_TOKEN
+```
+
+> Shenzhen will load credentials from the environment variable `HOCKEYAPP_API_TOKEN` unless otherwise specified.
+
+#### TestFairy Distribution
+
+```
+$ ipa distribute:testfairy -a API_KEY
+```
+
+> Shenzhen will load credentials from the environment variable `TESTFAIRY_API_KEY` unless otherwise specified.
+
+#### Crashlytics Beta Distribution
+
+```
+$ ipa distribute:crashlytics -c /path/to/Crashlytics.framework -a API_TOKEN -s BUILD_SECRET
+```
+
+> Shenzhen will load credentials from the environment variables `CRASHLYTICS_API_TOKEN` & `CRASHLYTICS_BUILD_SECRET`, and attempt to run the submit executable `submit` in the path to Crashlytics.framework specified by `CRASHLYTICS_FRAMEWORK_PATH` unless otherwise specified.
+
+
+#### DeployGate Distribution
+
+```
+$ ipa distribute:deploygate -a API_TOKEN -u USER_NAME
+```
+
+> Shenzhen will load credentials from the environment variable `DEPLOYGATE_API_TOKEN` and `DEPLOYGATE_USER_NAME` unless otherwise specified.
+
+#### FTP Distribution
+
+```
+$ ipa distribute:ftp --host HOST -u USER -p PASSWORD -P FTP_PATH
+```
+
+#### SFTP Distribution
+
+```
+$ ipa distribute:sftp --host HOST -u USER -p PASSWORD -P FTP_PATH
+```
+
+#### Amazon S3 Distribution
+
+```
+$ ipa distribute:s3 -a ACCESS_KEY_ID -s SECRET_ACCESS_KEY -b BUCKET
+```
+
+> Shenzhen will load credentials from the environment variables `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` and `AWS_REGION` unless otherwise specified.
+
+#### FIR (Fly it Remotely)
+
+```
+$ ipa distribute:fir -u USER_TOKEN -a APP_ID
+```
+
+> Shenzhen will load credentials from the environment variables `FIR_USER_TOKEN`, `FIR_APP_ID` unless otherwise specified.
+
+#### 蒲公英 (PGYER)
+
+```
+$ ipa distribute:pgyer -u USER_KEY -a APP_KEY
+```
+
+> Shenzhen will load credentials from the environment variables `PGYER_USER_KEY`, `PGYER_API_KEY` unless otherwise specified.
+
+
+#### iTunes Connect Distribution
+
+```
+$ ipa distribute:itunesconnect -a me@email.com -p myitunesconnectpassword -i appleid --upload
+```
+
+> Shenzhen will load credentials from the environment variables `ITUNES_CONNECT_ACCOUNT` and `ITUNES_CONNECT_PASSWORD` unless otherwise specified. If only an account is provided, the keychain will be searched for a matching entry.
+>
+> The `-i` (or `--apple-id`) flag is "An automatically generated ID assigned to your app". It can be found via iTunes Connect by navigating to:
+> * My Apps -> [App Name] -> More -> About This App -> Apple ID
+>
+> For a fully hands-free upload, in a CI environment for example, ensure your iTunes Connect credentials are stored in your keychain, and that the keychain item has the Validation app in its 'Always allow access' list.  Running Shenzhen once with the `--save-keychain` flag, and clicking `Always Allow` on the prompt will set this up for you.
+
+### Displaying Embedded .mobileprovision Information
+
+```
+$ ipa info /path/to/app.ipa
+
++-----------------------------+----------------------------------------------------------+
+| ApplicationIdentifierPrefix | DJ73OPSO53                                               |
+| CreationDate                | 2014-03-26T02:53:00+00:00                                |
+| Entitlements                | application-identifier: DJ73OPSO53.com.nomad.shenzhen    |
+|                             | aps-environment: production                              |
+|                             | get-task-allow: false                                    |
+|                             | keychain-access-groups: ["DJ73OPSO53.*"]                 |
+| CreationDate                | 2017-03-26T02:53:00+00:00                                |
+| Name                        | Shenzhen                                                 |
+| TeamIdentifier              | S6ZYP4L6TY                                               |
+| TimeToLive                  | 172                                                      |
+| UUID                        | P7602NR3-4D34-441N-B6C9-R79395PN1OO3                     |
+| Version                     | 1                                                        |
++-----------------------------+----------------------------------------------------------+
+```
+
+## Creator
+
+Mattt Thompson ([@mattt](https://twitter.com/mattt))
+
+## License
+
+Shenzhen is released under an MIT license. See LICENSE for more information.

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/setup"
+
+gemspec = eval(File.read("shenzhen.gemspec"))
+
+task :build => "#{gemspec.full_name}.gem"
+
+file "#{gemspec.full_name}.gem" => gemspec.files + ["shenzhen.gemspec"] do
+  system "gem build shenzhen.gemspec"
+end

data/lib/shenzhen.rb

@@ -0,0 +1,4 @@
+require 'shenzhen/version'
+require 'shenzhen/agvtool'
+require 'shenzhen/xcodebuild'
+require 'shenzhen/plistbuddy'

data/lib/shenzhen/agvtool.rb

@@ -0,0 +1,17 @@
+module Shenzhen::Agvtool
+  class << self
+    def what_version
+      output = `agvtool what-version -terse`
+      output.length > 0 ? output : nil
+    end
+    
+    alias :vers :what_version
+    
+    def what_marketing_version
+      output = `agvtool what-marketing-version -terse`
+      output.scan(/\=(.+)$/).flatten.first
+    end
+    
+    alias :mvers :what_marketing_version
+  end
+end

data/lib/shenzhen/commands.rb

@@ -0,0 +1,16 @@
+$:.push File.expand_path('../', __FILE__)
+
+require 'plugins/rivierabuild'
+require 'plugins/hockeyapp'
+require 'plugins/testfairy'
+require 'plugins/deploygate'
+require 'plugins/itunesconnect'
+require 'plugins/ftp'
+require 'plugins/s3'
+require 'plugins/crashlytics'
+require 'plugins/fir'
+require 'plugins/pgyer'
+
+require 'commands/build'
+require 'commands/distribute'
+require 'commands/info'

data/lib/shenzhen/commands/build.rb

@@ -0,0 +1,213 @@
+require 'fileutils'
+
+command :build do |c|
+  c.syntax = 'ipa build [options]'
+  c.summary = 'Create a new .ipa file for your app'
+  c.description = ''
+
+  c.option '-w', '--workspace WORKSPACE', 'Workspace (.xcworkspace) file to use to build app (automatically detected in current directory)'
+  c.option '-p', '--project PROJECT', 'Project (.xcodeproj) file to use to build app (automatically detected in current directory, overridden by --workspace option, if passed)'
+  c.option '-c', '--configuration CONFIGURATION', 'Configuration used to build'
+  c.option '-s', '--scheme SCHEME', 'Scheme used to build app'
+  c.option '--xcconfig XCCONFIG', 'use an extra XCCONFIG file to build the app'
+  c.option '--xcargs XCARGS', 'pass additional arguments to xcodebuild when building the app. Be sure to quote multiple args.'
+  c.option '--[no-]clean', 'Clean project before building'
+  c.option '--[no-]archive', 'Archive project after building'
+  c.option '-d', '--destination DESTINATION', 'Destination. Defaults to current directory'
+  c.option '-m', '--embed PROVISION', 'Sign .ipa file with .mobileprovision'
+  c.option '-i', '--identity IDENTITY', 'Identity to be used along with --embed'
+  c.option '--sdk SDK', 'use SDK as the name or path of the base SDK when building the project'
+  c.option '--ipa IPA', 'specify the name of the .ipa file to generate (including file extension)'
+
+  c.action do |args, options|
+    validate_xcode_version!
+
+    @workspace = options.workspace
+    @project = options.project unless @workspace
+
+    @xcodebuild_info = Shenzhen::XcodeBuild.info(:workspace => @workspace, :project => @project)
+
+    @scheme = options.scheme
+    @sdk = options.sdk || 'iphoneos'
+    @configuration = options.configuration
+    @xcconfig = options.xcconfig
+    @xcargs = options.xcargs
+    @destination = options.destination || Dir.pwd
+    @ipa_name_override = options.ipa
+    FileUtils.mkdir_p(@destination) unless File.directory?(@destination)
+
+    determine_workspace_or_project! unless @workspace || @project
+
+    if @project
+      determine_configuration! unless @configuration
+      say_error "Configuration #{@configuration} not found" and abort unless (@xcodebuild_info.build_configurations.include?(@configuration) rescue false)
+    end
+
+    determine_scheme! unless @scheme
+    say_error "Scheme #{@scheme} not found" and abort unless (@xcodebuild_info.schemes.include?(@scheme) rescue false)
+
+    @configuration = options.configuration
+
+    flags = []
+    flags << %{-sdk #{@sdk}}
+    flags << %{-workspace "#{@workspace}"} if @workspace
+    flags << %{-project "#{@project}"} if @project
+    flags << %{-scheme "#{@scheme}"} if @scheme
+    flags << %{-configuration "#{@configuration}"} if @configuration
+    flags << %{-xcconfig "#{@xcconfig}"} if @xcconfig
+    flags << @xcargs if @xcargs
+
+    @target, @xcodebuild_settings = Shenzhen::XcodeBuild.settings(*flags).detect{|target, settings| settings['WRAPPER_EXTENSION'] == "app"}
+    say_error "App settings could not be found." and abort unless @xcodebuild_settings
+
+    if !@configuration
+      @configuration = @xcodebuild_settings['CONFIGURATION']
+      flags << "-configuration '#{@configuration}'"
+    end
+
+    say_warning "Building \"#{@workspace || @project}\" with Scheme \"#{@scheme}\" and Configuration \"#{@configuration}\"\n" if $verbose
+
+    log "xcodebuild", (@workspace || @project)
+
+    xcode = `xcode-select --print-path`.strip
+
+    actions = []
+    actions << :clean unless options.clean == false
+    actions << :build
+    actions << :archive unless options.archive == false
+
+    ENV['CC'] = nil # Fix for RVM
+    command = %{xcodebuild #{flags.join(' ')} #{actions.join(' ')} #{'1> /dev/null' unless $verbose}}
+    puts command if $verbose
+    abort unless system command
+
+    @target, @xcodebuild_settings = Shenzhen::XcodeBuild.settings(*flags).detect{|target, settings| settings['WRAPPER_EXTENSION'] == "app"}
+    say_error "App settings could not be found." and abort unless @xcodebuild_settings
+
+    @app_path = File.join(@xcodebuild_settings['BUILT_PRODUCTS_DIR'], @xcodebuild_settings['WRAPPER_NAME'])
+    @dsym_path = @app_path + ".dSYM"
+    @dsym_filename = File.expand_path("#{@xcodebuild_settings['WRAPPER_NAME']}.dSYM", @destination)
+    @ipa_name = @ipa_name_override || @xcodebuild_settings['WRAPPER_NAME'].gsub(@xcodebuild_settings['WRAPPER_SUFFIX'], "") + ".ipa"
+    @ipa_path = File.expand_path(@ipa_name, @destination)
+
+    log "xcrun", "PackageApplication"
+    command = %{xcrun -sdk #{@sdk} PackageApplication -v "#{@app_path}" -o "#{@ipa_path}" --embed "#{options.embed || @dsym_path}" #{"-s \"#{options.identity}\"" if options.identity} #{'--verbose' if $verbose} #{'1> /dev/null' unless $verbose}}
+    puts command if $verbose
+    abort unless system command
+
+
+    # Determine whether this is a Swift project and, eventually, the list of libraries to copy from
+    # Xcode's toolchain directory since there's no "xcodebuild" target to do just that (it is done
+    # post-build when exporting an archived build from the "Organizer").
+    @ipa_swift_frameworks = Dir["#{@app_path}/Frameworks/libswift*"]
+
+    if not @ipa_swift_frameworks.empty?
+      Dir.mktmpdir do |tmpdir|
+        # Copy all necessary Swift libraries to a temporary "SwiftSupport" directory so that we can
+        # easily add it to the .ipa later.
+        swift_support = File.join(tmpdir, "SwiftSupport")
+
+        Dir.mkdir(swift_support)
+
+        @ipa_swift_frameworks.each do |path|
+          framework = File.basename(path)
+
+          FileUtils.copy_file("#{xcode}/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift/#{@sdk}/#{framework}", File.join(swift_support, framework))
+        end
+
+        # Add "SwiftSupport" to the .ipa archive
+        Dir.chdir(tmpdir) do
+          abort unless system %{zip --recurse-paths "#{@ipa_path}" "SwiftSupport" #{'> /dev/null' unless $verbose}}
+        end
+      end
+    end
+
+    if is_watchkit?(@app_path)
+      log "Adding WatchKit support files", "#{xcode}/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/Library/Application Support/WatchKit/WK"
+      Dir.mktmpdir do |tmpdir|
+        # Make watchkit support directory
+        watchkit_support = File.join(tmpdir, "WatchKitSupport")
+        Dir.mkdir(watchkit_support)
+
+        # Copy WK from Xcode into WatchKitSupport
+        FileUtils.copy_file("#{xcode}/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/Library/Application Support/WatchKit/WK", File.join(watchkit_support, "WK"))
+
+        # Add "WatchKitSupport" to the .ipa archive
+        Dir.chdir(tmpdir) do
+          abort unless system %{zip --recurse-paths "#{@ipa_path}" "WatchKitSupport" #{'> /dev/null' unless $verbose}}
+        end
+      end
+    end
+
+    log "zip", @dsym_filename
+    abort unless system %{cp -r "#{@dsym_path}" "#{@destination}" && pushd "#{File.dirname(@dsym_filename)}" && zip -r "#{@dsym_filename}.zip" "#{File.basename(@dsym_filename)}" #{'> /dev/null' unless $verbose} && popd && rm -rf "#{@dsym_filename}"}
+
+    say_ok "Successfully built:"
+    say_ok @ipa_path
+  end
+
+  private
+
+  def is_watchkit?(path)
+    Dir["#{path}/**/*.plist"].each do |current|
+      # `2>&1` to hide the error if it's not there: http://stackoverflow.com/a/4783536/445598
+      watchkit_enabled = `/usr/libexec/PlistBuddy -c 'Print WKWatchKitApp' '#{current}' 2>&1`.strip
+      if watchkit_enabled == 'true'
+        return true
+      end
+    end
+    false
+  end
+
+  def validate_xcode_version!
+    version = Shenzhen::XcodeBuild.version
+    say_error "Shenzhen requires Xcode 4 (found #{version}). Please install or switch to the latest Xcode." and abort if version < "4.0.0"
+  end
+
+  def determine_workspace_or_project!
+    workspaces, projects = Dir["*.xcworkspace"], Dir["*.xcodeproj"]
+
+    if workspaces.empty?
+      if projects.empty?
+        say_error "No Xcode projects or workspaces found in current directory" and abort
+      else
+        if projects.length == 1
+          @project = projects.first
+        else
+          @project = choose "Select a project:", *projects
+        end
+      end
+    else
+      if workspaces.length == 1
+        @workspace = workspaces.first
+      else
+        @workspace = choose "Select a workspace:", *workspaces
+      end
+    end
+  end
+
+  def determine_scheme!
+    say_error "No schemes found in Xcode project or workspace" and abort unless @xcodebuild_info.schemes
+
+    if @xcodebuild_info.schemes.length == 1
+      @scheme = @xcodebuild_info.schemes.first
+    else
+      @scheme = choose "Select a scheme:", *@xcodebuild_info.schemes
+    end
+  end
+
+  def determine_configuration!
+    configurations = @xcodebuild_info.build_configurations rescue []
+    if configurations.nil? or configurations.empty? or configurations.include?("Debug")
+      @configuration = "Debug"
+    elsif configurations.length == 1
+      @configuration = configurations.first
+    end
+
+    if @configuration
+      say_warning "Configuration was not passed, defaulting to #{@configuration}"
+    else
+      @configuration = choose "Select a configuration:", *configurations
+    end
+  end
+end