Class: Fastlane::Actions::SentryUploadBuildAction

Inherits:
Action
  • Object
show all
Defined in:
lib/fastlane/plugin/sentry/actions/sentry_upload_build.rb

Documentation collapse

Private helpers collapse

Class Method Summary collapse

Class Method Details

.authors ⇒ Object 



143
144
145
 
# File 'lib/fastlane/plugin/sentry/actions/sentry_upload_build.rb', line 143

def self.authors
  ["runningcode"]
end

.available_options ⇒ Object 



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
 
# File 'lib/fastlane/plugin/sentry/actions/sentry_upload_build.rb', line 72

def self.available_options
  Helper::SentryConfig.common_api_config_items + [
    FastlaneCore::ConfigItem.new(key: :xcarchive_path,
                                 description: "Path to your iOS build archive (.xcarchive). Defaults to XCODEBUILD_ARCHIVE from lane context. Mutually exclusive with apk_path, aab_path, and ipa_path",
                                 optional: true,
                                 conflicting_options: [:apk_path, :aab_path, :ipa_path],
                                 verify_block: proc do |value|
                                   next if value.nil? || value.to_s.empty?

                                   UI.user_error!("Could not find xcarchive at path '#{value}'") unless File.exist?(value)
                                   UI.user_error!("Path '#{value}' is not an xcarchive") unless File.extname(value) == '.xcarchive'
                                 end),
    FastlaneCore::ConfigItem.new(key: :apk_path,
                                 description: "Path to your Android APK file (.apk). Defaults to GRADLE_APK_OUTPUT_PATH from lane context. Mutually exclusive with xcarchive_path, aab_path, and ipa_path",
                                 optional: true,
                                 conflicting_options: [:xcarchive_path, :aab_path, :ipa_path],
                                 verify_block: proc do |value|
                                   next if value.nil? || value.to_s.empty?

                                   UI.user_error!("Could not find APK at path '#{value}'") unless File.exist?(value)
                                   UI.user_error!("Path '#{value}' is not an APK") unless File.extname(value).casecmp('.apk').zero?
                                 end),
    FastlaneCore::ConfigItem.new(key: :aab_path,
                                 description: "Path to your Android App Bundle (.aab). Defaults to GRADLE_AAB_OUTPUT_PATH from lane context. Mutually exclusive with xcarchive_path, apk_path, and ipa_path",
                                 optional: true,
                                 conflicting_options: [:xcarchive_path, :apk_path, :ipa_path],
                                 verify_block: proc do |value|
                                   next if value.nil? || value.to_s.empty?

                                   UI.user_error!("Could not find AAB at path '#{value}'") unless File.exist?(value)
                                   UI.user_error!("Path '#{value}' is not an AAB") unless File.extname(value).casecmp('.aab').zero?
                                 end),
    FastlaneCore::ConfigItem.new(key: :ipa_path,
                                 description: "Path to your iOS app bundle (.ipa). Defaults to IPA_OUTPUT_PATH from lane context. For symbolication, use dsym_path or call sentry_debug_files_upload separately. Mutually exclusive with xcarchive_path, apk_path, and aab_path",
                                 optional: true,
                                 conflicting_options: [:xcarchive_path, :apk_path, :aab_path],
                                 verify_block: proc do |value|
                                   next if value.nil? || value.to_s.empty?

                                   UI.user_error!("Could not find IPA at path '#{value}'") unless File.exist?(value)
                                   UI.user_error!("Path '#{value}' is not an IPA") unless File.extname(value).casecmp('.ipa').zero?
                                 end),
    FastlaneCore::ConfigItem.new(key: :dsym_path,
                                 description: "Path to dSYM file(s) for symbolication. Use when uploading IPA (IPAs typically don't embed dSYMs). Can be a path or array of paths. Defaults to DSYM_OUTPUT_PATH from lane context for iOS builds when not specified",
                                 optional: true,
                                 type: Array,
                                 skip_type_validation: true)
  ] + Helper::SentryConfig.common_vcs_config_items + [
    FastlaneCore::ConfigItem.new(key: :build_configuration,
                                 env_name: "SENTRY_BUILD_CONFIGURATION",
                                 description: "The build configuration (e.g., 'Release', 'Debug')",
                                 optional: true,
                                 is_string: true),
    FastlaneCore::ConfigItem.new(key: :install_groups,
                                 env_name: "SENTRY_INSTALL_GROUPS",
                                 description: "One or more install groups that control update visibility between builds. \
                                 Builds with at least one matching install group will be shown updates for each other. \
                                 Specify multiple groups as an array (e.g., ['group1', 'group2']) or a single group as a string",
                                 type: Array,
                                 optional: true),
    FastlaneCore::ConfigItem.new(key: :release_notes,
                                 description: "The release notes to use for the upload",
                                 optional: true,
                                 is_string: true)
  ]
end

.description ⇒ Object 



59
60
61
 
# File 'lib/fastlane/plugin/sentry/actions/sentry_upload_build.rb', line 59

def self.description
  "Upload build files (iOS .xcarchive/.ipa or Android .apk/.aab) to Sentry with optional git context"
end

.details ⇒ Object 



63
64
65
66
67
68
69
70
 
# File 'lib/fastlane/plugin/sentry/actions/sentry_upload_build.rb', line 63

def self.details
  "This action allows you to upload build files to Sentry. Supported formats include iOS build archives (.xcarchive), " \
    "iOS app bundles (.ipa), Android APK files (.apk), and Android App Bundles (.aab). IPA files typically don't " \
    "embed dSYMs—use the dsym_path parameter to upload symbols for proper symbolication, or call sentry_debug_files_upload " \
    "separately. The action supports optional git-related parameters for enhanced context including commit SHAs, " \
    "branch names, repository information, and pull request details. Install groups can be specified to control update " \
    "visibility between builds."
end

.is_supported?(platform) ⇒ Boolean

Returns:

  • (Boolean) 


147
148
149
 
# File 'lib/fastlane/plugin/sentry/actions/sentry_upload_build.rb', line 147

def self.is_supported?(platform)
  [:ios, :android].include?(platform)
end

.resolve_build_path(params) ⇒ Object 



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
 
# File 'lib/fastlane/plugin/sentry/actions/sentry_upload_build.rb', line 155

def self.resolve_build_path(params)
  # Explicit params take precedence over SharedValues defaults
  if params[:ipa_path] && !params[:ipa_path].to_s.empty?
    [params[:ipa_path], :ipa]
  elsif params[:xcarchive_path] && !params[:xcarchive_path].to_s.empty?
    [params[:xcarchive_path], :xcarchive]
  elsif params[:apk_path] && !params[:apk_path].to_s.empty?
    [params[:apk_path], :apk]
  elsif params[:aab_path] && !params[:aab_path].to_s.empty?
    [params[:aab_path], :aab]
  else
    # No explicit path - use SharedValues defaults
    path = Actions.lane_context[SharedValues::XCODEBUILD_ARCHIVE]
    return [path, :xcarchive] if path && !path.to_s.empty?

    path = Actions.lane_context[SharedValues::GRADLE_APK_OUTPUT_PATH]
    return [path, :apk] if path && !path.to_s.empty?

    path = Actions.lane_context[SharedValues::GRADLE_AAB_OUTPUT_PATH]
    return [path, :aab] if path && !path.to_s.empty?

    path = Actions.lane_context[SharedValues::IPA_OUTPUT_PATH]
    return [path, :ipa] if path && !path.to_s.empty?

    UI.user_error!("One of xcarchive_path, apk_path, aab_path, or ipa_path must be provided")
  end
end

.return_value ⇒ Object 



139
140
141
 
# File 'lib/fastlane/plugin/sentry/actions/sentry_upload_build.rb', line 139

def self.return_value
  nil
end

.run(params) ⇒ Object 



4
5
6
7
8
9
10
11
12
13
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
 
# File 'lib/fastlane/plugin/sentry/actions/sentry_upload_build.rb', line 4

def self.run(params)
  Helper::SentryConfig.parse_api_params(params)

  # Resolve build path: explicit params take precedence over SharedValues defaults
  build_path, build_type = resolve_build_path(params)

  UI.user_error!("Could not find build file at path '#{build_path}'") unless File.exist?(build_path)

  case build_type
  when :xcarchive
    UI.user_error!("Path '#{build_path}' is not an xcarchive") unless File.extname(build_path) == '.xcarchive'
  when :apk
    UI.user_error!("Path '#{build_path}' is not an APK") unless File.extname(build_path).casecmp('.apk').zero?
  when :aab
    UI.user_error!("Path '#{build_path}' is not an AAB") unless File.extname(build_path).casecmp('.aab').zero?
  when :ipa
    UI.user_error!("Path '#{build_path}' is not an IPA") unless File.extname(build_path).casecmp('.ipa').zero?
  end

  command = [
    "build",
    "upload",
    File.absolute_path(build_path)
  ]

  Helper::SentryConfig.build_vcs_command(command, params)

  command << "--build-configuration" << params[:build_configuration] if params[:build_configuration]
  command << "--release-notes" << params[:release_notes] if params[:release_notes]

  unless params[:install_groups].nil?
    unless params[:install_groups].kind_of?(Enumerable)
      params[:install_groups] = [params[:install_groups]]
    end
    params[:install_groups].reject! do |e|
      e.to_s.strip.empty?
    rescue StandardError
      true
    end
    params[:install_groups].each do |group|
      command.push('--install-group').push(group)
    end
  end

  Helper::SentryHelper.call_sentry_cli(params, command)
  UI.success("Successfully uploaded build file: #{build_path}")

  # Upload dSYMs for iOS builds when dsym_path is provided or DSYM_OUTPUT_PATH is set
  upload_dsym_if_requested(params, build_type)
end

.upload_dsym_if_requested(params, build_type) ⇒ Object 



183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
 
# File 'lib/fastlane/plugin/sentry/actions/sentry_upload_build.rb', line 183

def self.upload_dsym_if_requested(params, build_type)
  dsym_paths = Array(params[:dsym_path]).reject { |p| p.nil? || p.to_s.empty? }
  # For iOS builds, use DSYM_OUTPUT_PATH from lane context when dsym_path not specified
  if dsym_paths.empty? && [:ipa, :xcarchive].include?(build_type)
    dsym_from_context = Actions.lane_context[SharedValues::DSYM_OUTPUT_PATH]
    dsym_paths = [dsym_from_context] if dsym_from_context && !dsym_from_context.to_s.empty?
  end
  return if dsym_paths.empty?

  uploaded_count = 0
  dsym_paths.each do |path|
    next unless File.exist?(path)

    command = ["debug-files", "upload", File.absolute_path(path), "--type", "dsym"]
    Helper::SentryHelper.call_sentry_cli(params, command)
    uploaded_count += 1
  end
  if uploaded_count > 0
    UI.success("Successfully uploaded dSYM files")
  elsif dsym_paths.any?
    UI.verbose("No dSYM files were uploaded: none of the specified paths exist (#{dsym_paths.join(', ')})")
  end
end