fastlane 2.212.1 → 2.219.0

data/deliver/lib/deliver/upload_metadata.rb

@@ -89,7 +89,8 @@ module Deliver
       enabled_languages = detect_languages(options)
 
       app_store_version_localizations = verify_available_version_languages!(options, app, enabled_languages) unless options[:edit_live]
-      app_info_localizations = verify_available_info_languages!(options, app, enabled_languages) unless options[:edit_live]
+      app_info = fetch_edit_app_info(app)
+      app_info_localizations = verify_available_info_languages!(options, app, app_info, enabled_languages) unless options[:edit_live] || !updating_localized_app_info?(options, app, app_info)
 
       if options[:edit_live]
         # not all values are editable when using live_version
@@ -211,18 +212,19 @@ module Deliver
       store_version_worker.start
 
       # Update app info localizations
-      app_info_worker = FastlaneCore::QueueWorker.new do |app_info_localization|
-        attributes = localized_info_attributes_by_locale[app_info_localization.locale]
-        if attributes
-          UI.message("Uploading metadata to App Store Connect for localized info '#{app_info_localization.locale}'")
-          app_info_localization.update(attributes: attributes)
+      if app_info_localizations
+        app_info_worker = FastlaneCore::QueueWorker.new do |app_info_localization|
+          attributes = localized_info_attributes_by_locale[app_info_localization.locale]
+          if attributes
+            UI.message("Uploading metadata to App Store Connect for localized info '#{app_info_localization.locale}'")
+            app_info_localization.update(attributes: attributes)
+          end
         end
+        app_info_worker.batch_enqueue(app_info_localizations)
+        app_info_worker.start
       end
-      app_info_worker.batch_enqueue(app_info_localizations)
-      app_info_worker.start
 
       # Update categories
-      app_info = fetch_edit_app_info(app)
       if app_info
         category_id_map = {}
 
@@ -235,7 +237,7 @@ module Deliver
 
         mapped_values = {}
 
-        # Only update primary and secondar category if explicitly set
+        # Only update primary and secondary category if explicitly set
         unless primary_category.empty?
           mapped = Spaceship::ConnectAPI::AppCategory.map_category_from_itc(
             primary_category
@@ -437,6 +439,12 @@ module Deliver
       end
     end
 
+    def fetch_live_app_info(app, wait_time: 10)
+      retry_if_nil("Cannot find live app info", wait_time: wait_time) do
+        app.fetch_live_app_info
+      end
+    end
+
     def retry_if_nil(message, tries: 5, wait_time: 10)
       loop do
         tries -= 1
@@ -451,12 +459,49 @@ module Deliver
       end
     end
 
-    # Finding languages to enable
-    def verify_available_info_languages!(options, app, languages)
-      app_info = fetch_edit_app_info(app)
+    # Checking if the metadata to update includes localised App Info
+    def updating_localized_app_info?(options, app, app_info)
+      app_info ||= fetch_live_app_info(app)
+      unless app_info
+        UI.important("Can't find edit or live App info. Skipping upload.")
+        return false
+      end
+      localizations = app_info.get_app_info_localizations
+
+      LOCALISED_APP_VALUES.each do |key, localized_key|
+        current = options[key]
+        next unless current
+
+        unless current.kind_of?(Hash)
+          UI.error("Error with provided '#{key}'. Must be a hash, the key being the language.")
+          next
+        end
+
+        current.each do |language, value|
+          strip_value = value.to_s.strip
+          next if strip_value.empty?
+
+          app_info_locale = localizations.find { |l| l.locale == language }
+          next if app_info_locale.nil?
 
+          begin
+            current_value = app_info_locale.public_send(localized_key.to_sym)
+          rescue NoMethodError
+            next
+          end
+
+          return true if current_value != strip_value
+        end
+      end
+
+      UI.message('No changes to localized App Info detected. Skipping upload.')
+      return false
+    end
+
+    # Finding languages to enable
+    def verify_available_info_languages!(options, app, app_info, languages)
       unless app_info
-        UI.user_error!("Cannot update languages - could not find an editable info")
+        UI.user_error!("Cannot update languages - could not find an editable 'App Info'. Verify that your app is in one of the editable states in App Store Connect")
         return
       end
 
@@ -654,7 +699,7 @@ module Deliver
       end
       UI.message("Setting the app's age rating...")
 
-      # Maping from legacy ITC values to App Store Connect Values
+      # Mapping from legacy ITC values to App Store Connect Values
       mapped_values = {}
       attributes = {}
       json.each do |k, v|

data/deliver/lib/deliver/upload_price_tier.rb

@@ -19,9 +19,9 @@ module Deliver
       # As of 2020-09-14:
       # Official App Store Connect does not have an endpoint to get app prices for an app
       # Need to get prices from the app's relationships
-      # Prices from app's relationship doess not have price tier so need to fetch app price with price tier relationship
+      # Prices from app's relationship does not have price tier so need to fetch app price with price tier relationship
       app_prices = app.prices
-      if app_prices.first
+      if app_prices&.first
         app_price = Spaceship::ConnectAPI.get_app_price(app_price_id: app_prices.first.id, includes: "priceTier").first
         old_price = app_price.price_tier.id
       else

data/deliver/lib/deliver/upload_screenshots.rb

@@ -85,7 +85,7 @@ module Deliver
         # Only delete screenshots if trying to upload
         next unless screenshots_per_language.keys.include?(localization.locale)
 
-        UI.verbose("Queued delete sceeenshot set job for #{localization.locale} #{app_screenshot_set.screenshot_display_type}")
+        UI.verbose("Queued delete screenshot set job for #{localization.locale} #{app_screenshot_set.screenshot_display_type}")
         worker.enqueue(DeleteScreenshotSetJob.new(app_screenshot_set, localization))
       end
 
@@ -145,7 +145,7 @@ module Deliver
         if duplicate
           UI.message("Previous uploaded. Skipping '#{screenshot.path}'...")
         else
-          UI.verbose("Queued upload sceeenshot job for #{localization.locale} #{app_screenshot_set.screenshot_display_type} #{screenshot.path}")
+          UI.verbose("Queued upload screenshot job for #{localization.locale} #{app_screenshot_set.screenshot_display_type} #{screenshot.path}")
           worker.enqueue(UploadScreenshotJob.new(app_screenshot_set, screenshot.path))
           number_of_screenshots_per_set[app_screenshot_set] += 1
         end
@@ -258,7 +258,7 @@ module Deliver
     # helper method so Spaceship::Tunes.client.available_languages is easier to test
     def self.available_languages
       # 2020-08-24 - Available locales are not available as an endpoint in App Store Connect
-      # Update with Spaceship::Tunes.client.available_languages.sort (as long as endpoint is avilable)
+      # Update with Spaceship::Tunes.client.available_languages.sort (as long as endpoint is available)
       Deliver::Languages::ALL_LANGUAGES
     end
 

data/fastlane/lib/assets/custom_action_template.rb

@@ -7,7 +7,7 @@ module Fastlane
     class [[NAME_CLASS]] < Action
       def self.run(params)
         # fastlane will take care of reading in the parameter and fetching the environment variable:
-        UI.message "Parameter API Token: #{params[:api_token]}"
+        UI.message("Parameter API Token: #{params[:api_token]}")
 
         # sh "shellcommand ./path"
 
@@ -19,13 +19,13 @@ module Fastlane
       #####################################################
 
       def self.description
-        "A short description with <= 80 characters of what this action does"
+        'A short description with <= 80 characters of what this action does'
       end
 
       def self.details
         # Optional:
         # this is your chance to provide a more detailed description of this action
-        "You can use this action to do cool things..."
+        'You can use this action to do cool things...'
       end
 
       def self.available_options
@@ -34,17 +34,23 @@ module Fastlane
         # Below a few examples
         [
           FastlaneCore::ConfigItem.new(key: :api_token,
-                                       env_name: "FL_[[NAME_UP]]_API_TOKEN", # The name of the environment variable
-                                       description: "API Token for [[NAME_CLASS]]", # a short description of this parameter
+                                       # The name of the environment variable
+                                       env_name: 'FL_[[NAME_UP]]_API_TOKEN',
+                                       # a short description of this parameter
+                                       description: 'API Token for [[NAME_CLASS]]',
                                        verify_block: proc do |value|
-                                          UI.user_error!("No API token for [[NAME_CLASS]] given, pass using `api_token: 'token'`") unless (value and not value.empty?)
-                                          # UI.user_error!("Couldn't find file at path '#{value}'") unless File.exist?(value)
+                                         unless value && !value.empty?
+                                           UI.user_error!("No API token for [[NAME_CLASS]] given, pass using `api_token: 'token'`")
+                                         end
+                                         # UI.user_error!("Couldn't find file at path '#{value}'") unless File.exist?(value)
                                        end),
           FastlaneCore::ConfigItem.new(key: :development,
-                                       env_name: "FL_[[NAME_UP]]_DEVELOPMENT",
-                                       description: "Create a development certificate instead of a distribution one",
-                                       is_string: false, # true: verifies the input is a string, false: every kind of value
-                                       default_value: false) # the default value if the user didn't provide one
+                                       env_name: 'FL_[[NAME_UP]]_DEVELOPMENT',
+                                       description: 'Create a development certificate instead of a distribution one',
+                                       # true: verifies the input is a string, false: every kind of value
+                                       is_string: false,
+                                       # the default value if the user didn't provide one
+                                       default_value: false)
         ]
       end
 
@@ -62,7 +68,7 @@ module Fastlane
 
       def self.authors
         # So no one will ever forget your contribution to fastlane :) You are awesome btw!
-        ["Your GitHub/Twitter Name"]
+        ['Your GitHub/Twitter Name']
       end
 
       def self.is_supported?(platform)

data/fastlane/lib/fastlane/action.rb

@@ -179,7 +179,7 @@ class String
 
   def markdown_clean_heredoc!
     self.chomp! # remove the last new line added by the heredoc
-    self.dedent! # remove the leading whitespace (similar to the squigly heredoc `<<~`)
+    self.dedent! # remove the leading whitespace (similar to the squiggly heredoc `<<~`)
   end
 
   def dedent!

data/fastlane/lib/fastlane/actions/appledoc.rb

@@ -214,7 +214,7 @@ module Fastlane
             ],
             ignore: [
               "ignore/path/1",
-              "ingore/path/2"
+              "ignore/path/2"
             ],
             options: "--keep-intermediate-files --search-undocumented-doc",
             warnings: "--warn-missing-output-path --warn-missing-company-id"

data/fastlane/lib/fastlane/actions/apteligent.rb

@@ -8,7 +8,7 @@ module Fastlane
         command << upload_url(params[:app_id].shellescape)
 
         # Fastlane::Actions.sh has buffering issues, no progress bar is shown in real time
-        # will reanable it when it is fixed
+        # will reenable it when it is fixed
         # result = Fastlane::Actions.sh(command.join(' '), log: false)
         shell_command = command.join(' ')
         return shell_command if Helper.test?

data/fastlane/lib/fastlane/actions/backup_xcarchive.rb

@@ -15,7 +15,7 @@ module Fastlane
         zip_filename = params[:zip_filename]
         versioned = params[:versioned]
 
-        # Prepare destionation folder
+        # Prepare destination folder
         full_destination = base_destination
 
         if versioned

data/fastlane/lib/fastlane/actions/commit_github_file.rb

@@ -45,7 +45,7 @@ module Fastlane
               error = if json['message'] == "Invalid request.\n\n\"sha\" wasn't supplied."
                         "File already exists - please remove from repo before uploading or rename this upload"
                       else
-                        "Uprocessable error"
+                        "Unprocessable error"
                       end
               UI.user_error!(error)
             end
@@ -115,7 +115,7 @@ module Fastlane
                                        env_name: "FL_COMMIT_GITHUB_FILE_API_BEARER",
                                        sensitive: true,
                                        code_gen_sensitive: true,
-                                       description: "Use a Bearer authorization token. Usually generated by Github Apps, e.g. GitHub Actions GITHUB_TOKEN environment variable",
+                                       description: "Use a Bearer authorization token. Usually generated by GitHub Apps, e.g. GitHub Actions GITHUB_TOKEN environment variable",
                                        conflicting_options: [:api_token],
                                        optional: true,
                                        default_value: nil),

data/fastlane/lib/fastlane/actions/copy_artifacts.rb

@@ -25,7 +25,7 @@ module Fastlane
           missing = artifacts.reject { |a| File.exist?(a) }
           UI.user_error!("Not all files were present in copy artifacts. Missing #{missing.join(', ')}") unless missing.empty?
         else
-          # If we don't fail on non-existent files, don't try to copy non-existent files
+          # If we don't fail on nonexistent files, don't try to copy nonexistent files
           artifacts.select! { |artifact| File.exist?(artifact) }
         end
 

data/fastlane/lib/fastlane/actions/create_app_online.rb

@@ -10,7 +10,7 @@ module Fastlane
 
         return if Helper.test?
 
-        Produce.config = params # we alread have the finished config
+        Produce.config = params # we already have the finished config
 
         Dir.chdir(FastlaneCore::FastlaneFolder.path || Dir.pwd) do
           # This should be executed in the fastlane folder

data/fastlane/lib/fastlane/actions/create_pull_request.rb

@@ -169,7 +169,7 @@ module Fastlane
                                        optional: true),
           FastlaneCore::ConfigItem.new(key: :api_bearer,
                                        env_name: "GITHUB_PULL_REQUEST_API_BEARER",
-                                       description: "Use a Bearer authorization token. Usually generated by Github Apps, e.g. GitHub Actions GITHUB_TOKEN environment variable",
+                                       description: "Use a Bearer authorization token. Usually generated by GitHub Apps, e.g. GitHub Actions GITHUB_TOKEN environment variable",
                                        sensitive: true,
                                        code_gen_sensitive: true,
                                        conflicting_options: [:api_token],

data/fastlane/lib/fastlane/actions/docs/build_app.md

@@ -42,8 +42,8 @@ fastlane gym
 
 _gym_ uses the latest APIs to build and sign your application which results in much faster build times.
 
-|          |  Gym Features  |
-|----------|----------------|
+|          |  _gym_ Features  |
+|----------|------------------|
 🚀 | _gym_ builds 30% faster than other build tools like [shenzhen](https://github.com/nomad/shenzhen)
 🏁 | Beautiful inline build output
 📖 | Helps you resolve common build errors like code signing issues

data/fastlane/lib/fastlane/actions/docs/capture_android_screenshots.md

@@ -32,7 +32,7 @@ androidTestImplementation 'tools.fastlane:screengrab:x.x.x'
 
 The latest version is [ ![Download](https://maven-badges.herokuapp.com/maven-central/tools.fastlane/screengrab/badge.svg)](https://search.maven.org/artifact/tools.fastlane/screengrab)
 
-As of Screengrab version 2.0.0, all Android test dependencies are AndroidX dependencies. This means a device with API 18+, Android 4.3 or greater is required. If you wish to capture screenshots with an older Android OS, then you must use a 1.x.x version.
+As of _screengrab_ version 2.0.0, all Android test dependencies are AndroidX dependencies. This means a device with API 18+, Android 4.3 or greater is required. If you wish to capture screenshots with an older Android OS, then you must use a 1.x.x version.
 
 ##### Configuring your Manifest Permissions
 
@@ -63,21 +63,21 @@ Ensure that the following permissions exist in your **src/debug/AndroidManifest.
 1. Add `LocaleTestRule` to your tests class to handle automatic switching of locales.
 
    If you're using Java use:
-   
+
    ```java
    @ClassRule
    public static final LocaleTestRule localeTestRule = new LocaleTestRule();
    ```
-   
+
    If you're using Kotlin use:
-   
+
    ```kotlin
    @Rule @JvmField
    val localeTestRule = LocaleTestRule()
    ```
-   
+
    The `@JvmField` annotation is important. It won't work like this:
-   
+
    ```kotlin
    companion object {
        @get:ClassRule
@@ -87,7 +87,7 @@ Ensure that the following permissions exist in your **src/debug/AndroidManifest.
 
 2. To capture screenshots, add the following to your tests `Screengrab.screenshot("name_of_screenshot_here");` on the appropriate screens
 
-# Generating Screenshots with Screengrab
+# Generating Screenshots with _screengrab_
 - Then, before running `fastlane screengrab` you'll need a debug and test apk
   - You can create your APKs manually with `./gradlew assembleDebug assembleAndroidTest`
   - You can also create a lane and use `build_android_app`:
@@ -228,7 +228,7 @@ When using JUnit 3 you'll need to add a bit more code:
 
 ## Clean Status Bar
 
-Screengrab can clean your status bar to make your screenshots even more beautiful.
+_screengrab_ can clean your status bar to make your screenshots even more beautiful.
 It is simply a wrapper that allows configuring SystemUI DemoMode in your code.
 Note: the clean status bar feature is only supported on devices with *API level >= 23*.
 

data/fastlane/lib/fastlane/actions/docs/check_app_store_metadata.md

@@ -2,7 +2,7 @@
   <img src="/img/actions/precheck.png" width="250">
 </p>
 
-Precheck
+_precheck_
 ============
 
 ###### Check your app using a community driven set of App Store review rules to avoid being rejected
@@ -23,8 +23,8 @@ Apple rejects builds for many avoidable metadata issues like including swear wor
 # Features
 
 
-|          |  precheck Features  |
-|----------|-----------------|
+|          |  _precheck_ Features  |
+|----------|-----------------------|
 🐛 |  product bug mentions
 🙅 | Swear word checker
 🤖 | Mentioning other platforms

data/fastlane/lib/fastlane/actions/docs/get_push_certificate.md

@@ -48,7 +48,7 @@ This does the following:
 - Downloads the certificate
 - Generates a new ```.pem``` file in the current working directory, which you can upload to your server
 
-Note that _pem_ will never revoke your existing certificates. _pem_ can't download any of your existing push certificates, as the private key is only available on the machine it was created on. 
+Note that _pem_ will never revoke your existing certificates. _pem_ can't download any of your existing push certificates, as the private key is only available on the machine it was created on.
 
 If you already have a push certificate enabled, which is active for at least 30 more days, _pem_ will not create a new certificate. If you still want to create one, use the `force`:
 
@@ -111,7 +111,7 @@ If you need the `p12` in your keychain, perhaps to test push with an app like [K
 Enter Import Password:
   <hit enter: the p12 has no password>
 MAC verified OK
-Enter PEM pass phrase:
+Enter your pem passphrase:
   <enter a temporary password to encrypt the pem file>
 
 % openssl pkcs12 -export -in my.pem -out my-with-passphrase.p12

data/fastlane/lib/fastlane/actions/docs/sync_code_signing.md

@@ -212,7 +212,7 @@ fastlane match development
 
 <img src="/img/actions/match_appstore_small.gif" width="550" />
 
-This will create a new certificate and provisioning profile (if required) and store them in your selected storage.  
+This will create a new certificate and provisioning profile (if required) and store them in your selected storage.
 If you previously ran _match_ with the configured storage it will automatically install the existing profiles from your storage.
 
 The provisioning profiles are installed in `~/Library/MobileDevice/Provisioning Profiles` while the certificates and private keys are installed in your Keychain.
@@ -400,7 +400,7 @@ By using the `force_for_new_devices` parameter, _match_ will check if the (enabl
 
 _**Important:** The `force_for_new_devices` parameter is ignored for App Store provisioning profiles since they don't contain any device information._
 
-If you're not using _fastlane_, you can also use the `force_for_new_devices` option from the command line:
+If you're not using `Fastfile`, you can also use the `force_for_new_devices` option from the command line:
 
 ```no-highlight
 fastlane match adhoc --force_for_new_devices
@@ -408,7 +408,7 @@ fastlane match adhoc --force_for_new_devices
 
 ##### Templates (aka: custom entitlements)
 
-Match can generate profiles that contain custom entitlements by passing in the entitlement's name with the `template_name` parameter.
+_match_ can generate profiles that contain custom entitlements by passing in the entitlement's name with the `template_name` parameter.
 
 ```
 match(type: "development",
@@ -512,9 +512,11 @@ Please be careful when using this option and ensure the certificates and profile
 If you want to manually decrypt a file you can.
 
 ```no-highlight
-openssl aes-256-cbc -k "<password>" -in "<fileYouWantToDecryptPath>" -out "<decryptedFilePath>" -a -d
+openssl aes-256-cbc -k "<password>" -in "<fileYouWantToDecryptPath>" -out "<decryptedFilePath>" -a -d -md [md5|sha256]
 ```
 
+_**Note:** You may need to swap double quotes `"` for single quotes `'` if your match password contains an exclamation mark `!`._
+
 #### Export Distribution Certificate and Private Key as Single .p12 File
 
 _match_ stores the certificate (`.cer`) and the private key (`.p12`) files separately. The following steps will repackage the separate certificate and private key into a single `.p12` file.

data/fastlane/lib/fastlane/actions/docs/upload_to_app_store.md.erb

@@ -441,7 +441,7 @@ fastlane deliver submit_build --build_number 830 --submission_information "{\"ex
 
 ### App Privacy Details
 
-Starting on December 8, 2020, Apple announced that developers are required to provide app privacy details that will help users understand an app's privacy practies. _deliver_ does not allow for updating of this information but this can be done with the _upload_app_privacy_details_to_app_store_ action. More information on [Uploading App Privacy Details](https://docs.fastlane.tools/uploading-app-privacy-details)
+Starting on December 8, 2020, Apple announced that developers are required to provide app privacy details that will help users understand an app's privacy practices. _deliver_ does not allow for updating of this information but this can be done with the _upload_app_privacy_details_to_app_store_ action. More information on [Uploading App Privacy Details](https://docs.fastlane.tools/uploading-app-privacy-details)
 
 # Credentials
 

data/fastlane/lib/fastlane/actions/docs/upload_to_play_store.md

@@ -179,6 +179,12 @@ This can be done using the `--track_promote_to` parameter. The `--track_promote_
 Before performing a new APK upload you may want to check existing track version codes or release names, or you may simply want to provide an informational lane that displays the currently promoted version codes or release name for the production track. You can use the `google_play_track_version_codes` action to retrieve existing version codes for a package and track. You can use the `google_play_track_release_names` action to retrieve existing release names for a package and track.
 For more information, see the `fastlane action google_play_track_version_codes` and `fastlane action google_play_track_release_names` help output.
 
+## Parallel uploads
+
+By default _supply_ will spawn 10 threads to upload the metadata concurrently (_images, screenshots, texts_). If you want to change this, set either `DELIVER_NUMBER_OF_THREADS` or `FL_NUMBER_OF_THREADS` environment variable to any value between 1 and 10.
+
+If you want _supply_ to upload with more than 10 threads in parallel then you need to **additionally** set `FL_MAX_NUMBER_OF_THREADS` environment variable to the max number of parallel upload threads you wish to have (**Warning ⚠️** use this at your own risk!).
+
 ## Migration from AndroidPublisherV2 to AndroidPublisherV3 in _fastlane_ 2.135.0
 
 ### New Options
@@ -200,5 +206,3 @@ For more information, see the `fastlane action google_play_track_version_codes`
   - Google Play will automatically remove releases that are superseded now
 - `:deactivate_on_promote`
   - Google Play will automatically deactivate a release from its previous track on promote
-
-:

data/fastlane/lib/fastlane/actions/docs/upload_to_testflight.md

@@ -4,7 +4,7 @@
 
 ###### The best way to manage your TestFlight testers and builds from your terminal
 
-Pilot makes it easier to manage your app on Apple’s TestFlight. You can:
+_pilot_ makes it easier to manage your app on Apple’s TestFlight. You can:
 
 - Upload & distribute builds
 - Add & remove testers

data/fastlane/lib/fastlane/actions/download_universal_apk_from_google_play.rb

@@ -0,0 +1,124 @@
+require 'supply'
+require 'supply/options'
+
+module Fastlane
+  module Actions
+    class DownloadUniversalApkFromGooglePlayAction < Action
+      def self.run(params)
+        package_name = params[:package_name]
+        version_code = params[:version_code]
+        destination = params[:destination]
+        cert_sha = params[:certificate_sha256_hash]
+
+        client = Supply::Client.make_from_config(params: params)
+
+        UI.message("Fetching the list of generated APKs from the Google API...")
+        all_universal_apks = client.list_generated_universal_apks(package_name: package_name, version_code: version_code)
+        matching_apks = all_universal_apks.select { |apk| cert_sha.nil? || apk.certificate_sha256_hash&.casecmp?(cert_sha) }
+
+        all_certs_printable_list = all_universal_apks.map { |apk| " - #{apk.certificate_sha256_hash}" }
+        if matching_apks.count > 1
+          message = <<~ERROR
+            We found multiple Generated Universal APK, with the following `certificate_sha256_hash`:
+            #{all_certs_printable_list.join("\n")}
+
+            Use the `certificate_sha256_hash` parameter to specify which one to download.
+          ERROR
+          UI.user_error!(message)
+        elsif matching_apks.empty?
+          # NOTE: if no APK was found at all to begin with, the client would already have raised a user_error!('Google Api Error ...')
+          message = <<~ERROR
+            None of the Universal APK(s) found for this version code matched the `certificate_sha256_hash` of `#{cert_sha}`.
+
+            We found #{all_universal_apks.count} Generated Universal APK(s), but with a different `certificate_sha256_hash`:
+            #{all_certs_printable_list.join("\n")}
+          ERROR
+          UI.user_error!(message)
+        end
+
+        UI.message("Downloading Generated Universal APK to `#{destination}`...")
+        FileUtils.mkdir_p(File.dirname(destination))
+        client.download_generated_universal_apk(generated_universal_apk: matching_apks.first, destination: destination)
+
+        UI.success("Universal APK successfully downloaded to `#{destination}`.")
+        destination
+      end
+
+      #####################################################
+      # @!group Documentation
+      #####################################################
+
+      def self.description
+        "Download the Universal APK of a given version code from the Google Play Console"
+      end
+
+      def self.details
+        <<~DETAILS
+        Download the universal APK of a given version code from the Google Play Console.
+
+        This uses _fastlane_ `supply` (and the `AndroidPublisher` Google API) to download the Universal APK
+        generated by Google after you uploaded an `.aab` bundle to the Play Console.
+
+        See https://developers.google.com/android-publisher/api-ref/rest/v3/generatedapks/list
+        DETAILS
+      end
+
+      def self.available_options
+        # Only borrow _some_ of the ConfigItems from https://github.com/fastlane/fastlane/blob/master/supply/lib/supply/options.rb
+        # So we don't have to duplicate the name, env_var, type, description, and verify_block of those here.
+        supply_borrowed_options = Supply::Options.available_options.select do |o|
+          %i[package_name version_code json_key json_key_data root_url timeout].include?(o.key)
+        end
+        # Adjust the description for the :version_code ConfigItem for our action's use case
+        supply_borrowed_options.find { |o| o.key == :version_code }&.description = "The versionCode for which to download the generated APK"
+
+        [
+          *supply_borrowed_options,
+
+          # The remaining ConfigItems below are specific to this action
+          FastlaneCore::ConfigItem.new(key: :destination,
+                                       env_name: 'DOWNLOAD_UNIVERSAL_APK_DESTINATION',
+                                       optional: false,
+                                       type: String,
+                                       description: "The path on disk where to download the Generated Universal APK",
+                                       verify_block: proc do |value|
+                                         UI.user_error!("The 'destination' must be a file path with the `.apk` file extension") unless File.extname(value) == '.apk'
+                                       end),
+          FastlaneCore::ConfigItem.new(key: :certificate_sha256_hash,
+                                       env_name: 'DOWNLOAD_UNIVERSAL_APK_CERTIFICATE_SHA256_HASH',
+                                       optional: true,
+                                       type: String,
+                                       description: "The SHA256 hash of the signing key for which to download the Universal, Code-Signed APK for. " \
+                                       + "Use 'xx:xx:xx:…' format (32 hex bytes separated by colons), as printed by `keytool -list -keystore <keystorefile>`. " \
+                                       + "Only useful to provide if you have multiple signing keys configured on GPC, to specify which generated APK to download",
+                                       verify_block: proc do |value|
+                                         bytes = value.split(':')
+                                         next if bytes.length == 32 && bytes.all? { |byte| /^[0-9a-fA-F]{2}$/.match?(byte) }
+
+                                         UI.user_error!("When provided, the certificate sha256 must be in the 'xx:xx:xx:…:xx' (32 hex bytes separated by colons) format")
+                                       end)
+        ]
+      end
+
+      def self.output
+        # Define the shared values you are going to provide
+      end
+
+      def self.return_value
+        'The path to the downloaded Universal APK. The action will raise an exception if it failed to find or download the APK in Google Play'
+      end
+
+      def self.authors
+        ['Automattic']
+      end
+
+      def self.category
+        :production
+      end
+
+      def self.is_supported?(platform)
+        platform == :android
+      end
+    end
+  end
+end