Module: Calabash::Cucumber::SimulatorHelper
- Defined in:
- lib/calabash-cucumber/launch/simulator_helper.rb
Defined Under Namespace
Classes: TimeoutErr
Constant Summary collapse
- DERIVED_DATA =
File.("~/Library/Developer/Xcode/DerivedData")
- DEFAULT_DERIVED_DATA_INFO =
File.("#{DERIVED_DATA}/*/info.plist")
- DEFAULT_SIM_WAIT =
30
- DEFAULT_SIM_RETRY =
2
- FULL_CONSOLE_OUTPUT =
Load environment variable for showing full console output. If not env var set then we use false, i.e. output to console is limited.
ENV['CALABASH_FULL_CONSOLE_OUTPUT'] == '1' ? true : false
Class Method Summary collapse
- .app_bundle_or_raise(path = nil, device_build_dir = 'iPhoneSimulator') ⇒ Object
- .bundle_path_from_xamarin_project(device_build_dir = 'iPhoneSimulator') ⇒ Object
- .derived_data_dir_for_project ⇒ Object
- .detect_app_bundle(path = nil, device_build_dir = 'iPhoneSimulator') ⇒ Object
- .ensure_connectivity(app_bundle_path, sdk, version, args = nil) ⇒ Object
- .find_preferred_dir(sim_dirs) ⇒ Object
- .get_version ⇒ Object
- .ios_major_version ⇒ Object
- .ios_version ⇒ Object
- .launch(app_bundle_path, sdk, version, args = nil) ⇒ Object
- .linked_with_calabash?(d) ⇒ Boolean
- .ping_app ⇒ Object
- .project_dir ⇒ Object
- .relaunch(path, sdk = nil, version = 'iphone', args = nil) ⇒ Object
- .stop ⇒ Object
- .version_check(version) ⇒ Object
- .xamarin_ios_bin_dir?(bin_dir) ⇒ Boolean
- .xamarin_ios_csproj_path ⇒ Object
- .xamarin_project? ⇒ Boolean
Class Method Details
.app_bundle_or_raise(path = nil, device_build_dir = 'iPhoneSimulator') ⇒ Object
127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 127 def self.app_bundle_or_raise(path=nil, device_build_dir='iPhoneSimulator') bundle_path = nil path = File.(path) if path if path and not File.directory?(path) raise "Unable to find .app bundle at #{path}. It should be an .app directory." elsif path bundle_path = path elsif xamarin_project? bundle_path = bundle_path_from_xamarin_project(device_build_dir) unless bundle_path msg = ["Detected Xamarin project, but did not detect built app linked with Calabash"] msg << "You should build your project from Xamarin Studio" msg << "Make sure you build for Simulator and that you're using the Calabash components" raise msg.join("\n") end if FULL_CONSOLE_OUTPUT puts("-"*37) puts "Auto detected APP_BUNDLE_PATH:\n\n" puts "APP_BUNDLE_PATH=#{preferred_dir || sim_dirs[0]}\n\n" puts "Please verify!" puts "If this is wrong please set it as APP_BUNDLE_PATH in features/support/01_launch.rb\n" puts("-"*37) end else dd_dir = derived_data_dir_for_project sim_dirs = Dir.glob(File.join(dd_dir, "Build", "Products", "*-iphonesimulator", "*.app")) if sim_dirs.empty? msg = ["Unable to auto detect APP_BUNDLE_PATH."] msg << "Have you built your app for simulator?." msg << "Searched dir: #{dd_dir}/Build/Products" msg << "Please build your app from Xcode" msg << "You should build the -cal target." msg << "" msg << "Alternatively, specify APP_BUNDLE_PATH in features/support/01_launch.rb" msg << "This should point to the location of your built app linked with calabash.\n" raise msg.join("\n") end preferred_dir = find_preferred_dir(sim_dirs) if preferred_dir.nil? msg = ["Error... Unable to find APP_BUNDLE_PATH."] msg << "Cannot find a built app that is linked with calabash.framework" msg << "Please build your app from Xcode" msg << "You should build your calabash target." msg << "" msg << "Alternatively, specify APP_BUNDLE_PATH in features/support/01_launch.rb" msg << "This should point to the location of your built app linked with calabash.\n" raise msg.join("\n") end if FULL_CONSOLE_OUTPUT puts("-"*37) puts "Auto detected APP_BUNDLE_PATH:\n\n" puts "APP_BUNDLE_PATH=#{preferred_dir || sim_dirs[0]}\n\n" puts "Please verify!" puts "If this is wrong please set it as APP_BUNDLE_PATH in features/support/01_launch.rb\n" puts("-"*37) end bundle_path = sim_dirs[0] end bundle_path end |
.bundle_path_from_xamarin_project(device_build_dir = 'iPhoneSimulator') ⇒ Object
230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 230 def self.bundle_path_from_xamarin_project(device_build_dir='iPhoneSimulator') ios_project_path = xamarin_ios_csproj_path conf_glob = File.join(ios_project_path,'bin',device_build_dir,'*') built_confs = Dir[conf_glob] calabash_build = built_confs.find {|path| File.basename(path) == 'Calabash'} debug_build = built_confs.find {|path| File.basename(path) == 'Debug'} bundle_path = [calabash_build, debug_build, *built_confs].find do |path| next unless path && File.directory?(path) app_dir = Dir[File.join(path,'*.app')].first app_dir && linked_with_calabash?(app_dir) end Dir[File.join(bundle_path,'*.app')].first if bundle_path end |
.derived_data_dir_for_project ⇒ Object
38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 38 def self.derived_data_dir_for_project dir = project_dir xcode_workspace_name = '' info_plist = Dir.glob(DEFAULT_DERIVED_DATA_INFO).find { |plist_file| begin plist = CFPropertyList::List.new(:file => plist_file) hash = CFPropertyList.native_types(plist.value) ws_dir = File.dirname(hash['WorkspacePath']).downcase p_dir = dir.downcase if (p_dir.include? ws_dir) xcode_workspace_name = ws_dir.split('/').last end ws_dir == p_dir rescue false end } if not info_plist.nil? return File.dirname(info_plist) else res = Dir.glob("#{dir}/*.xcodeproj") if res.empty? raise "Unable to find *.xcodeproj in #{dir}" elsif res.count > 1 raise "Unable to found several *.xcodeproj in #{dir}: #{res}" end xcode_proj_name = res.first.split(".xcodeproj")[0] xcode_proj_name = File.basename(xcode_proj_name) build_dirs = Dir.glob("#{DERIVED_DATA}/*").find_all do |xc_proj| File.basename(xc_proj).start_with?(xcode_proj_name) end if (build_dirs.count == 0 && !xcode_workspace_name.empty?) # check for directory named "workspace-{deriveddirectoryrandomcharacters}" build_dirs = Dir.glob("#{DERIVED_DATA}/*").find_all do |xc_proj| File.basename(xc_proj).downcase.start_with?(xcode_workspace_name) end end if (build_dirs.count == 0) msg = ["Unable to find your built app."] msg << "This means that Calabash can't automatically launch iOS simulator." msg << "Searched in Xcode 4.x default: #{DEFAULT_DERIVED_DATA_INFO}" msg << "" msg << "To fix there are a couple of options:\n" msg << "Option 1) Make sure you are running this command from your project directory, " msg << "i.e., the directory containing your .xcodeproj file." msg << "In Xcode, build your calabash target for simulator." msg << "Check that your app can be found in\n #{File.("~/Library/Developer/Xcode/DerivedData")}" msg << "\n\nOption 2). In features/support/01_launch.rb set APP_BUNDLE_PATH to" msg << "the path where Xcode has built your Calabash target." msg << "Alternatively you can use the environment variable APP_BUNDLE_PATH.\n" raise msg.join("\n") elsif (build_dirs.count > 1) msg = ["Unable to auto detect APP_BUNDLE_PATH."] msg << "You have several projects with the same name: #{xcode_proj_name} in #{DERIVED_DATA}:\n" msg << build_dirs.join("\n") msg << "\nThis means that Calabash can't automatically launch iOS simulator." msg << "Searched in Xcode 4.x default: #{DEFAULT_DERIVED_DATA_INFO}" msg << "\nIn features/support/01_launch.rb set APP_BUNDLE_PATH to" msg << "the path where Xcode has built your Calabash target." msg << "Alternatively you can use the environment variable APP_BUNDLE_PATH.\n" raise msg.join("\n") else puts "Found potential build dir: #{build_dirs.first}" puts "Checking..." return build_dirs.first end end end |
.detect_app_bundle(path = nil, device_build_dir = 'iPhoneSimulator') ⇒ Object
119 120 121 122 123 124 125 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 119 def self.detect_app_bundle(path=nil,device_build_dir='iPhoneSimulator') begin app_bundle_or_raise(path,device_build_dir) rescue =>e nil end end |
.ensure_connectivity(app_bundle_path, sdk, version, args = nil) ⇒ Object
258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 258 def self.ensure_connectivity(app_bundle_path, sdk, version, args = nil) begin max_retry_count = (ENV['MAX_CONNECT_RETRY'] || DEFAULT_SIM_RETRY).to_i timeout = (ENV['CONNECT_TIMEOUT'] || DEFAULT_SIM_WAIT).to_i retry_count = 0 connected = false if FULL_CONSOLE_OUTPUT puts "Waiting at most #{timeout} seconds for simulator (CONNECT_TIMEOUT)" puts "Retrying at most #{max_retry_count} times (MAX_CONNECT_RETRY)" end until connected do raise "MAX_RETRIES" if retry_count == max_retry_count retry_count += 1 if FULL_CONSOLE_OUTPUT puts "(#{retry_count}.) Start Simulator #{sdk}, #{version}, for #{app_bundle_path}" end begin Timeout::timeout(timeout, TimeoutErr) do simulator = launch(app_bundle_path, sdk, version, args) until connected begin connected = (ping_app == '405') if connected server_version = get_version if server_version if FULL_CONSOLE_OUTPUT p server_version end unless version_check(server_version) msgs = ["You're running an older version of Calabash server with a newer client", "Client:#{Calabash::Cucumber::VERSION}", "Server:#{server_version}", "Minimum server version #{Calabash::Cucumber::FRAMEWORK_VERSION}", "Update recommended:", "https://github.com/calabash/calabash-ios/wiki/B1-Updating-your-Calabash-iOS-version" ] raise msgs.join("\n") end else connected = false end end rescue Exception => e ensure sleep 1 unless connected end end end rescue TimeoutErr => e puts 'Timed out...' end end rescue RuntimeError => e p e msg = "Unable to make connection to Calabash Server at #{ENV['DEVICE_ENDPOINT']|| "http://localhost:37265/"}\n" msg << "Make sure you've' linked correctly with calabash.framework and set Other Linker Flags.\n" msg << "Make sure you don't have a firewall blocking traffic to #{ENV['DEVICE_ENDPOINT']|| "http://localhost:37265/"}.\n" raise msg end end |
.find_preferred_dir(sim_dirs) ⇒ Object
252 253 254 255 256 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 252 def self.find_preferred_dir(sim_dirs) sim_dirs.find do |d| linked_with_calabash?(d) end end |
.get_version ⇒ Object
347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 347 def self.get_version endpoint = ENV['DEVICE_ENDPOINT']|| "http://localhost:37265" endpoint += "/" unless endpoint.end_with? "/" url = URI.parse("#{endpoint}version") if FULL_CONSOLE_OUTPUT puts "Fetch version #{url}..." end begin body = Net::HTTP.get_response(url).body res = JSON.parse(body) if res['iOS_version'] @ios_version = res['iOS_version'] end res rescue nil end end |
.ios_major_version ⇒ Object
374 375 376 377 378 379 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 374 def self.ios_major_version v = ios_version if v v.split(".")[0] end end |
.ios_version ⇒ Object
367 368 369 370 371 372 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 367 def self.ios_version unless @ios_version get_version end @ios_version end |
.launch(app_bundle_path, sdk, version, args = nil) ⇒ Object
323 324 325 326 327 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 323 def self.launch(app_bundle_path, sdk, version, args = nil) simulator = SimLauncher::Simulator.new simulator.launch_ios_app(app_bundle_path, sdk, version) simulator end |
.linked_with_calabash?(d) ⇒ Boolean
247 248 249 250 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 247 def self.linked_with_calabash?(d) out = `otool "#{File.(d)}"/* -o 2> /dev/null | grep CalabashServer` /CalabashServer/.match(out) end |
.ping_app ⇒ Object
329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 329 def self.ping_app url = URI.parse(ENV['DEVICE_ENDPOINT']|| "http://localhost:37265/") if FULL_CONSOLE_OUTPUT puts "Ping #{url}..." end http = Net::HTTP.new(url.host, url.port) res = http.start do |sess| sess.request Net::HTTP::Get.new url.path end status = res.code begin http.finish if http and http.started? rescue end status end |
.project_dir ⇒ Object
115 116 117 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 115 def self.project_dir File.(ENV['PROJECT_DIR'] || Dir.pwd) end |
.relaunch(path, sdk = nil, version = 'iphone', args = nil) ⇒ Object
26 27 28 29 30 31 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 26 def self.relaunch(path, sdk = nil, version = 'iphone', args = nil) app_bundle_path = app_bundle_or_raise(path) ensure_connectivity(app_bundle_path, sdk, version, args) end |
.stop ⇒ Object
33 34 35 36 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 33 def self.stop simulator = SimLauncher::Simulator.new simulator.quit_simulator end |
.version_check(version) ⇒ Object
381 382 383 384 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 381 def self.version_check(version) server_version = version["version"] Calabash::Cucumber::FRAMEWORK_VERSION == server_version end |
.xamarin_ios_bin_dir?(bin_dir) ⇒ Boolean
224 225 226 227 228 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 224 def self.xamarin_ios_bin_dir?(bin_dir) File.directory?(bin_dir) && (File.directory?(File.join(bin_dir,'iPhoneSimulator')) || File.directory?(File.join(bin_dir,'iPhone'))) end |
.xamarin_ios_csproj_path ⇒ Object
195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 195 def self.xamarin_ios_csproj_path solution_path = Dir['*.sln'].first if solution_path project_dir = Dir.pwd else solution_path = Dir[File.join('..','*.sln')].first project_dir = File.('..') if solution_path end return nil unless project_dir ios_project_dir = Dir[File.join(project_dir,'*.iOS')].first return ios_project_dir if ios_project_dir && File.directory?(ios_project_dir) # ios_project_dir does not exist # Detect case where there is no such sub directory # (i.e. iOS only Xamarin project) bin_dir = File.join(project_dir, 'bin') if xamarin_ios_bin_dir?(bin_dir) return project_dir ## Looks like iOS bin dir is here end sub_dirs = Dir[File.join(project_dir,'*')].select {|dir| File.directory?(dir)} sub_dirs.find do |sub_dir| contains_csproj = Dir[File.join(sub_dir,'*.csproj')].first contains_csproj && xamarin_ios_bin_dir?(File.join(sub_dir,'bin')) end end |
.xamarin_project? ⇒ Boolean
191 192 193 |
# File 'lib/calabash-cucumber/launch/simulator_helper.rb', line 191 def self.xamarin_project? xamarin_ios_csproj_path != nil end |