Class: RunLoop::Device
Constant Summary collapse
- SIM_STABLE_STATE_OPTIONS =
Starting in Xcode 7, iOS 9 simulators have a new “booting” state.
The simulator must completely boot before run-loop tries to do things like installing an app or clearing an app sandbox. Run-loop tries to wait for a the simulator stabilize by watching the checksum of the simulator directory and the simulator log.
On resource constrained devices or CI systems, the default settings may not work.
You can override these values if they do not work in your environment.
For cucumber users, the best place to override would be in your features/support/env.rb.
For example:
{ # The maximum amount of time to wait for the simulator # to stabilize. No errors are raised if this timeout is # exceeded - if the default 30 seconds has passed, the # simulator is probably stable enough for subsequent # operations. :timeout => RunLoop::Environment.ci? ? 240 : 120 }
Constants included from Shell
Instance Attribute Summary collapse
-
#name ⇒ Object
readonly
Returns the value of attribute name.
-
#state ⇒ Object
readonly
Returns the value of attribute state.
-
#udid ⇒ Object
readonly
Returns the value of attribute udid.
-
#version ⇒ Object
readonly
Returns the value of attribute version.
Class Method Summary collapse
-
.device_with_identifier(udid_or_name, options = {}) ⇒ RunLoop::Device
Returns a device given a udid or name.
Instance Method Summary collapse
-
#initialize(name, version, udid, state = nil) ⇒ Device
constructor
Create a new device.
-
#instruction_set ⇒ String
Return the instruction set for this device.
-
#instruments_identifier(xcode) ⇒ String
Returns and instruments-ready device identifier that is a suitable value for DEVICE_TARGET environment variable.
-
#physical_device? ⇒ Boolean
Is this a physical device?.
-
#simulator? ⇒ Boolean
Is this a simulator?.
- #simulator_ensure_software_keyboard_will_show ⇒ Object
- #simulator_software_keyboard_will_show? ⇒ Boolean
Methods included from Shell
run_shell_command, #run_shell_command
Methods included from Encoding
Constructor Details
#initialize(name, version, udid, state = nil) ⇒ Device
Create a new device.
57 58 59 60 61 62 63 64 65 66 67 |
# File 'lib/run_loop/device.rb', line 57 def initialize(name, version, udid, state=nil) @name = name @udid = udid @state = state if version.is_a? String @version = RunLoop::Version.new version else @version = version end end |
Instance Attribute Details
#name ⇒ Object (readonly)
Returns the value of attribute name.
37 38 39 |
# File 'lib/run_loop/device.rb', line 37 def name @name end |
#state ⇒ Object (readonly)
Returns the value of attribute state.
40 41 42 |
# File 'lib/run_loop/device.rb', line 40 def state @state end |
#udid ⇒ Object (readonly)
Returns the value of attribute udid.
39 40 41 |
# File 'lib/run_loop/device.rb', line 39 def udid @udid end |
#version ⇒ Object (readonly)
Returns the value of attribute version.
38 39 40 |
# File 'lib/run_loop/device.rb', line 38 def version @version end |
Class Method Details
.device_with_identifier(udid_or_name, options = {}) ⇒ RunLoop::Device
Returns a device given a udid or name. In the case of a physical device, the udid is the device identifier. In the case of a simulator the name is the _instruments identifier_ as reported by ‘$ xcrun instruments -s devices` - this is the identifier that can be passed to instruments.
Note that if you have a device and simulator with the same name, the simulator will always be selected.
96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 |
# File 'lib/run_loop/device.rb', line 96 def self.device_with_identifier(udid_or_name, ={}) if .is_a?(RunLoop::SimControl) raise ArgumentError, %q[Support for the 'sim_control' argument has been removed (1.5.0). It has been replaced by an options hash with two keys: :simctl and :instruments. Please update your sources.))] end = { :simctl => RunLoop::Simctl.new, :instruments => RunLoop::Instruments.new, :xcode => RunLoop::Xcode.new } = .merge() instruments = [:instruments] simctl = [:simctl] xcode = [:xcode] simulator = simctl.simulators.detect do |sim| sim.instruments_identifier(xcode) == udid_or_name || sim.udid == udid_or_name end return simulator if !simulator.nil? physical_device = instruments.physical_devices.detect do |device| device.name == udid_or_name || device.udid == udid_or_name end return physical_device if !physical_device.nil? raise ArgumentError, "Could not find a device with a UDID or name matching '#{udid_or_name}'" end |
Instance Method Details
#instruction_set ⇒ String
Finding the instruction set of a device requires a third-party tool like ideviceinfo. Example: ‘$ ideviceinfo -u 89b59 < snip > ab7ba –key ’CPUArchitecture’ => arm64`
Return the instruction set for this device.
Simulator The simulator instruction set will be i386 or x86_64 depending on the the (marketing) name of the device.
243 244 245 246 247 248 249 250 251 252 253 |
# File 'lib/run_loop/device.rb', line 243 def instruction_set if simulator? if ['iPhone 4s', 'iPhone 5', 'iPad 2', 'iPad Retina'].include?(self.name) 'i386' else 'x86_64' end else raise 'Finding the instruction set of a device requires a third-party tool like ideviceinfo' end end |
#instruments_identifier(xcode) ⇒ String
Returns and instruments-ready device identifier that is a suitable value for DEVICE_TARGET environment variable.
190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 |
# File 'lib/run_loop/device.rb', line 190 def instruments_identifier(xcode) if physical_device? udid else if version == RunLoop::Version.new('7.0.3') version_part = version.to_s else version_part = "#{version.major}.#{version.minor}" end if xcode.version_gte_7? "#{name} (#{version_part})" else "#{name} (#{version_part} Simulator)" end end end |
#physical_device? ⇒ Boolean
Is this a physical device?
210 211 212 213 214 215 216 217 218 219 220 221 222 223 |
# File 'lib/run_loop/device.rb', line 210 def physical_device? if udid.nil? stack = Kernel.caller(0, 6)[0..-1].join("\n") raise RuntimeError, %Q[udid is nil #{stack} name: #{name} version: #{version} ] end !udid[DEVICE_UDID_REGEX, 0].nil? end |
#simulator? ⇒ Boolean
Is this a simulator?
227 228 229 |
# File 'lib/run_loop/device.rb', line 227 def simulator? !physical_device? end |
#simulator_ensure_software_keyboard_will_show ⇒ Object
505 506 507 508 |
# File 'lib/run_loop/device.rb', line 505 def simulator_ensure_software_keyboard_will_show plist = simulator_preferences_plist_path pbuddy.plist_set("AutomaticMinimizationEnabled", "integer", 0, plist) end |
#simulator_software_keyboard_will_show? ⇒ Boolean
500 501 502 503 |
# File 'lib/run_loop/device.rb', line 500 def simulator_software_keyboard_will_show? plist = simulator_preferences_plist_path pbuddy.plist_read("AutomaticMinimizationEnabled", plist).to_i == 0 end |