网页端JavaScript调用Android通讯录DeepLink失效问题排查

问题描述 #

我想在网页里实现点击按钮一键跳转至通讯录应用，查看并保存联系人的功能。这是我第一次用DeepLink，调用Android通讯录的示例都没生效，但直接调用号码（比如36454873）是正常的。请问我哪里错了？有没有办法携带信息唤起通讯录应用？感谢帮助。

现有代码 #

function getMobileOperatingSystem() {
   var userAgent = navigator.userAgent || navigator.vendor || window.opera;
   if (userAgent.match(/iPad/i) || userAgent.match(/iPhone/i) || userAgent.match(/iPod/i)) {
      return 'iOS';
   }
   else if (userAgent.match(/Android/i)) {
      return 'Android';
   }
   else {
      return 'unknown';
   }
}

function onLoad() {
   switch (getMobileOperatingSystem()) {
      case 'Android':
         console.log("Android");
         alert("android");
         window.location.href = "intent://contacts/#Intent;action=android.intent.action.VIEW;type=vnd.android.cursor.dir/person;end";
         break;
      case 'iOS':
         console.log("iOS");
         alert("ios");
         // ios is handled. Only android not working
         break;
      default:
         console.log("unknown");
         break;
   }
}
window.onload = onLoad;

问题分析与解决办法 #

1. MIME类型错误 #

你当前使用的vnd.android.cursor.dir/person是旧版MIME类型，Android系统标准的通讯录列表MIME类型为vnd.android.cursor.dir/contact，修改后即可正常唤起通讯录列表：

window.location.href = "intent://contacts/#Intent;action=android.intent.action.VIEW;type=vnd.android.cursor.dir/contact;end";

2. 增加包名避免应用歧义 #

部分设备存在多个通讯录类应用，添加package=com.android.contacts可强制唤起系统默认通讯录，防止被其他应用拦截：

window.location.href = "intent://contacts/#Intent;action=android.intent.action.VIEW;type=vnd.android.cursor.dir/contact;package=com.android.contacts;end";

3. 携带信息创建联系人 #

若要直接打开新建联系人页面并填充信息，改用android.intent.action.INSERT动作，通过extra参数传递联系人信息：

// 示例：填充姓名和手机号
window.location.href = "intent://contacts/#Intent;action=android.intent.action.INSERT;type=vnd.android.cursor.dir/person;extra.name=张三;extra.phone=13800138000;end";

4. 兼容性容错处理 #

不同Android厂商的通讯录对Intent支持有差异，建议添加跳转失败检测逻辑：

case 'Android':
   console.log("Android");
   alert("android");
   const startTime = Date.now();
   window.location.href = "intent://contacts/#Intent;action=android.intent.action.VIEW;type=vnd.android.cursor.dir/contact;package=com.android.contacts;end";
   setTimeout(() => {
      if (Date.now() - startTime < 1000) {
         alert("无法唤起通讯录，请手动打开");
      }
   }, 300);
   break;

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