发生了什么

一线作业人员用手机上的作业 App 在现场处理点位上的事,页面里有“导航”和“拨号”两个入口:点导航,期望直接拉起地图 App 指到要去的位置;点拨号,期望系统直接呼出。App 自己不做地图也不做通话,这两个按钮只是把目的地和号码交给系统,由系统拉起手机里已安装的地图 App 或电话 App。这套写法从 App 早期版本就有,多年没有动过。

正常时,点导航后地图 App 弹出来并指向目的地,点拨号后系统直接呼出,用户不需要退出 App 自己输入地址或号码。

4 月中旬,基础平台把开发工具链和系统 SDK 升级到新版本,App 用新版本重新打包发布。升级之后,iOS 18 及以上的手机再点这两个按钮没有任何反应:地图没弹出来,电话也没呼出,导航和拨号整套不能用。同一份 App 在低版本系统上仍然正常。4 月 14 日上午一线把问题报上来,修复版本重新发布后,导航和拨号恢复使用。

本质

这两个功能依赖的不是 App 自己的代码,而是系统和另一个 App 配合完成的一次“打开”动作,App 只负责把链接发出去。

  1. App 里留着的仍是早期的调用方式。这个接口在新版 SDK 里早已被标为废弃,但当年只是编译时的一条告警,包照样能编出来、能跑,所以这处调用一直没有迁移。
  2. 这次升级换到新 SDK 后,该接口从“只告警的废弃”变成“正式禁用”。编译阶段依然通过,问题只在运行时出现。
  3. 新打出的包运行在 iOS 18 及以上系统时,系统不再接受这次调用,链接没有被打开,地图 App 和电话 App 都没有被拉起。低版本系统上同一处调用仍按老规矩生效,所以只有一部分用户出问题。
  4. 代码只发出打开动作就结束,没有检查是否真的打开成功,也没有准备第二条路;这一趟失败就没有下文,表现出来就是按钮点了没反应。

这里有个很容易被跳过的判断:编译通过不等于调用可用。废弃接口从只会告警变成被禁用,变化发生在运行时,构建日志里看不出来。只有新系统受影响、老系统正常,正是接口随系统版本变化的典型特征,而不是数据、网络或权限问题。

修复是重新发布了一版,导航和拨号随之恢复;具体改动没有更细的材料,按这类接口被禁用的情形,处理方式是把历史调用换成新 SDK 提供的方式,并让打不开时能给出提示。下面按这个思路给最小示意。

错误代码

// 示意:导航与拨号共用同一个打开动作
enum ExternalJump {

    static func navigate(to place: Point) {
        // 为什么错:这里调用的是早期 SDK 的打开接口,
        // 新 SDK 已把它标记为禁用,但编译只留一条告警,
        // 历史代码因此一直没人改
        UIApplication.shared.openURL(place.mapLink)
        // 也没有判断是否真的打开成功,失败时页面不会给出任何提示
    }

    static func call(phone: String) {
        UIApplication.shared.openURL(telLink(for: phone))   // 为什么错:同导航,拨号一样失效
    }

    private static func telLink(for phone: String) -> URL {
        URL(string: "tel:\(phone)")!
    }
}

修复代码示例

// 示意:换成当前 SDK 的打开方式,并处理打不开的情况
enum ExternalJump {

    static func navigate(to place: Point) {
        open(place.mapLink) { opened in
            if !opened {
                showTip("打不开地图,请手动前往")   // 失败给替代路径
            }
        }
    }

    static func call(phone: String) {
        open(telLink(for: phone)) { opened in
            if !opened {
                showTip("无法呼出,请手动拨打 \(phone)")
            }
        }
    }

    // 当前 SDK 的打开方式带完成回调,能拿到真实的打开结果
    private static func open(_ link: URL, done: @escaping (Bool) -> Void) {
        UIApplication.shared.open(link, options: [:]) { opened in done(opened) }
    }
}

两段代码是脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现,也未在真机运行。换接口之外,历史代码里同类调用要一并搜出来替换,否则换个按钮还会再遇到一次。

下次遇到这些场景要警惕

  • 升级构建工具链或系统 SDK 时:把编译输出里的废弃接口告警拉成清单,逐条确认是替换还是明确接受;再拿一台新系统真机走一遍导航、拨号、分享这类会跳到外部 App 的流程,看目标 App 是否真的被拉起。
  • 任何“交给系统或别的 App 打开”的动作:改用当前 SDK 的方式,并在回调里判断打开结果;打不开时给出替代路径,比如复制地址、显示号码、提示手输,不要让按钮点了没反应。
  • 只有部分用户报障、功能整块不可用:先按系统版本和机型分层,对比同一操作在新旧系统上的结果。新系统失效、老系统正常,通常指向系统接口或策略变化,而不是数据、网络或权限。
  • 发版前的回归清单:保留一条“历史遗留调用”检查,搜出代码里被废弃的方法名,确认它们在新 SDK 下仍然可用或已被替换;构建通过只说明编译能过,不说明运行可用。