fastlane-plugin-emerge 0.10.6 → 0.10.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b3fdf2609746465c109005ada64d6fb3934e0930bd900e448b60551fcffbc4b
-  data.tar.gz: 55c71ed30681633f8a7e2736302f8b3c209c5f0a11387dcb96a967376507b2bd
+  metadata.gz: e400de6b005160e9d28d0034375e423dbde6dcecb60c75b11d202fb01d6eb838
+  data.tar.gz: 3b45cf16727a516fe70c8712fe1c65735cf7fa6c80cd25241b772c85d8950ef8
 SHA512:
-  metadata.gz: f101d6387c86c67b746a89ebc2cdeeb71777d7a8942031bc49f968423668131fa8a9f4a4b5cedcdd00fb55c9d1e7323a810f6f0fae739e00cd4ac3af05f5e972
-  data.tar.gz: d8a28c08d15a438b24e9c15a153897cec5749fc2bfab57e8966fe232ba804bb560f19c13743402e335f9e07b4f83a4b75aec06ebff7fda1825144dc55fd16e84
+  metadata.gz: c88f72658721ce2e50a0deb36ef744fc205f451da469909ac29d957abecad0f558c1f695217fd3841019d94df0f638407b268abca79c28fcc119eb99099ecaf0
+  data.tar.gz: 44911ca631006b7ee5cd88b29b0fd4c09a70cd1357588dba712fa6f3013bfaf257bdc709d8360add5902359c8e6dfe45557b1998b8598b6fceb2a4c4c1b2912d

data/README.md

@@ -16,7 +16,9 @@ fastlane add_plugin emerge
 
 ## Usage
 
-To get started, first obtain an [API token](https://docs.emergetools.com/docs/uploading-basics#obtain-an-api-key) for your organization. The API Token is used to authenticate with the Emerge API in each call. Our actions will automatically pick up the API key if configured as an `EMERGE_API_TOKEN` environment variable.
+### API Token
+
+First obtain an [API token](https://docs.emergetools.com/docs/uploading-basics#obtain-an-api-key) for your organization. The API Token is used to authenticate with the Emerge API in each call. Our actions will automatically pick up the API key if configured as an `EMERGE_API_TOKEN` environment variable.
 
 ### Size Analysis
 
@@ -37,12 +39,22 @@ For a full list of available parameters run `fastlane action emerge`.
 
 ### Snapshot Testing
 
+Emerge Snapshot Testing works by parsing Xcode Previews _from the app binary_. This means the upload to Emerge's service needs to include Previews as part of the app code. There are a couple ways to do this:
+
+#### Re-use a unit test build with the `emerge()` action
+
+If you're already running unit tests with fastlane, simply call the `emerge()` action after running unit tests to automatically upload the unit test build to Emerge. The action will detect the build generated for unit tests, or the `file_path` param can be explicitly set. Generally this build is a Debug build and should have Previews code included.
+
+#### Generate a new build with the `emerge_snapshot()` action
+
+This will build the app from scratch with recommended configurations to prevent Previews from being removed/stripped, and then upload the built app to Emerge.
+
 ```ruby
 platform :ios do
   lane :snapshot_testing do
-    # Call our `emerge_snapshot()` action with the respective scheme for
+    # Call the `emerge_snapshot()` action with the respective scheme for
     # us to build. We will generate a build with the recommended settings
-    # and upload to our API.
+    # and upload to Emerge's API.
     emerge_snapshot(scheme: 'Hacker News')
   end
 end

data/lib/fastlane/plugin/emerge/actions/emerge_action.rb

@@ -37,8 +37,10 @@ module Fastlane
         order_file_version = params[:order_file_version]
         config_path = params[:config_path]
 
-        if file_path.nil? || !File.exist?(file_path)
-          UI.error("Invalid input file")
+        if file_path.nil?
+          UI.error("No input file was provided, make sure it is set in the action")
+        elsif !File.exist?(file_path)
+          UI.error("No file exists at #{file_path}")
           return false
         else
           UI.message("Using file_path: #{file_path}")
@@ -97,7 +99,7 @@ module Fastlane
         elsif (extension == '.zip' || extension == '.ipa') && params[:linkmaps] && params[:linkmaps].length > 0
           UI.error("Provided #{extension == '.zip' ? 'zipped archive' : 'ipa'} and linkmaps, linkmaps will not be added to upload.")
         elsif extension != '.zip' && extension != '.ipa'
-          UI.error("Invalid input file")
+          UI.error("Invalid input file extension: #{extension}")
           return false
         end
 
@@ -112,7 +114,8 @@ module Fastlane
           orderFileVersion: order_file_version,
           appIdSuffix: params[:app_id_suffix],
           releaseNotes: params[:release_notes],
-          tag: tag || "default"
+          tag: tag || "default",
+          buildDir: params[:build_dir]
         }
         upload_id = Helper::EmergeHelper.perform_upload(api_token, params, file_path)
         UI.success("🎉 Your app is processing, you can find the results at https://emergetools.com/build/#{upload_id}")
@@ -215,6 +218,10 @@ module Fastlane
           FastlaneCore::ConfigItem.new(key: :release_notes,
                                        description: "A markdown string with release notes for the upload",
                                        optional: true,
+                                       type: String),
+          FastlaneCore::ConfigItem.new(key: :build_dir,
+                                       description: "The directory used to build the app",
+                                       optional: true,
                                        type: String)
         ]
       end

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

@@ -1,5 +1,5 @@
 module Fastlane
   module Emerge
-    VERSION = "0.10.6"
+    VERSION = "0.10.8"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fastlane-plugin-emerge
 version: !ruby/object:Gem::Version
-  version: 0.10.6
+  version: 0.10.8
 platform: ruby
 authors:
 - Emerge Tools, Inc
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-17 00:00:00.000000000 Z
+date: 2025-05-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -186,7 +186,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: Fastlane plugin for Emerge