NEW: My new book Pro SwiftUI is out now – level up your SwiftUI skills today! >>

How to continue an NSUserActivity in SwiftUI

Paul Hudson    @twostraws   

Updated for Xcode 14.2

SwiftUI has a dedicated onContinueUserActivity() modifier that can catch a variety of NSUserActivity types – clicks from the web, launches from Spotlight or Siri, and more. Previously you might have handled this in your AppDelegate using something like application(_:continue:restorationHandler:), but SwiftUI’s approach is more fine-grained and lets us divide functionality more easily.

To implement this, first create a function that will accept an NSUserActivity. You don’t need to do this inside your App struct, but it would make sense to do so because you can then route it wherever you need in the rest of your program.

For example, this function checks to see whether we’re being passed in data from Spotlight, and if so pulls out the unique identifier so you can look it up in your data source:

func handleSpotlight(_ userActivity: NSUserActivity) {
    if let id = userActivity.userInfo?[CSSearchableItemActivityIdentifier] as? String {
        print("Found identifier \(id)")

Note: That doesn’t need to check the activityType property, because it will be filtered by SwiftUI in our next code.

Now you can attach that to your main app’s view by modifying your App struct like this:

WindowGroup {
        .onContinueUserActivity(CSSearchableItemActionType, perform: handleSpotlight)

Of course, that’s just the bare bones of handling a user activity – you’ve detected the activity and your code has been run, but now you need to do the actual work of responding to the event somehow.

If you’re not sure where to start, you should probably make your handleSpotlight() set some shared state in your program that drives your UI, for example causing a detail view to present.

Hacking with Swift is sponsored by Play

SPONSORED Play is the first native iOS design tool created for designers and engineers. You can install Play for iOS and iPad today and sign up to check out the Beta of our macOS app with SwiftUI code export. We're also hiring engineers!

Click to learn more about Play!

Sponsor Hacking with Swift and reach the world's largest Swift community!

Similar solutions…

Buy Pro Swift Buy Pro SwiftUI Buy Swift Design Patterns Buy Testing Swift Buy Hacking with iOS Buy Swift Coding Challenges Buy Swift on Sundays Volume One Buy Server-Side Swift Buy Advanced iOS Volume One Buy Advanced iOS Volume Two Buy Advanced iOS Volume Three Buy Hacking with watchOS Buy Hacking with tvOS Buy Hacking with macOS Buy Dive Into SpriteKit Buy Swift in Sixty Seconds Buy Objective-C for Swift Developers Buy Beyond Code

Was this page useful? Let us know!

Average rating: 3.9/5

Unknown user

You are not logged in

Log in or create account

Link copied to your pasteboard.