fastlane 2.234.0 → 2.236.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 525a3a4fbaab6476e3908604bbe7961491cb337a2a389a4ddd5d42248b9ff05c
-  data.tar.gz: 1fc064f5f314cebf73705bc011a6074e458b87ba5b2b0d34296f57b6d14a83c7
+  metadata.gz: f129a659ef224d3a5367a5b69ff6a05e5bb9bf18f4034b8494a891804592438d
+  data.tar.gz: dca0b340e8cb13eac6472054edc5750cbdbe572b21180fda9c22c84f4cb8da44
 SHA512:
-  metadata.gz: 9b9d73f37397f4f03ada825e099f3904adb879133c7c777a95418e8898922ef3d04b2594c1db5e95cfb34e202f9d493ba613428deccfaacc7401dbe2a941f95b
-  data.tar.gz: db0c73f50e6c6e8d745944739ab3f0c86bdc6328026c03eed1dae1d0402031553af1d506e970206438df4638d64b32c15b7321295929ffd9ed98c936691d6d93
+  metadata.gz: b24b41096b6ca155d1056a9d9ce9aed33ecd0e9eacc42ad03584fa5a341132a01c0f36e90087b7cfb78c4540e0412098285c06dbb08de3c1c8daf595d8181a29
+  data.tar.gz: 3c46b2adb30f65d2649c1ee4510d7f08e612b3fe9ff4c880f587edca2c0e82c1f840b508836ce72ee504bc36adedc9f5391d11bd2c5a548f1a145fe5ca637d7d

data/README.md

@@ -36,17 +36,23 @@ If the above doesn't help, please [submit an issue](https://github.com/fastlane/
 <!-- This table is regenerated and resorted on each release -->
 <table id='team'>
 <tr>
-<td id='joshua-liebowitz'>
-<a href='https://github.com/taquitos'>
-<img src='https://github.com/taquitos.png' width='140px;'>
+<td id='fumiya-nakamura'>
+<a href='https://github.com/nafu'>
+<img src='https://github.com/nafu.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/taquitos'>Joshua Liebowitz</a></h4>
+<h4 align='center'><a href='https://twitter.com/nafu003'>Fumiya Nakamura</a></h4>
 </td>
-<td id='manish-rathi'>
-<a href='https://github.com/crazymanish'>
-<img src='https://github.com/crazymanish.png' width='140px;'>
+<td id='iulian-onofrei'>
+<a href='https://github.com/revolter'>
+<img src='https://github.com/revolter.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/iammanishrathi'>Manish Rathi</a></h4>
+<h4 align='center'><a href='https://twitter.com/Revolt666'>Iulian Onofrei</a></h4>
+</td>
+<td id='helmut-januschka'>
+<a href='https://github.com/hjanuschka'>
+<img src='https://github.com/hjanuschka.png' width='140px;'>
+</a>
+<h4 align='center'><a href='https://twitter.com/hjanuschka'>Helmut Januschka</a></h4>
 </td>
 <td id='josh-holtz'>
 <a href='https://github.com/joshdholtz'>
@@ -54,37 +60,19 @@ If the above doesn't help, please [submit an issue](https://github.com/fastlane/
 </a>
 <h4 align='center'><a href='https://twitter.com/joshdholtz'>Josh Holtz</a></h4>
 </td>
-<td id='satoshi-namai'>
-<a href='https://github.com/ainame'>
-<img src='https://github.com/ainame.png' width='140px;'>
-</a>
-<h4 align='center'><a href='https://twitter.com/ainame'>Satoshi Namai</a></h4>
-</td>
-<td id='jérôme-lacoste'>
-<a href='https://github.com/lacostej'>
-<img src='https://github.com/lacostej.png' width='140px;'>
+<td id='connor-tumbleson'>
+<a href='https://github.com/ibotpeaches'>
+<img src='https://github.com/ibotpeaches.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/lacostej'>Jérôme Lacoste</a></h4>
+<h4 align='center'><a href='https://twitter.com/ibotpeaches'>Connor Tumbleson</a></h4>
 </td>
 </tr>
 <tr>
-<td id='kohki-miki'>
-<a href='https://github.com/giginet'>
-<img src='https://github.com/giginet.png' width='140px;'>
-</a>
-<h4 align='center'><a href='https://twitter.com/giginet'>Kohki Miki</a></h4>
-</td>
-<td id='maksym-grebenets'>
-<a href='https://github.com/mgrebenets'>
-<img src='https://github.com/mgrebenets.png' width='140px;'>
-</a>
-<h4 align='center'><a href='https://twitter.com/mgrebenets'>Maksym Grebenets</a></h4>
-</td>
-<td id='olivier-halligon'>
-<a href='https://github.com/AliSoftware'>
-<img src='https://github.com/AliSoftware.png' width='140px;'>
+<td id='aaron-brager'>
+<a href='https://github.com/getaaron'>
+<img src='https://github.com/getaaron.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/aligatr'>Olivier Halligon</a></h4>
+<h4 align='center'><a href='https://twitter.com/getaaron'>Aaron Brager</a></h4>
 </td>
 <td id='matthew-ellis'>
 <a href='https://github.com/matthewellis'>
@@ -92,63 +80,81 @@ If the above doesn't help, please [submit an issue](https://github.com/fastlane/
 </a>
 <h4 align='center'><a href='https://twitter.com/mellis1995'>Matthew Ellis</a></h4>
 </td>
-<td id='daniel-jankowski'>
-<a href='https://github.com/mollyIV'>
-<img src='https://github.com/mollyIV.png' width='140px;'>
+<td id='danielle-tomlinson'>
+<a href='https://github.com/endocrimes'>
+<img src='https://github.com/endocrimes.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/mollyIV'>Daniel Jankowski</a></h4>
+<h4 align='center'><a href='https://twitter.com/endocrimes'>Danielle Tomlinson</a></h4>
+</td>
+<td id='andrew-mcburney'>
+<a href='https://github.com/armcburney'>
+<img src='https://github.com/armcburney.png' width='140px;'>
+</a>
+<h4 align='center'><a href='https://twitter.com/armcburney'>Andrew McBurney</a></h4>
+</td>
+<td id='olivier-halligon'>
+<a href='https://github.com/AliSoftware'>
+<img src='https://github.com/AliSoftware.png' width='140px;'>
+</a>
+<h4 align='center'><a href='https://twitter.com/aligatr'>Olivier Halligon</a></h4>
 </td>
 </tr>
 <tr>
-<td id='connor-tumbleson'>
-<a href='https://github.com/ibotpeaches'>
-<img src='https://github.com/ibotpeaches.png' width='140px;'>
+<td id='kohki-miki'>
+<a href='https://github.com/giginet'>
+<img src='https://github.com/giginet.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/ibotpeaches'>Connor Tumbleson</a></h4>
+<h4 align='center'><a href='https://twitter.com/giginet'>Kohki Miki</a></h4>
 </td>
-<td id='jan-piotrowski'>
-<a href='https://github.com/janpio'>
-<img src='https://github.com/janpio.png' width='140px;'>
+<td id='roger-oba'>
+<a href='https://github.com/rogerluan'>
+<img src='https://github.com/rogerluan.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/Sujan'>Jan Piotrowski</a></h4>
+<h4 align='center'><a href='https://twitter.com/rogerluan_'>Roger Oba</a></h4>
 </td>
-<td id='jorge-revuelta-h'>
-<a href='https://github.com/minuscorp'>
-<img src='https://github.com/minuscorp.png' width='140px;'>
+<td id='joshua-liebowitz'>
+<a href='https://github.com/taquitos'>
+<img src='https://github.com/taquitos.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/minuscorp'>Jorge Revuelta H</a></h4>
+<h4 align='center'><a href='https://twitter.com/taquitos'>Joshua Liebowitz</a></h4>
 </td>
-<td id='max-ott'>
-<a href='https://github.com/max-ott'>
-<img src='https://github.com/max-ott.png' width='140px;'>
+<td id='manish-rathi'>
+<a href='https://github.com/crazymanish'>
+<img src='https://github.com/crazymanish.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/ott_max'>Max Ott</a></h4>
+<h4 align='center'><a href='https://twitter.com/iammanishrathi'>Manish Rathi</a></h4>
 </td>
+<td id='jimmy-dee'>
+<a href='https://github.com/jdee'>
+<img src='https://github.com/jdee.png' width='140px;'>
+</a>
+<h4 align='center'>Jimmy Dee</h4>
+</td>
+</tr>
+<tr>
 <td id='luka-mirosevic'>
 <a href='https://github.com/lmirosevic'>
 <img src='https://github.com/lmirosevic.png' width='140px;'>
 </a>
 <h4 align='center'><a href='https://twitter.com/lmirosevic'>Luka Mirosevic</a></h4>
 </td>
-</tr>
-<tr>
-<td id='fumiya-nakamura'>
-<a href='https://github.com/nafu'>
-<img src='https://github.com/nafu.png' width='140px;'>
+<td id='jorge-revuelta-h'>
+<a href='https://github.com/minuscorp'>
+<img src='https://github.com/minuscorp.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/nafu003'>Fumiya Nakamura</a></h4>
+<h4 align='center'><a href='https://twitter.com/minuscorp'>Jorge Revuelta H</a></h4>
 </td>
-<td id='danielle-tomlinson'>
-<a href='https://github.com/endocrimes'>
-<img src='https://github.com/endocrimes.png' width='140px;'>
+<td id='manu-wallner'>
+<a href='https://github.com/milch'>
+<img src='https://github.com/milch.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/endocrimes'>Danielle Tomlinson</a></h4>
+<h4 align='center'><a href='https://twitter.com/acrooow'>Manu Wallner</a></h4>
 </td>
-<td id='felix-krause'>
-<a href='https://github.com/KrauseFx'>
-<img src='https://github.com/KrauseFx.png' width='140px;'>
+<td id='łukasz-grabowski'>
+<a href='https://github.com/lucgrabowski'>
+<img src='https://github.com/lucgrabowski.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/KrauseFx'>Felix Krause</a></h4>
+<h4 align='center'>Łukasz Grabowski</h4>
 </td>
 <td id='stefan-natchev'>
 <a href='https://github.com/snatchev'>
@@ -156,57 +162,51 @@ If the above doesn't help, please [submit an issue](https://github.com/fastlane/
 </a>
 <h4 align='center'><a href='https://twitter.com/snatchev'>Stefan Natchev</a></h4>
 </td>
-<td id='aaron-brager'>
-<a href='https://github.com/getaaron'>
-<img src='https://github.com/getaaron.png' width='140px;'>
-</a>
-<h4 align='center'><a href='https://twitter.com/getaaron'>Aaron Brager</a></h4>
-</td>
 </tr>
 <tr>
-<td id='manu-wallner'>
-<a href='https://github.com/milch'>
-<img src='https://github.com/milch.png' width='140px;'>
+<td id='maksym-grebenets'>
+<a href='https://github.com/mgrebenets'>
+<img src='https://github.com/mgrebenets.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/acrooow'>Manu Wallner</a></h4>
+<h4 align='center'><a href='https://twitter.com/mgrebenets'>Maksym Grebenets</a></h4>
 </td>
-<td id='andrew-mcburney'>
-<a href='https://github.com/armcburney'>
-<img src='https://github.com/armcburney.png' width='140px;'>
+<td id='satoshi-namai'>
+<a href='https://github.com/ainame'>
+<img src='https://github.com/ainame.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/armcburney'>Andrew McBurney</a></h4>
+<h4 align='center'><a href='https://twitter.com/ainame'>Satoshi Namai</a></h4>
 </td>
-<td id='łukasz-grabowski'>
-<a href='https://github.com/lucgrabowski'>
-<img src='https://github.com/lucgrabowski.png' width='140px;'>
+<td id='felix-krause'>
+<a href='https://github.com/KrauseFx'>
+<img src='https://github.com/KrauseFx.png' width='140px;'>
 </a>
-<h4 align='center'>Łukasz Grabowski</h4>
+<h4 align='center'><a href='https://twitter.com/KrauseFx'>Felix Krause</a></h4>
 </td>
-<td id='jimmy-dee'>
-<a href='https://github.com/jdee'>
-<img src='https://github.com/jdee.png' width='140px;'>
+<td id='max-ott'>
+<a href='https://github.com/max-ott'>
+<img src='https://github.com/max-ott.png' width='140px;'>
 </a>
-<h4 align='center'>Jimmy Dee</h4>
+<h4 align='center'><a href='https://twitter.com/ott_max'>Max Ott</a></h4>
 </td>
-<td id='helmut-januschka'>
-<a href='https://github.com/hjanuschka'>
-<img src='https://github.com/hjanuschka.png' width='140px;'>
+<td id='daniel-jankowski'>
+<a href='https://github.com/mollyIV'>
+<img src='https://github.com/mollyIV.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/hjanuschka'>Helmut Januschka</a></h4>
+<h4 align='center'><a href='https://twitter.com/mollyIV'>Daniel Jankowski</a></h4>
 </td>
 </tr>
 <tr>
-<td id='roger-oba'>
-<a href='https://github.com/rogerluan'>
-<img src='https://github.com/rogerluan.png' width='140px;'>
+<td id='jérôme-lacoste'>
+<a href='https://github.com/lacostej'>
+<img src='https://github.com/lacostej.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/rogerluan_'>Roger Oba</a></h4>
+<h4 align='center'><a href='https://twitter.com/lacostej'>Jérôme Lacoste</a></h4>
 </td>
-<td id='iulian-onofrei'>
-<a href='https://github.com/revolter'>
-<img src='https://github.com/revolter.png' width='140px;'>
+<td id='jan-piotrowski'>
+<a href='https://github.com/janpio'>
+<img src='https://github.com/janpio.png' width='140px;'>
 </a>
-<h4 align='center'><a href='https://twitter.com/Revolt666'>Iulian Onofrei</a></h4>
+<h4 align='center'><a href='https://twitter.com/Sujan'>Jan Piotrowski</a></h4>
 </td>
 </table>
 

data/bin/fastlane

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 
-if RUBY_VERSION < '2.7.0'
-  abort("fastlane requires Ruby 2.7.0 or higher")
+if RUBY_VERSION < '3.0.0'
+  abort("fastlane requires Ruby 3.0.0 or higher")
 end
 
 def self.windows?

data/deliver/lib/deliver/app_clip_header_image.rb

@@ -0,0 +1,18 @@
+require 'fastimage'
+
+require_relative 'module'
+
+module Deliver
+  # AppClipHeaderImage represents one app clip header image for one specific locale.
+  class AppClipHeaderImage
+    attr_accessor :path
+    attr_accessor :language
+
+    # @param path (String) path to the app clip header image file
+    # @param language (String) Language of this app clip header image (e.g. en-US)
+    def initialize(path, language)
+      self.path = path
+      self.language = language
+    end
+  end
+end

data/deliver/lib/deliver/commands_generator.rb

@@ -3,6 +3,7 @@ require 'fastlane/version'
 require 'fastlane_core/ui/help_formatter'
 
 require_relative 'download_screenshots'
+require_relative 'download_app_clip_header_images'
 require_relative 'options'
 require_relative 'module'
 require_relative 'generate_summary'
@@ -152,6 +153,22 @@ module Deliver
         end
       end
 
+      command :download_app_clip_header_images do |c|
+        c.syntax = 'fastlane deliver download_app_clip_header_images'
+        c.description = "Downloads all existing app clip header images from App Store Connect and stores them in the app_clip_header_images folder"
+
+        FastlaneCore::CommanderGenerator.new.generate(deliverfile_options, command: c)
+
+        c.action do |args, options|
+          options = FastlaneCore::Configuration.create(deliverfile_options(skip_verification: true), options.__hash__)
+          options.load_configuration_file("Deliverfile")
+          Deliver::Runner.new(options, skip_version: true) # to login...
+          containing = FastlaneCore::Helper.fastlane_enabled_folder_path
+          path = options[:app_clip_header_images_path] || File.join(containing, 'app_clip_header_images')
+          Deliver::DownloadAppClipHeaderImages.run(options, path)
+        end
+      end
+
       command :download_metadata do |c|
         c.syntax = 'fastlane deliver download_metadata'
         c.description = "Downloads existing metadata and stores it locally. This overwrites the local files."

data/deliver/lib/deliver/download_app_clip_header_images.rb

@@ -0,0 +1,64 @@
+require_relative 'module'
+require 'spaceship'
+
+module Deliver
+  class DownloadAppClipHeaderImages
+    def self.run(options, path)
+      UI.message("Downloading all existing app clip header images...")
+      download(options, path)
+      UI.success("Successfully downloaded all existing app clip header images")
+    rescue => ex
+      UI.error(ex)
+      UI.error("Couldn't download already existing app clip header images from App Store Connect.")
+    end
+
+    def self.download(options, folder_path)
+      app = Deliver.cache[:app]
+
+      platform = Spaceship::ConnectAPI::Platform.map(options[:platform])
+      if options[:use_live_version]
+        version = app.get_live_app_store_version(platform: platform, includes: Spaceship::ConnectAPI::AppStoreVersion::ESSENTIAL_INCLUDES + ",appClipDefaultExperience")
+        UI.user_error!("Could not find a live version on App Store Connect. Try using '--use_live_version false'") if version.nil?
+      else
+        version = app.get_edit_app_store_version(platform: platform, includes: Spaceship::ConnectAPI::AppStoreVersion::ESSENTIAL_INCLUDES + ",appClipDefaultExperience")
+        UI.user_error!("Could not find an edit version on App Store Connect. Try using '--use_live_version true'") if version.nil?
+      end
+
+      default_experience = version.app_clip_default_experience
+      UI.user_error!("Cannot download app clip header images if no default experience exists for version '#{version.version_string}'") unless default_experience
+
+      localizations = Spaceship::ConnectAPI::AppClipDefaultExperienceLocalization.find_all(app_clip_default_experience_id: default_experience.id, includes: 'appClipHeaderImage')
+
+      threads = []
+      localizations.each do |localization|
+        threads << Thread.new do
+          download_app_clip_header_image(folder_path, localization)
+        end
+      end
+      threads.each(&:join)
+    end
+
+    def self.download_app_clip_header_image(folder_path, localization)
+      language = localization.locale
+      app_clip_header_image = localization.app_clip_header_image
+
+      file_name = app_clip_header_image.file_name
+      original_file_extension = File.extname(file_name).strip.downcase[1..-1]
+
+      url = app_clip_header_image.image_asset_url(type: original_file_extension)
+      return if url.nil?
+
+      UI.message("Downloading existing app clip header image '#{file_name}' for language '#{language}'")
+
+      containing_folder = File.join(folder_path, language)
+      begin
+        FileUtils.mkdir_p(containing_folder)
+      rescue
+        # if it's already there
+      end
+
+      path = File.join(containing_folder, file_name)
+      File.binwrite(path, FastlaneCore::Helper.open_uri(url).read)
+    end
+  end
+end

data/deliver/lib/deliver/languages.rb

@@ -1,7 +1,40 @@
+require 'fastlane_core/languages'
+
 module Deliver
   module 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 available)
-    ALL_LANGUAGES = %w[ar-SA bn-BD ca cs da de-DE el en-AU en-CA en-GB en-US es-ES es-MX fi fr-CA fr-FR gu-IN he hi hr hu id it ja kn-IN ko ml-IN mr-IN ms nl-NL no or-IN pa-IN pl pt-BR pt-PT ro ru sk sl-SI sv ta-IN te-IN th tr uk ur-PK vi zh-Hans zh-Hant]
+    ALL_LANGUAGES = FastlaneCore::Languages::ALL_LANGUAGES
+
+    # Detects all enabled languages from various sources
+    # @param options [Hash] The options hash containing language settings
+    # @param localized_values_keys [Array<Symbol>] Keys to check for localized values in options
+    # @param metadata_path [String, nil] Path to metadata folder to check for language folders
+    # @param ignore_validation [Boolean] Whether to ignore language directory validation
+    # @return [Array<String>] List of unique enabled language codes
+    def self.detect_languages(options:, localized_values_keys: [], metadata_path: nil, ignore_validation: false)
+      require_relative 'loader'
+
+      enabled_languages = options[:languages] || []
+
+      # Get all languages used in existing localized settings
+      localized_values_keys.each do |key|
+        current = options[key]
+        next unless current && current.kind_of?(Hash)
+        current.each do |language, value|
+          enabled_languages << language unless enabled_languages.include?(language)
+        end
+      end
+
+      # Check folder list if metadata_path is provided (an empty folder signifies a language is required)
+      if metadata_path
+        Loader.language_folders(metadata_path, ignore_validation).each do |lang_folder|
+          enabled_languages << lang_folder.basename unless enabled_languages.include?(lang_folder.basename)
+        end
+      end
+
+      # Mapping to strings because :default symbol can be passed in
+      enabled_languages
+        .map(&:to_s)
+        .uniq
+    end
   end
 end

data/deliver/lib/deliver/loader.rb

@@ -1,6 +1,7 @@
 require_relative 'module'
 require_relative 'app_screenshot'
 require_relative 'app_screenshot_validator'
+require_relative 'app_clip_header_image'
 require_relative 'upload_metadata'
 require_relative 'languages'
 
@@ -109,6 +110,46 @@ module Deliver
       valid_screenshots
     end
 
+    # Returns the list of valid app clip header images. When detecting invalid header images, this
+    # will cause an error. There may only be a max of one image per language and each image must be
+    # exactly 1800x1200.
+    #
+    # @param root [String] A directory path
+    # @param ignore_validation [String] Set false not to raise the error when
+    # finding invalid folder name @return [Array<Deliver::AppClipHeaderImage>]
+    # The list of AppClipHeaderImage that exists under given `root` directory
+    def self.load_app_clip_header_images(root, ignore_validation)
+      language_folders_list = language_folders(root, ignore_validation, true)
+
+      # Load images from all language folders (including default)
+      app_clip_header_images = language_folders_list.flat_map do |language_folder|
+        paths = language_folder.file_paths
+        paths.map { |path| AppClipHeaderImage.new(path, language_folder.language) }
+      end
+
+      # validate the header images are 1800x1200 in size
+      app_clip_header_images.each do |header_image|
+        size = FastImage.size(header_image.path)
+        if size.nil?
+          UI.user_error!("Unable to read app clip header image file: #{header_image.path}")
+        end
+        size = size.join('x')
+        unless size.eql?("1800x1200")
+          UI.user_error!("App clip header images must be exactly 1800x1200 in size. Offending image has size #{size}: '#{header_image.path}'")
+        end
+      end
+
+      # validate there is only one header image per language
+      # Filter out nil languages (e.g., from default folder) before validation
+      app_clip_header_images.map(&:language).compact.each do |language|
+        if app_clip_header_images.find_all { |header_image| header_image.language.eql?(language) }.length > 1
+          UI.user_error!("There can only be one app clip header image per language. The language #{language} has more than one image.")
+        end
+      end
+
+      app_clip_header_images
+    end
+
     # Returns the list of language folders
     #
     # @param roort [String] A directory path to get the list of language folders

data/deliver/lib/deliver/options.rb

@@ -127,6 +127,14 @@ module Deliver
                                      env_name: "DELIVER_SCREENSHOTS_PATH",
                                      description: "Path to the folder containing the screenshots",
                                      optional: true),
+        FastlaneCore::ConfigItem.new(key: :app_clip_header_images_path,
+                                     env_name: "DELIVER_APP_CLIP_HEADER_IMAGES_PATH",
+                                     description: "Path to the folder containing the app clip header images",
+                                     optional: true),
+        FastlaneCore::ConfigItem.new(key: :app_clip_default_experience_metadata_path,
+                                     env_name: "DELIVER_APP_CLIP_DEFAULT_EXPERIENCE_METADATA_PATH",
+                                     description: "Path to the folder containing the app clip default experience metadata",
+                                     optional: true),
 
         # app previews (videos)
         FastlaneCore::ConfigItem.new(key: :app_previews_path,
@@ -404,6 +412,10 @@ module Deliver
                                      description: "Metadata: A hash containing the review information",
                                      optional: true,
                                      type: Hash),
+        FastlaneCore::ConfigItem.new(key: :app_clip_review_information,
+                                     description: "Metadata: A hash containing the app clip review information",
+                                     optional: true,
+                                     type: Hash),
         FastlaneCore::ConfigItem.new(key: :app_review_attachment_file,
                                      env_name: "DELIVER_APP_REVIEW_ATTACHMENT_FILE",
                                      description: "Metadata: Path to the app review attachment file",
@@ -484,6 +496,17 @@ module Deliver
                                      optional: true,
                                      default_value: true),
 
+        # app clip default experience
+        FastlaneCore::ConfigItem.new(key: :app_clip_default_experience_subtitle,
+                                     env_name: "DELIVER_APP_CLIP_DEFAULT_EXPERIENCE_SUBTITLE",
+                                     description: "The localized subtitle for the default app clip experience",
+                                     optional: true,
+                                     type: Hash),
+        FastlaneCore::ConfigItem.new(key: :app_clip_default_experience_action,
+                                     env_name: "DELIVER_APP_CLIP_DEFAULT_EXPERIENCE_ACTION",
+                                     description: "Action for the default app clip experience (OPEN, VIEW, PLAY)",
+                                     optional: true),
+
         # internal
         FastlaneCore::ConfigItem.new(key: :app,
                                      short_option: "-p",

data/deliver/lib/deliver/runner.rb

@@ -9,6 +9,8 @@ require_relative 'html_generator'
 require_relative 'submit_for_review'
 require_relative 'upload_price_tier'
 require_relative 'upload_metadata'
+require_relative 'upload_app_clip_default_experience_metadata'
+require_relative 'upload_app_clip_default_experience_header_images'
 require_relative 'upload_screenshots'
 require_relative 'sync_screenshots'
 require_relative 'sync_app_previews'
@@ -136,6 +138,12 @@ module Deliver
 
     # Upload all metadata, screenshots, pricing information, etc. to App Store Connect
     def upload_metadata
+      # App clip experience metadata upload must happen before the upload metadata step. The app
+      # clip app store review detail upload depends on there being a valid app clip default
+      # experience on the edit version.
+      UploadAppClipDefaultExperienceMetadata.new.upload_metadata(options)
+      UploadAppClipDefaultExperienceHeaderImages.new.find_and_upload(options)
+
       upload_metadata = UploadMetadata.new(options)
       upload_screenshots = UploadScreenshots.new