Class: Gym::Options

Inherits:
Object
  • Object
show all
Defined in:
gym/lib/gym/options.rb

Class Method Summary collapse

Class Method Details

.available_optionsObject



8
9
10
11
12
# File 'gym/lib/gym/options.rb', line 8

def self.available_options
  return @options if @options

  @options = plain_options
end

.plain_optionsObject



14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
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
114
115
116
117
118
119
120
121
122
123
124
125
126
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
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
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
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
321
322
323
324
325
# File 'gym/lib/gym/options.rb', line 14

def self.plain_options
  [
    FastlaneCore::ConfigItem.new(key: :workspace,
                                 short_option: "-w",
                                 env_name: "GYM_WORKSPACE",
                                 optional: true,
                                 description: "Path to the workspace file",
                                 verify_block: proc do |value|
                                   v = File.expand_path(value.to_s)
                                   UI.user_error!("Workspace file not found at path '#{v}'") unless File.exist?(v)
                                   UI.user_error!("Workspace file invalid") unless File.directory?(v)
                                   UI.user_error!("Workspace file is not a workspace, must end with .xcworkspace") unless v.include?(".xcworkspace")
                                 end,
                                 conflicting_options: [:project],
                                 conflict_block: proc do |value|
                                   UI.user_error!("You can only pass either a 'workspace' or a '#{value.key}', not both")
                                 end),
    FastlaneCore::ConfigItem.new(key: :project,
                                 short_option: "-p",
                                 optional: true,
                                 env_name: "GYM_PROJECT",
                                 description: "Path to the project file",
                                 verify_block: proc do |value|
                                   v = File.expand_path(value.to_s)
                                   UI.user_error!("Project file not found at path '#{v}'") unless File.exist?(v)
                                   UI.user_error!("Project file invalid") unless File.directory?(v)
                                   UI.user_error!("Project file is not a project file, must end with .xcodeproj") unless v.include?(".xcodeproj")
                                 end,
                                 conflicting_options: [:workspace],
                                 conflict_block: proc do |value|
                                   UI.user_error!("You can only pass either a 'project' or a '#{value.key}', not both")
                                 end),
    FastlaneCore::ConfigItem.new(key: :scheme,
                                 short_option: "-s",
                                 optional: true,
                                 env_name: "GYM_SCHEME",
                                 description: "The project's scheme. Make sure it's marked as `Shared`"),
    FastlaneCore::ConfigItem.new(key: :clean,
                                 short_option: "-c",
                                 env_name: "GYM_CLEAN",
                                 description: "Should the project be cleaned before building it?",
                                 type: Boolean,
                                 default_value: false),
    FastlaneCore::ConfigItem.new(key: :output_directory,
                                 short_option: "-o",
                                 env_name: "GYM_OUTPUT_DIRECTORY",
                                 description: "The directory in which the ipa file should be stored in",
                                 default_value: "."),
    FastlaneCore::ConfigItem.new(key: :output_name,
                                 short_option: "-n",
                                 env_name: "GYM_OUTPUT_NAME",
                                 description: "The name of the resulting ipa file",
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :configuration,
                                 short_option: "-q",
                                 env_name: "GYM_CONFIGURATION",
                                 description: "The configuration to use when building the app. Defaults to 'Release'",
                                 default_value_dynamic: true,
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :silent,
                                 short_option: "-a",
                                 env_name: "GYM_SILENT",
                                 description: "Hide all information that's not necessary while building",
                                 default_value: false,
                                 type: Boolean),
    FastlaneCore::ConfigItem.new(key: :codesigning_identity,
                                 short_option: "-i",
                                 env_name: "GYM_CODE_SIGNING_IDENTITY",
                                 description: "The name of the code signing identity to use. It has to match the name exactly. e.g. 'iPhone Distribution: SunApps GmbH'",
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :skip_package_ipa,
                                 env_name: "GYM_SKIP_PACKAGE_IPA",
                                 description: "Should we skip packaging the ipa?",
                                 type: Boolean,
                                 default_value: false),
    FastlaneCore::ConfigItem.new(key: :skip_package_pkg,
                                 env_name: "GYM_SKIP_PACKAGE_PKG",
                                 description: "Should we skip packaging the pkg?",
                                 type: Boolean,
                                 default_value: false),
    FastlaneCore::ConfigItem.new(key: :include_symbols,
                                 short_option: "-m",
                                 env_name: "GYM_INCLUDE_SYMBOLS",
                                 description: "Should the ipa file include symbols?",
                                 type: Boolean,
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :include_bitcode,
                                 short_option: "-z",
                                 env_name: "GYM_INCLUDE_BITCODE",
                                 description: "Should the ipa file include bitcode?",
                                 type: Boolean,
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :export_method,
                                 short_option: "-j",
                                 env_name: "GYM_EXPORT_METHOD",
                                 description: "Method used to export the archive. Valid values are: app-store, validation, ad-hoc, package, enterprise, development, developer-id and mac-application",
                                 type: String,
                                 optional: true,
                                 verify_block: proc do |value|
                                   av = %w(app-store validation ad-hoc package enterprise development developer-id mac-application)
                                   UI.user_error!("Unsupported export_method '#{value}', must be: #{av}") unless av.include?(value)
                                 end),
    FastlaneCore::ConfigItem.new(key: :export_options,
                                 env_name: "GYM_EXPORT_OPTIONS",
                                 description: "Path to an export options plist or a hash with export options. Use 'xcodebuild -help' to print the full set of available options",
                                 optional: true,
                                 type: Hash,
                                 skip_type_validation: true,
                                 conflict_block: proc do |value|
                                   UI.user_error!("'#{value.key}' must be false to use 'export_options'")
                                 end),
    FastlaneCore::ConfigItem.new(key: :export_xcargs,
                                 env_name: "GYM_EXPORT_XCARGS",
                                 description: "Pass additional arguments to xcodebuild for the package phase. Be sure to quote the setting names and values e.g. OTHER_LDFLAGS=\"-ObjC -lstdc++\"",
                                 optional: true,
                                 conflict_block: proc do |value|
                                   UI.user_error!("'#{value.key}' must be false to use 'export_xcargs'")
                                 end,
                                 type: :shell_string),
    FastlaneCore::ConfigItem.new(key: :skip_build_archive,
                                 env_name: "GYM_SKIP_BUILD_ARCHIVE",
                                 description: "Export ipa from previously built xcarchive. Uses archive_path as source",
                                 type: Boolean,
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :skip_archive,
                                 env_name: "GYM_SKIP_ARCHIVE",
                                 description: "After building, don't archive, effectively not including -archivePath param",
                                 type: Boolean,
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :skip_codesigning,
                                 env_name: "GYM_SKIP_CODESIGNING",
                                 description: "Build without codesigning",
                                 type: Boolean,
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :catalyst_platform,
                                 env_name: "GYM_CATALYST_PLATFORM",
                                 description: "Platform to build when using a Catalyst enabled app. Valid values are: ios, macos",
                                 type: String,
                                 optional: true,
                                 verify_block: proc do |value|
                                   av = %w(ios macos)
                                   UI.user_error!("Unsupported catalyst_platform '#{value}', must be: #{av}") unless av.include?(value)
                                 end),
    FastlaneCore::ConfigItem.new(key: :installer_cert_name,
                                 env_name: "GYM_INSTALLER_CERT_NAME",
                                 description: "Full name of 3rd Party Mac Developer Installer or Developer ID Installer certificate. Example: `3rd Party Mac Developer Installer: Your Company (ABC1234XWYZ)`",
                                 type: String,
                                 optional: true),
    # Very optional
    FastlaneCore::ConfigItem.new(key: :build_path,
                                 env_name: "GYM_BUILD_PATH",
                                 description: "The directory in which the archive should be stored in",
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :archive_path,
                                 short_option: "-b",
                                 env_name: "GYM_ARCHIVE_PATH",
                                 description: "The path to the created archive",
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :derived_data_path,
                                 short_option: "-f",
                                 env_name: "GYM_DERIVED_DATA_PATH",
                                 description: "The directory where built products and other derived data will go",
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :result_bundle,
                                 short_option: "-u",
                                 env_name: "GYM_RESULT_BUNDLE",
                                 type: Boolean,
                                 description: "Should an Xcode result bundle be generated in the output directory",
                                 default_value: false,
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :result_bundle_path,
                                 env_name: "GYM_RESULT_BUNDLE_PATH",
                                 description: "Path to the result bundle directory to create. Ignored if `result_bundle` if false",
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :buildlog_path,
                                 short_option: "-l",
                                 env_name: "GYM_BUILDLOG_PATH",
                                 description: "The directory where to store the build log",
                                 default_value: "#{FastlaneCore::Helper.buildlog_path}/gym",
                                 default_value_dynamic: true),
    FastlaneCore::ConfigItem.new(key: :sdk,
                                 short_option: "-k",
                                 env_name: "GYM_SDK",
                                 description: "The SDK that should be used for building the application",
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :toolchain,
                                 env_name: "GYM_TOOLCHAIN",
                                 description: "The toolchain that should be used for building the application (e.g. com.apple.dt.toolchain.Swift_2_3, org.swift.30p620160816a)",
                                 optional: true,
                                 type: String),
    FastlaneCore::ConfigItem.new(key: :destination,
                                 short_option: "-d",
                                 env_name: "GYM_DESTINATION",
                                 description: "Use a custom destination for building the app",
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :export_team_id,
                                 short_option: "-g",
                                 env_name: "GYM_EXPORT_TEAM_ID",
                                 description: "Optional: Sometimes you need to specify a team id when exporting the ipa file",
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :xcargs,
                                 short_option: "-x",
                                 env_name: "GYM_XCARGS",
                                 description: "Pass additional arguments to xcodebuild for the build phase. Be sure to quote the setting names and values e.g. OTHER_LDFLAGS=\"-ObjC -lstdc++\"",
                                 optional: true,
                                 type: :shell_string),
    FastlaneCore::ConfigItem.new(key: :xcconfig,
                                 short_option: "-y",
                                 env_name: "GYM_XCCONFIG",
                                 description: "Use an extra XCCONFIG file to build your app",
                                 optional: true,
                                 verify_block: proc do |value|
                                   UI.user_error!("File not found at path '#{File.expand_path(value)}'") unless File.exist?(value)
                                 end),
    FastlaneCore::ConfigItem.new(key: :suppress_xcode_output,
                                 short_option: "-r",
                                 env_name: "SUPPRESS_OUTPUT",
                                 description: "Suppress the output of xcodebuild to stdout. Output is still saved in buildlog_path",
                                 optional: true,
                                 type: Boolean),

    FastlaneCore::ConfigItem.new(key: :xcodebuild_formatter,
                                 env_names: ["GYM_XCODEBUILD_FORMATTER", "FASTLANE_XCODEBUILD_FORMATTER"],
                                 description: "xcodebuild formatter to use (ex: 'xcbeautify', 'xcbeautify --quieter', 'xcpretty', 'xcpretty -test'). Use empty string (ex: '') to disable any formatter (More information: https://docs.fastlane.tools/best-practices/xcodebuild-formatters/)",
                                 type: String,
                                 default_value: Fastlane::Helper::XcodebuildFormatterHelper.xcbeautify_installed? ? 'xcbeautify' : 'xcpretty',
                                 default_value_dynamic: true),

    FastlaneCore::ConfigItem.new(key: :build_timing_summary,
                                 env_name: "GYM_BUILD_TIMING_SUMMARY",
                                 description: "Create a build timing summary",
                                 type: Boolean,
                                 default_value: false,
                                 optional: true),

    # xcpretty
    FastlaneCore::ConfigItem.new(key: :disable_xcpretty,
                                 env_name: "DISABLE_XCPRETTY",
                                 deprecated: "Use `xcodebuild_formatter: ''` instead",
                                 description: "Disable xcpretty formatting of build output",
                                 optional: true,
                                 type: Boolean),
    FastlaneCore::ConfigItem.new(key: :xcpretty_test_format,
                                 env_name: "XCPRETTY_TEST_FORMAT",
                                 description: "Use the test (RSpec style) format for build output",
                                 optional: true,
                                 type: Boolean),
    FastlaneCore::ConfigItem.new(key: :xcpretty_formatter,
                                 env_name: "XCPRETTY_FORMATTER",
                                 description: "A custom xcpretty formatter to use",
                                 optional: true,
                                 verify_block: proc do |value|
                                   UI.user_error!("Formatter file not found at path '#{File.expand_path(value)}'") unless File.exist?(value)
                                 end),
    FastlaneCore::ConfigItem.new(key: :xcpretty_report_junit,
                                 env_name: "XCPRETTY_REPORT_JUNIT",
                                 description: "Have xcpretty create a JUnit-style XML report at the provided path",
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :xcpretty_report_html,
                                 env_name: "XCPRETTY_REPORT_HTML",
                                 description: "Have xcpretty create a simple HTML report at the provided path",
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :xcpretty_report_json,
                                 env_name: "XCPRETTY_REPORT_JSON",
                                 description: "Have xcpretty create a JSON compilation database at the provided path",
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :xcpretty_utf,
                                 env_name: "XCPRETTY_UTF",
                                 description: "Have xcpretty use unicode encoding when reporting builds",
                                 optional: true,
                                 type: Boolean),

    FastlaneCore::ConfigItem.new(key: :analyze_build_time,
                                 env_name: "GYM_ANALYZE_BUILD_TIME",
                                 description: "Analyze the project build time and store the output in 'culprits.txt' file",
                                 optional: true,
                                 type: Boolean),
    FastlaneCore::ConfigItem.new(key: :skip_profile_detection,
                                 env_name: "GYM_SKIP_PROFILE_DETECTION",
                                 description: "Do not try to build a profile mapping from the xcodeproj. Match or a manually provided mapping should be used",
                                 optional: true,
                                 type: Boolean,
                                 default_value: false),
    FastlaneCore::ConfigItem.new(key: :xcodebuild_command,
                                 env_name: "GYM_XCODE_BUILD_COMMAND",
                                 description: "Allows for override of the default `xcodebuild` command",
                                 type: String,
                                 optional: true,
                                 default_value: "xcodebuild"),
    FastlaneCore::ConfigItem.new(key: :cloned_source_packages_path,
                                 env_name: "GYM_CLONED_SOURCE_PACKAGES_PATH",
                                 description: "Sets a custom path for Swift Package Manager dependencies",
                                 type: String,
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :skip_package_dependencies_resolution,
                                 env_name: "GYM_SKIP_PACKAGE_DEPENDENCIES_RESOLUTION",
                                 description: "Skips resolution of Swift Package Manager dependencies",
                                 type: Boolean,
                                 default_value: false),
    FastlaneCore::ConfigItem.new(key: :disable_package_automatic_updates,
                                 env_name: "GYM_DISABLE_PACKAGE_AUTOMATIC_UPDATES",
                                 description: "Prevents packages from automatically being resolved to versions other than those recorded in the `Package.resolved` file",
                                 type: Boolean,
                                 default_value: false),
    FastlaneCore::ConfigItem.new(key: :use_system_scm,
                                 env_name: "GYM_USE_SYSTEM_SCM",
                                 description: "Lets xcodebuild use system's scm configuration",
                                 optional: true,
                                 type: Boolean,
                                 default_value: false)
  ]
end