fastlane: Deliver error for App containing an App Clip

I have a wip branch on my fork here. My goal is to add app clips default experience functionality. This not only fixes this error, but allows specifying app clip metadata (similar to how uploading normal app metadata works today).

It contains enough functionality for app clips to allow the following:

• specify default experience action (PLAY, VIEW, …)
• specify localized subtitle
• specify localized default experience header image

I will create a PR and comment here once it passes integration with my own projects.

If anyone wants to use it before I finish the implementation, point your Gemfile towards my repo https://github.com/qatonda/fastlane (matt/app-clips branch) and reference the following example code:

EDIT: Use the instructions in the PR #20300 to use/test until it’s merged.

deliver(
  ...
  app_clip_default_experience_action: "PLAY",
  app_clip_default_experience_subtitle: {
    "en-US": "this is a test from fastlane",
    "es-MX": "está es una prueba de fastlane"
  },
  app_clip_header_images_path: './fastlane/app-clip-header-images'
)

and for the header images:

$ tree app-clip-header-images/
app-clip-header-images
├── en-US
│   └── random-header-image.jpg
└── es-MX
    └── another-header-image.jpg

2 directories, 2 files

@gsavit I’ll consider adding a deliver option like use_previous_version_app_clip_metadata that uses the previous version’s app clip metadata (or uses the templating option) and copies to it to the new version. Does that seem more useful than being able to specify metadata via fastlane?

I’ve created a PR to add App Clips support to spaceship. https://github.com/fastlane/fastlane/pull/19043

You’re right to flag the distinction between the cases. The screenshots overwrite flag is necessary because otherwise it’s an additive operation, right (new screenshots uploaded will just join the preexisting ones)? Whereas App Clip metadata will always be overwritten/replaced by any new data passed. So the fix needed for App Clips is just correct handling of the default case, when no App Clip metadata is explicitly passed.

Yep, I agree! I’ll include with my implementation the default case where there is an app clip, but no app clip metadata specified with deliver.

There seems to be a new error now.

Instead of getting an error with appClipVersion it’s now You must provide a value for the relationship 'appClipDefaultExperience' with this request

@blesson3 I’ve added your changes to our release script, which will run in about ~16h. Will report back if everything worked out.

I’m going to add this on my list this/next week to figure out! I have never made an app clip before so I will have to get a project created with that inside of it first 😇

Just a quick heads up: I’ve been unable to test these changes further, because ASC had trouble the last couple times processing the screenshots, therefore the deliver job would always fail. I’ll report back as soon as that works for us again.

@blesson3 I’ve added your changes to our release script, which will run in about ~16h. Will report back if everything worked out.

@EmDee If you’ve not already done so, use the matt/app-clips-default-experience branch and if you’re already using it run bundle update fastlane to get the latest changes for the branch. I realized that if I force push to a branch, the bundle install with a Gemfile with an old ref pegged will fail the CI with the following error:

Revision 2fac95213b9eabcc395ba66be8c419f987d2c87d does not exist in the repository https://github.com/qatonda/fastlane.git. Maybe you misspelled it?

Pretty sure your setup from earlier will fail with the same error unless updated. I likely won’t force push again today, so it should be safe-ish for your release tonight.

I’ve created a WIP PR https://github.com/fastlane/fastlane/pull/20300 for automating app clips default experience metadata. Please test using this PR instead of matt/app-clips on my forked repo. Direct any issues with those changes to the PR.

I’m in the process of implementing additional app clips related functionality on matt/app-clips, which I’ll use as the nightly-version of my changes.

@fastlane-bot not fixed.

@EmDee There is not at the moment but I will see what we can do for adding that 😊

Awesome! Thanks for all your amazing work here!

@EmDee There is not at the moment but I will see what we can do for adding that 😊