fastlane-plugin-sentry 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 207e11b8aa823f79ec731ad133d8541cc9b189cef78b8918588a0822952860e6
-  data.tar.gz: 5ce55cf1fe9ddc2f9ff242ef059160813f50fd6092f520273a3b820cc30ed537
+  metadata.gz: 8e94534abf55ab666c3114f03a3a1673accc6b8990603475eefdb9d74e865f8c
+  data.tar.gz: 3a4ab1661bd1bd22b49146edda0babb877571226c2e03cec8a627b7f2b6884d3
 SHA512:
-  metadata.gz: 768cab95c776d74ab4a13b6c149e726baee2ed73dd000669714c8c4a6d30341f3695714bbcdb9c792a7a46d8812a8e1b0ca6f16e0e4bfe6daba8b620d5255db6
-  data.tar.gz: 8c449a5fe7f95b34d1a7267648392b2f520b3b9b893a6fe187e0eb305990441cc09e8a17d8e32fbe7a531970956e25e605565a1b6e5ee3c24badb39e76c87438
+  metadata.gz: '09a2fcb0176e61b7a544babf58dfc60d8622b684d1ef45c3670da424910bbad7d39d2e340a495fab409ba37926ff9ccea9a61f6855f490ac30e65fa1f48cc005'
+  data.tar.gz: ca96667484f0a4501c79224966e6e48d12354006b8686119de42df26324c096b75fa6175626a3a02bb26383baeee03c4c43327e6a1bc68d71924c0b9748a2023

data/README.md

@@ -85,16 +85,23 @@ Further options:
 - **wait_for**: Optional. Wait for the server to fully process uploaded files, but at most for the given number of seconds. Errors can only be displayed if --wait or --wait-for is specified, but this will significantly slow down the upload process.
 - **il2cpp_mapping**: Optional. Compute il2cpp line mappings and upload them along with sources.
 
-### Uploading iOS Build Archives
+### Uploading Builds
 
-Upload iOS build archives (.xcarchive) to Sentry for improved symbolication and source context.
+Upload build files to Sentry for improved symbolication and source context. Supported formats:
+
+- **iOS**: `.xcarchive` (build archive) or `.ipa` (app bundle)
+- **Android**: `.apk` or `.aab` (App Bundle)
+
+Explicitly passed path parameters take precedence over SharedValues. For IPA uploads, use `dsym_path` to attach dSYM files for symbolication (IPAs typically don't embed symbols).
 
 ```ruby
 sentry_upload_build(
   auth_token: '...',
   org_slug: '...',
   project_slug: '...',
-  xcarchive_path: './build/MyApp.xcarchive', # Path to your .xcarchive file
+  # One of: xcarchive_path, ipa_path, apk_path, or aab_path (mutually exclusive)
+  xcarchive_path: './build/MyApp.xcarchive', # or ipa_path, apk_path, aab_path
+  dsym_path: './build/MyApp.app.dSYM.zip', # Optional. For IPA/xcarchive - path or array of dSYM paths. Defaults to DSYM_OUTPUT_PATH from lane context when not specified
   # Optional git context parameters (can also be set via environment variables)
   head_sha: 'abc123...', # The SHA of the head of the current branch (or SENTRY_HEAD_SHA)
   base_sha: 'def456...', # The SHA of the base branch (or SENTRY_BASE_SHA)
@@ -112,9 +119,9 @@ sentry_upload_build(
 )
 ```
 
-By default the `SharedValue::XCODEBUILD_ARCHIVE` sets the `xcarchive_path` parameter if set by a prior lane such as `build_app`.
+Path parameters default to SharedValues when not explicitly passed: `XCODEBUILD_ARCHIVE` (xcarchive), `IPA_OUTPUT_PATH` (ipa), `GRADLE_APK_OUTPUT_PATH` (apk), `GRADLE_AAB_OUTPUT_PATH` (aab). Explicit parameters always take precedence.
 
-This action is only supported on iOS platform.
+This action is supported on iOS and Android platforms.
 
 ### Creating & Finalizing Releases
 
@@ -239,6 +246,7 @@ When upgrading to the latest version of this plugin (which uses sentry-cli v3),
 #### Parameter Name Changes
 
 - **`sentry_debug_files_upload`**: The `ids` parameter has been renamed to `id` (singular). Update your Fastfiles:
+
   ```ruby
   # Before
   sentry_debug_files_upload(ids: 'abc123')
@@ -250,6 +258,7 @@ When upgrading to the latest version of this plugin (which uses sentry-cli v3),
 #### Authentication Changes
 
 - **All actions**: The `api_key` parameter has been removed in favor of `auth_token` with the release of [v2.0.0](https://github.com/getsentry/sentry-fastlane-plugin/releases/2.0.0-rc.1). All actions now require `auth_token` for authentication. Update your Fastfiles:
+
   ```ruby
   # Before v2.0.0-rc.1
   sentry_debug_files_upload(api_key: '...')

data/lib/fastlane/plugin/sentry/actions/sentry_upload_build.rb

@@ -4,25 +4,8 @@ module Fastlane
       def self.run(params)
         Helper::SentryConfig.parse_api_params(params)
 
-        # Determine which build file path to use (conflicting_options handles mutual exclusivity)
-        build_path = nil
-        build_type = nil
-
-        if params[:xcarchive_path]
-          build_path = params[:xcarchive_path]
-          build_type = :xcarchive
-        elsif params[:apk_path]
-          build_path = params[:apk_path]
-          build_type = :apk
-        elsif params[:aab_path]
-          build_path = params[:aab_path]
-          build_type = :aab
-        elsif params[:ipa_path]
-          build_path = params[:ipa_path]
-          build_type = :ipa
-        else
-          UI.user_error!("One of xcarchive_path, apk_path, aab_path, or ipa_path must be provided")
-        end
+        # 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)
 
@@ -74,6 +57,9 @@ module Fastlane
 
         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
 
       #####################################################
@@ -86,16 +72,17 @@ module Fastlane
 
       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). 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."
+          "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
 
       def self.available_options
         Helper::SentryConfig.common_api_config_items + [
           FastlaneCore::ConfigItem.new(key: :xcarchive_path,
-                                       description: "Path to your iOS build archive (.xcarchive). Mutually exclusive with apk_path, aab_path, and ipa_path",
-                                       default_value: Actions.lane_context[SharedValues::XCODEBUILD_ARCHIVE],
+                                       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|
@@ -105,8 +92,7 @@ module Fastlane
                                          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). Mutually exclusive with xcarchive_path, aab_path, and ipa_path",
-                                       default_value: Actions.lane_context[SharedValues::GRADLE_APK_OUTPUT_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|
@@ -116,8 +102,7 @@ module Fastlane
                                          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). Mutually exclusive with xcarchive_path, apk_path, and ipa_path",
-                                       default_value: Actions.lane_context[SharedValues::GRADLE_AAB_OUTPUT_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|
@@ -127,8 +112,7 @@ module Fastlane
                                          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). Mutually exclusive with xcarchive_path, apk_path, and aab_path",
-                                       default_value: Actions.lane_context[SharedValues::IPA_OUTPUT_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|
@@ -137,6 +121,11 @@ module Fastlane
                                          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),
           FastlaneCore::ConfigItem.new(key: :head_sha,
                                        env_name: "SENTRY_HEAD_SHA",
                                        description: "The SHA of the head of the current branch",
@@ -217,6 +206,62 @@ module Fastlane
       def self.is_supported?(platform)
         [:ios, :android].include?(platform)
       end
+
+      #####################################################
+      # @!group Private helpers
+      #####################################################
+
+      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
+
+      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
     end
   end
 end

data/lib/fastlane/plugin/sentry/version.rb

@@ -1,5 +1,5 @@
 module Fastlane
   module Sentry
-    VERSION = "2.1.0"
+    VERSION = "2.2.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fastlane-plugin-sentry
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.2.0
 platform: ruby
 authors:
 - Sentry
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-10 00:00:00.000000000 Z
+date: 2026-03-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: os