How to open specific View in SwiftUI app using AppIntents

From Apple's Accelerating app interactions with App Intents sample code, the right way to do this appears to be through the use of dependencies, namele the @Dependency property wrapper and the AppDependencyManager class:

The implementation for NavigationModel looks like this:

/// An observable object that manages the selection events for `NavigationSplitView`.
@MainActor
@Observable class NavigationModel {

    /// The selected item in `SidebarColumn`.
    var selectedCollection: TrailCollection?
    
    /// The selected item in the `NavigationSplitView` content view.
    var selectedTrail: Trail?
    
    /// The column visibility in the `NavigationSplitView`.
    var columnVisibility: NavigationSplitViewVisibility
    
    /// The visibility of a sheet when an activity is active.
    var displayInProgressActivityInfo = false
    
    init(selectedCollection: TrailCollection? = nil, columnVisibility: NavigationSplitViewVisibility = .all) {
        self.selectedCollection = selectedCollection
        self.columnVisibility = columnVisibility
    }
}

The navigation model uses TrailCollection objects. I won't put their implementation here because it's not very relevant and I don't want to have an answer with so much code.

Then you register the dependency in your App's init() method:

struct AppIntentsSampleApp: App {
    init() {
        // ...
        let trailDataManager = TrailDataManager.shared
        trailManager = trailDataManager
        
        let navigationModel = NavigationModel(selectedCollection: trailDataManager.nearMeCollection)
        sceneNavigationModel = navigationModel
        // ...
        AppDependencyManager.shared.add(dependency: navigationModel)
        // ,,,
    }
}

The sample app provides a OpenFavorites intent. This is where you register your dependency:

struct OpenFavorites: AppIntent {
    // ...
    @Dependency
    private var navigationModel: NavigationModel
    // ...
    // We also need the trailManager
    @Dependency
    private var trailManager: TrailDataManager
}

And then you can simply mutate this navigation model:

struct OpenFavorites: AppIntent {
    @MainActor
    func perform() async throws -> some IntentResult {
        navigationModel.selectedCollection = trailManager.favoritesCollection
    return .result()
    }
}

So based on your NavigationType object, you have the right idea. You just need to turn it into a dependency with the aforementioned APIs and you will have this done (possibly) the Apple way.

I have my reservations about this approach (what if you have a multi-window app where each Window keeps track of its own navigation hierarchy?), but it appears to be the best approach so far.

You need to use onOpenURL to change the selected tab, e.g.

.onOpenURL { url in 
    // check if the url is for the gallery
    selected = Tabs.gallery
}

Then you need an intent that hands a URL back to the Shortcuts app for it to open, e.g.

struct OpenGallery: AppIntent {
    
    static var title: LocalizedStringResource = "Open Gallery"

    static var description = IntentDescription("Opens the app and goes to the gallery.")
    
    
    @MainActor
    func perform() async throws -> some OpensIntent {
        return .result(opensIntent: OpenURLIntent(URL(string: "myapp:gallery")!))
    }
}

Here is some help with the URL scheme: https://developer.apple.com/documentation/xcode/defining-a-custom-url-scheme-for-your-app

Here is how you open your app deeplink/universal link from an Widget AppIntent on iOS 17 and newer:

WidgetIntent.swift

import AppIntents
import SwiftUI

struct WidgetIntent: AppIntent {
    static var title: LocalizedStringResource = "Dummy Title" // required
    static var description: IntentDescription = IntentDescription("Dummy Description", categoryName: "Navigation") // optional
    static var openAppWhenRun: Bool = true // required
    static var isDiscoverable: Bool = false // optional, if you want to hide this from the Shortcuts app, Spotlight, etc
    
    @Parameter(title: "Screen ID") // optional
    var screenId: Int // optional, only works when @Parameter exists
    
    init() {}
    
    // required only if you added a parameter before
    init(screenId: Int) {
        self.screenId = episodeId
    }
    
    func perform() async throws -> some IntentResult {
        let deepLinkURL = URL(string: "myApp://?screenId=\(screenId)")!
        await EnvironmentValues().openURL(deepLinkURL)
        return .result()
    }
}

⚠️ It’s required to have WidgetIntent as a member in both the app's target and the widget target.

Of course, make sure you added the myApp URL Type (URL Scheme) in Project Info.plist. Here is how.