Class: AppInfo::MobileProvision

Inherits:
File
  • Object
show all
Defined in:
lib/app_info/mobile_provision.rb

Overview

Apple code signing: provisioning profile parser

See Also:

Instance Attribute Summary

Attributes inherited from File

#file, #logger

Instance Method Summary collapse

Methods inherited from File

#device, #format, #initialize, #not_implemented_error!, #size

Constructor Details

This class inherits a constructor from AppInfo::File

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method_name, *args, &block) ⇒ Object 



253
254
255
256
257
 
# File 'lib/app_info/mobile_provision.rb', line 253

def method_missing(method_name, *args, &block)
  mobileprovision.try(:[], method_name.to_s.ai_camelcase) ||
    mobileprovision.send(method_name) ||
    super
end

Instance Method Details

#[](key) ⇒ String?

Returns:

  • (String, nil) 


232
233
234
 
# File 'lib/app_info/mobile_provision.rb', line 232

def [](key)
  mobileprovision.try(:[], key.to_s)
end

#adhoc? ⇒ Boolea

Returns:

  • (Boolea) 


140
141
142
143
144
 
# File 'lib/app_info/mobile_provision.rb', line 140

def adhoc?
  return false if platform == Platform::MACOS # macOS no need adhoc

  !development? && !devices.nil?
end

#app_name ⇒ String?

Returns:

  • (String, nil) 


33
34
35
 
# File 'lib/app_info/mobile_provision.rb', line 33

def app_name
  mobileprovision.try(:[], 'AppIDName')
end

#appstore? ⇒ Boolea

Detect app store type

Returns:

  • (Boolea)

See Also:



128
129
130
131
132
133
134
135
136
137
 
# File 'lib/app_info/mobile_provision.rb', line 128

def appstore?
  case platform
  when Platform::IOS
    !development? && entitlements.key?('beta-reports-active')
  when Platform::MACOS
    !development?
  else
    raise NotImplementedError, "Unknown platform: #{platform}"
  end
end

#certificates ⇒ Array<Certificate>

return developer certificates.

Returns:



100
101
102
103
104
105
106
107
 
# File 'lib/app_info/mobile_provision.rb', line 100

def certificates
  certs = mobileprovision.try(:[], 'DeveloperCertificates')
  return if certs.empty?

  certs.each_with_object([]) do |cert_data, obj|
    obj << Certificate.parse(cert_data)
  end
end

#created_date ⇒ String?

Returns:

  • (String, nil) 


76
77
78
 
# File 'lib/app_info/mobile_provision.rb', line 76

def created_date
  mobileprovision.try(:[], 'CreationDate')
end

#developer_certs ⇒ Object

Deprecated.

Use #certificates instead of this method.

return developer certificates.



93
94
95
 
# File 'lib/app_info/mobile_provision.rb', line 93

def developer_certs
  certificates
end

#development? ⇒ Boolea

Detect is development type of mobileprovision

Returns:

  • (Boolea)

See Also:



113
114
115
116
117
118
119
120
121
122
 
# File 'lib/app_info/mobile_provision.rb', line 113

def development?
  case platform
  when Platform::IOS
    entitlements['get-task-allow'] == true
  when Platform::MACOS
    !devices.nil?
  else
    raise NotImplementedError, "Unknown platform: #{platform}"
  end
end

#devices ⇒ Array<String>?

Returns:

  • (Array<String>, nil) 


56
57
58
 
# File 'lib/app_info/mobile_provision.rb', line 56

def devices
  mobileprovision.try(:[], 'ProvisionedDevices')
end

#empty? ⇒ Boolea

Returns:

  • (Boolea) 


237
238
239
 
# File 'lib/app_info/mobile_provision.rb', line 237

def empty?
  mobileprovision.nil?
end

#enabled_capabilities ⇒ Array<String>

Enabled Capabilites

Returns:

  • (Array<String>)

See Also:



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
190
191
192
193
194
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
223
224
225
226
227
228
229
 
# File 'lib/app_info/mobile_provision.rb', line 158

def enabled_capabilities
  capabilities = []
  capabilities << 'In-App Purchase' << 'GameKit' if adhoc? || appstore?

  entitlements.each do |key, _|
    case key
    when 'aps-environment'
      capabilities << 'Push Notifications'
    when 'com.apple.developer.applesignin'
      capabilities << 'Sign In with Apple'
    when 'com.apple.developer.siri'
      capabilities << 'SiriKit'
    when 'com.apple.security.application-groups'
      capabilities << 'App Groups'
    when 'com.apple.developer.associated-domains'
      capabilities << 'Associated Domains'
    when 'com.apple.developer.default-data-protection'
      capabilities << 'Data Protection'
    when 'com.apple.developer.networking.networkextension'
      capabilities << 'Network Extensions'
    when 'com.apple.developer.networking.vpn.api'
      capabilities << 'Personal VPN'
    when 'com.apple.developer.healthkit',
        'com.apple.developer.healthkit.access'
      capabilities << 'HealthKit' unless capabilities.include?('HealthKit')
    when 'com.apple.developer.icloud-services',
        'com.apple.developer.icloud-container-identifiers'
      capabilities << 'iCloud' unless capabilities.include?('iCloud')
    when 'com.apple.developer.in-app-payments'
      capabilities << 'Apple Pay'
    when 'com.apple.developer.homekit'
      capabilities << 'HomeKit'
    when 'com.apple.developer.user-fonts'
      capabilities << 'Fonts'
    when 'com.apple.developer.pass-type-identifiers'
      capabilities << 'Wallet'
    when 'inter-app-audio'
      capabilities << 'Inter-App Audio'
    when 'com.apple.developer.networking.multipath'
      capabilities << 'Multipath'
    when 'com.apple.developer.authentication-services.autofill-credential-provider'
      capabilities << 'AutoFill Credential Provider'
    when 'com.apple.developer.networking.wifi-info'
      capabilities << 'Access WiFi Information'
    when 'com.apple.external-accessory.wireless-configuration'
      capabilities << 'Wireless Accessory Configuration'
    when 'com.apple.developer.kernel.extended-virtual-addressing'
      capabilities << 'Extended Virtual Address Space'
    when 'com.apple.developer.nfc.readersession.formats'
      capabilities << 'NFC Tag Reading'
    when 'com.apple.developer.ClassKit-environment'
      capabilities << 'ClassKit'
    when 'com.apple.developer.networking.HotspotConfiguration'
      capabilities << 'Hotspot'
    when 'com.apple.developer.devicecheck.appattest-environment'
      capabilities << 'App Attest'
    when 'com.apple.developer.coremedia.hls.low-latency'
      capabilities << 'Low Latency HLS'
    when 'com.apple.developer.associated-domains.mdm-managed'
      capabilities << 'MDM Managed Associated Domains'
    # macOS Only
    when 'com.apple.developer.maps'
      capabilities << 'Maps'
    when 'com.apple.developer.system-extension.install'
      capabilities << 'System Extension'
    when 'com.apple.developer.networking.custom-protocol'
      capabilities << 'Custom Network Protocol'
    end
  end

  capabilities
end

#enterprise? ⇒ Boolea Also known as: inhouse?

Returns:

  • (Boolea) 


147
148
149
150
151
 
# File 'lib/app_info/mobile_provision.rb', line 147

def enterprise?
  return false if platform == Platform::MACOS # macOS no need adhoc

  !development? && !adhoc? && !appstore?
end

#entitlements ⇒ Array<String>?

Returns:

  • (Array<String>, nil) 


86
87
88
 
# File 'lib/app_info/mobile_provision.rb', line 86

def entitlements
  mobileprovision.try(:[], 'Entitlements')
end

#expired_date ⇒ String?

Returns:

  • (String, nil) 


81
82
83
 
# File 'lib/app_info/mobile_provision.rb', line 81

def expired_date
  mobileprovision.try(:[], 'ExpirationDate')
end

#manufacturer ⇒ Symbol

Returns AppInfo::Manufacturer.

Returns:



11
12
13
 
# File 'lib/app_info/mobile_provision.rb', line 11

def manufacturer
  Manufacturer::APPLE
end

#mobileprovision ⇒ CFPropertyList

Returns:

  • (CFPropertyList) 


242
243
244
245
246
247
248
249
250
251
 
# File 'lib/app_info/mobile_provision.rb', line 242

def mobileprovision
  return @mobileprovision = nil unless ::File.exist?(@file)

  data = ::File.read(@file)
  data = strip_plist_wrapper(data) unless bplist?(data)
  list = CFPropertyList::List.new(data: data).value
  @mobileprovision = CFPropertyList.native_types(list)
rescue CFFormatError
  @mobileprovision = nil
end

#name ⇒ String?

Returns:

  • (String, nil) 


28
29
30
 
# File 'lib/app_info/mobile_provision.rb', line 28

def name
  mobileprovision.try(:[], 'Name')
end

#platform ⇒ Symbol

Returns Platform.

Returns:



16
17
18
19
20
21
22
23
24
25
 
# File 'lib/app_info/mobile_provision.rb', line 16

def platform
  case platforms[0]
  when :macos
    Platform::MACOS
  when :ios
    Platform::IOS
  else
    raise NotImplementedError, "Unkonwn platform: #{platforms[0]}"
  end
end

#platforms ⇒ Array<Symbol>

Returns:

  • (Array<Symbol>) 


46
47
48
49
50
51
52
53
 
# File 'lib/app_info/mobile_provision.rb', line 46

def platforms
  return unless platforms = mobileprovision.try(:[], 'Platform')

  platforms.map do |v|
    v = 'macOS' if v == 'OSX'
    v.downcase.to_sym
  end
end

#profile_name ⇒ String?

Returns:

  • (String, nil) 


71
72
73
 
# File 'lib/app_info/mobile_provision.rb', line 71

def profile_name
  mobileprovision.try(:[], 'Name')
end

#respond_to_missing?(method_name, *args) ⇒ Boolean

Returns:

  • (Boolean) 


259
260
261
262
263
 
# File 'lib/app_info/mobile_provision.rb', line 259

def respond_to_missing?(method_name, *args)
  mobileprovision.key?(method_name.to_s.ai_camelcase) ||
    mobileprovision.respond_to?(method_name) ||
    super
end

#team_identifier ⇒ String?

Returns:

  • (String, nil) 


61
62
63
 
# File 'lib/app_info/mobile_provision.rb', line 61

def team_identifier
  mobileprovision.try(:[], 'TeamIdentifier')
end

#team_name ⇒ String?

Returns:

  • (String, nil) 


66
67
68
 
# File 'lib/app_info/mobile_provision.rb', line 66

def team_name
  mobileprovision.try(:[], 'TeamName')
end

#type ⇒ Symbol?

Returns:

  • (Symbol, nil) 


38
39
40
41
42
43
 
# File 'lib/app_info/mobile_provision.rb', line 38

def type
  return :development if development?
  return :adhoc if adhoc?
  return :appstore if appstore?
  return :enterprise if enterprise?
end