iOS Swift：实现导航时返回应用的自定义状态栏按钮

要做谷歌地图、Waze那种退出应用后能快速切回导航的功能，得结合iOS的通知系统、实时活动框架，再适配UIKit和SwiftUI的混合场景，具体步骤如下：

一、先搞定后台保活基础 #

导航启动时必须申请后台任务，避免应用一退后台就被系统挂掉，没法显示入口：

var bgTaskID: UIBackgroundTaskIdentifier = .invalid

func startMapboxNavigation() {
    // 启动你的Mapbox导航逻辑...
    
    // 申请后台任务续命
    bgTaskID = UIApplication.shared.beginBackgroundTask(withName: "NavBackground") { [weak self] in
        UIApplication.shared.endBackgroundTask(self?.bgTaskID ?? .invalid)
        self?.bgTaskID = .invalid
    }
    
    // 即刻显示入口（或者调用延迟显示的方法）
    showBackgroundNavIndicator()
}

二、状态栏蓝色按钮（iOS 15及以下） #

用自定义本地通知做常驻状态栏入口，点击直接切回导航：

1. 先配置通知分类和动作：

func setupNavNotificationCategory() {
    let returnAction = UNNotificationAction(identifier: "BackToNav", title: "返回导航", options: .foreground)
    let navCategory = UNNotificationCategory(identifier: "NavCategory", actions: [returnAction], intentIdentifiers: [], options: [])
    UNUserNotificationCenter.current().setNotificationCategories([navCategory])
}

2. 触发后台通知：

func showBackgroundNavIndicator() {
    let content = UNMutableNotificationContent()
    content.title = "导航中"
    content.body = "点击回到导航界面"
    content.categoryIdentifier = "NavCategory"
    content.sound = .none // 避免打扰用户
    
    let request = UNNotificationRequest(identifier: "NavBackgroundNotify", content: content, trigger: nil)
    UNUserNotificationCenter.current().add(request)
}

3. 处理点击跳转：
   不管是UIKit的AppDelegate还是SwiftUI的UNUserNotificationCenterDelegate实现，都要加这段逻辑：

func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
    if response.actionIdentifier == "BackToNav" {
        // 跳转到导航界面：SwiftUI用UIHostingController，UIKit直接切根VC或push
        if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene {
            let navView = YourNavigationSwiftUIView() // 你的SwiftUI导航视图
            windowScene.windows.first?.rootViewController = UIHostingController(rootView: navView)
        }
    }
    completionHandler()
}

三、动态岛适配（iOS 16+） #

用ActivityKit做实时活动，动态岛就能显示导航状态和入口：

1. 定义活动属性：

import ActivityKit

struct NavActivityAttrs: ActivityAttributes {
    struct ContentState: Codable, Hashable {
        var remainingDist: String // 可选：显示剩余距离，增强体验
    }
    
    let destName: String
}

2. 启动导航时开启实时活动：

func startNavActivity(dest: String) {
    let attrs = NavActivityAttrs(destName: dest)
    let state = NavActivityAttrs.ContentState(remainingDist: "3.1公里")
    
    do {
        _ = try Activity<NavActivityAttrs>.request(attributes: attrs, contentState: state, pushType: nil)
    } catch {
        print("启动动态岛活动失败：\(error)")
    }
}

3. 动态岛点击后，系统会自动唤醒应用，你只要在启动逻辑里判断是从动态岛过来的，直接切到导航界面就行。

四、延迟显示逻辑（数秒后出现） #

如果要等几秒再显示入口，用DispatchQueue延迟触发：

func showDelayedNavIndicator() {
    DispatchQueue.main.asyncAfter(deadline: .now() + 5) { // 5秒延迟
        showBackgroundNavIndicator()
        startNavActivity(dest: "你的目的地") // 同时启动动态岛活动
    }
}

五、混合开发注意事项 #

• SwiftUI里调用UIKit的API（比如UIApplication.shared），直接用就行，或者通过UIViewControllerRepresentable桥接；
• Info.plist必须加UIBackgroundModes，包含location和remote-notification，还要申请始终允许的位置权限，不然后台导航和通知都用不了；
• 导航结束时记得取消通知和后台任务，避免资源浪费：

func stopNavigation() {
    // 停止Mapbox导航...
    
    UNUserNotificationCenter.current().removePendingNotificationRequests(withIdentifiers: ["NavBackgroundNotify"])
    UNUserNotificationCenter.current().removeDeliveredNotifications(withIdentifiers: ["NavBackgroundNotify"])
    
    if bgTaskID != .invalid {
        UIApplication.shared.endBackgroundTask(bgTaskID)
        bgTaskID = .invalid
    }
    
    // 结束动态岛实时活动
    Task {
        for activity in Activity<NavActivityAttrs>.activities {
            await activity.end(dismissalPolicy: .immediate)
        }
    }
}

内容的提问来源于stack exchange，提问作者KNBRGR