Casey LissWhat API controls these quick links?
Brandon Horst@caseyliss AppShortcuts!
Matt Corey@brandonhorst @caseyliss I don't know - my app uses AppShortcuts, but it doesn't look like Amazon’s. When looking at this view, it seems like they have a single 'Open Amazon' OpenIntent, with different parameters applied, and somehow stylized.
Matthew Cassinelli@matt1corey @brandonhorst @caseyliss It is App Shortcuts, and they've taken the Open action & made parameterized instances of it with App Shortcuts.
This is a combination of parameterized phrases from the first year of App Shortcuts & the Spotlight integration from the second year.
Here's where they start to talk about it: https://developer.apple.com/wwdc22/10170?time=851 Then the rest is in Brandon's linked video.
You can also use Suggested Entities to show nicely-designed entities in Spotlight as well
@matthewcassinelli @matt1corey @brandonhorst Granted I've only been looking at this for ten minutes, but I'm having trouble figuring out how to write an Intent that basically just deep-links into the app…? I just watched that section of the video — thank you! — but I don't think I'm grokking how to just open the app.
@matthewcassinelli @matt1corey @brandonhorst Oh wait it looks like maybe this is what I want, for iOS 18 anyway
https://developer.apple.com/documentation/appintents/openurlintent
@brandonhorst @matthewcassinelli @matt1corey Although that looks like it requires a web endpoint, which Callsheet doesn't have 😩
@caseyliss @brandonhorst @matt1corey This part of another of the latest videos walks though the basics of an Open Intent, but I'm assuming it's not what you want because you're trying to make a quicker version using the URL scheme instead, right? https://developer.apple.com/wwdc24/10210?time=592
@matthewcassinelli @brandonhorst @matt1corey For some cases, this may work as well. But annoyingly, most of what I want to do with Intents is already defined as custom callsheet:// URLs, yeah.
@caseyliss @matthewcassinelli @brandonhorst For most of my OpenIntents, I have the deep link logic directly in the Intent code - this is an example of an OpenIntent that opens a Ledger in Bills to Budget, and navigates to a specified screen, but it can also be done with an AppIntent that has ‘openAppWhenRun' set to true.
It is a parameterized AppIntent -- it still doesn't look anything like the fancy Amazon shortcut, though
@matt1corey @caseyliss @brandonhorst Did you apply the newer bits from the Spotlight video? That's separate from parameterization.
@matthewcassinelli @caseyliss @brandonhorst Got it! At least for one of my intents. Here's what I had to change:
- My AppEnum needed to define the DisplayRespresentation with both the name and symbol name, instead of just the name (see screenshot)
- My OpenIntent needed to have this parameter defined as the `target`
I don't think AppShortcuts comes into play here, although I could be wrong, as I do have an AppShortcut defined for this intent (but I always have)
@matthewcassinelli @caseyliss @brandonhorst Nope, it _also_ needs to be an AppShortcut - my 'Open Account' Intent satisfied all of that already, but didn't have an AppShortcut assigned. Adding that caused it to render each option explicitly in the Shortcuts app.
But... um... Each intent is showing the options for _both_!? Wow, that's a wild bug…
Michael Gorbach@matt1corey @matthewcassinelli @caseyliss @brandonhorst thanks for filing! Do you have this reproducing in a sample you can share? That would allow us to triage it quickly.
@mgorbach @matthewcassinelli @caseyliss @brandonhorst Not yet (last minute rush), but I’ll see what I can put together
@matt1corey @matthewcassinelli @caseyliss @brandonhorst thank you! It would be much appreciated if you can. We tried to repo but are not seeing this issue. A link to a build with this failure happening would also help.