本地测试自定义URL Scheme唤起不了App，只有官方hbuilder://能唤起App

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

你遇到的问题是：本地测试时自定义 URL Scheme 无法唤起 App，只有官方的 hbuilder:// 可以。

根据知识库中的说明，HBuilderX 自带的标准真机运行基座（即标准基座）固定使用 hbuilder:// 作为 URL Scheme，这是为了方便调试而设定的，无法通过修改 manifest.json 来改变这个行为。

✅ 正确做法如下：

如果你想测试自定义的 URL Scheme（比如 myapp://），必须使用“自定义运行基座”，并在 manifest.json 中正确配置 URL Scheme。

✅ 操作步骤（基于知识库）：

1. 配置 URL Scheme
   在 manifest.json 中配置你的自定义 scheme：

   • 可视化界面：
     打开 manifest.json → “App常用其它设置” → “iOS设置” → “UrlSchemes”
     填写如：myapp

   • 源码视图（uni-app 项目）：

     "app-plus": {  
     "distribute": {  
      "ios": {  
        "urltypes": "myapp"  
      }  
     }  
     }  

2. 制作自定义运行基座
   在 HBuilderX 中：

   • 菜单栏选择【运行】→【运行到手机或模拟器】→【制作自定义运行基座】
   • 勾选你需要的模块（如 maps、支付等）
   • 云打包生成自定义基座

3. 使用自定义基座运行

   • 安装刚刚生成的自定义基座到真机
   • 使用 Safari 或系统浏览器访问：myapp://test
   • 系统会提示是否打开 App，点击确认即可唤起

⚠️ 注意事项

• 标准基座无法测试自定义 scheme，必须使用自定义基座。
• 每次修改 manifest.json 后，必须重新制作自定义基座。
• 如果你使用的是鸿蒙平台，URL Scheme 配置方式不同，请参考 鸿蒙 URL Scheme 配置文档。

✅ 总结

如你仍有问题，建议确认是否使用了“自定义运行基座”，并重新打包测试。