uniappiOS平台通用链接

### 关于 UniApp 在 iOS 平台实现通用链接的方法 在 UniApp 中，为了使应用程序能够通过通用链接（Universal Links）被唤起并跳转到特定页面，需要完成一系列配置工作。以下是具体方法： #### 1. 开启 Associated Domains 服务 在 Xcode 的项目设置中，需启用 **Associated Domains** 功能，并添加对应的域名支持[^1]。此操作允许应用与指定的网站建立关联关系。 - 打开项目的 `Capabilities` 面板。 - 启用 **Associated Domains**。 - 添加条目，格式为 `applinks:<your-domain>`，例如：`applinks:example.com`。 #### 2. 创建 Apple App Site Association 文件 服务器端需要提供一个名为 `apple-app-site-association` 的 JSON 文件，用于声明哪些 URL 路径可以通过通用链接访问。 文件内容示例： ```json { "applinks": { "apps": [], "details": [ { "appID": "TeamID.BundleID", "paths": ["/path/to/resource", "/another/path/*"] } ] } } ``` 该文件应放置在域根目录下或 `.well-known` 子路径中，确保可通过 HTTPS 访问。 #### 3. 修改 UniApp 应用逻辑以处理通用链接 当用户点击某个通用链接时，iOS 系统会调用应用中的相应事件回调函数来接收参数[^2]。开发者可以在 UniApp 的生命周期钩子中捕获这些数据。 对于 HBuilderX 构建的应用程序，在入口文件（通常是 `main.js` 或类似的初始化脚本）中监听 `onHandleIntent` 和其他可能触发的方式： ```javascript // 处理打开方式 plus.runtime.onNewIntent(function(intent){ console.log('收到新意图:', intent); let url = plus.runtime.getLaunchURL(); // 获取启动URL if(url && url.startsWith("http")){ handleDeepLink(url); // 自定义解析深层链接逻辑 } }); function handleDeepLink(linkUrl){ // 解析传入的url地址, 进行路由导航或其他业务处理... uni.navigateTo({ url: '/pages/targetPage/targetPage?url=' + encodeURIComponent(linkUrl) }); } ``` 上述代码片段展示了如何捕捉来自外部源的请求以及进一步的操作流程。 #### 注意事项 - 确保 SSL/TLS 安全证书有效无误。 - 测试阶段建议利用苹果官方工具验证 AASA 文件是否正确部署。