Class: RunLoop::Device
- Inherits:
-
Object
- Object
- RunLoop::Device
- Defined in:
- lib/run_loop/device.rb
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? ? 120 : 30 }
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?.
Constructor Details
#initialize(name, version, udid, state = nil) ⇒ Device
Create a new device.
55 56 57 58 59 60 61 62 63 64 65 |
# File 'lib/run_loop/device.rb', line 55 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.
34 35 36 |
# File 'lib/run_loop/device.rb', line 34 def name @name end |
#state ⇒ Object (readonly)
Returns the value of attribute state.
37 38 39 |
# File 'lib/run_loop/device.rb', line 37 def state @state end |
#udid ⇒ Object (readonly)
Returns the value of attribute udid.
36 37 38 |
# File 'lib/run_loop/device.rb', line 36 def udid @udid end |
#version ⇒ Object (readonly)
Returns the value of attribute version.
35 36 37 |
# File 'lib/run_loop/device.rb', line 35 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.
94 95 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 |
# File 'lib/run_loop/device.rb', line 94 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 = RunLoop::Xcode.new 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.
241 242 243 244 245 246 247 248 249 250 251 |
# File 'lib/run_loop/device.rb', line 241 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.
188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 |
# File 'lib/run_loop/device.rb', line 188 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?
208 209 210 211 212 213 214 215 216 217 218 219 220 221 |
# File 'lib/run_loop/device.rb', line 208 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?
225 226 227 |
# File 'lib/run_loop/device.rb', line 225 def simulator? !physical_device? end |