UniApp 打包配置 iOS的UniversalLinks

环境:Nginx+Laraval+uniapp

1、在苹果开发者中心:开启Associated Domains服务

如图

2、apple-app-site-association 配置并部署文件

bash 复制代码
{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "xx.com.test.www",//appID 由"Team ID.Bundle ID"组成
                "paths": ["/mingchucs/*"]
            },{
                "appID": "xx.com.tests.www",
                "paths": ["/mingchu/*"]
            }
        ]
    }
}

上传到服务,目录如下:

3、手动在manifest.json中配置Associated Domains(域名)

打开项目的 manifest.json,在对应位置填写你的域名:

路径 :App 模块配置 → iOS → 关联域

配置格式 :applinks:你的域名(不含 https://,例如 applinks:www.example.com)

如果需要直接在源码视图配置,找到 "app-plus" → "distribute" → "ios" → "capabilities" → "entitlements",添加以下内容

bash 复制代码
"capabilities": {
    "entitlements": {
        "com.apple.developer.associated-domains": [
            "applinks:www.yourdomain.com"
        ]
    }
}

注:用云服务打包,用传统模式,这是用来代替"Xcode中开启Associated Domains能力,并添加applinks:你的域名"这一步

4、验证文件生效

bash 复制代码
https://app-site-association.cdn-apple.com/a/v1/你的域名
//示例
https://app-site-association.cdn-apple.com/a/v1/www.test.com

返回内容如图:

5、 Laraval配置路由

编辑路由文件 routes/web.php,添加以下路由规则:

bash 复制代码
<?php

use Illuminate\Support\Facades\Route;

// 为 Universal Link 添加路由,返回一个空响应或简单视图,确保状态码为 200
Route::get('/mingchucs', function () {
    // 返回空内容即可,Universal Link 只需要一个有效的 HTTP 200 响应
    return response('', 200);
});

Route::get('/mingchucs/{any}', function () {
    return response('', 200);
})->where('any', '.*');

Route::get('/mingchu', function () {
    return response('', 200);
});

Route::get('/mingchu/{any}', function () {
    return response('', 200);
})->where('any', '.*');

更简洁的写法(使用路由参数):

php 复制代码
// 匹配 /mingchucs 以及 /mingchucs/任意路径
Route::get('/mingchucs/{path?}', function () {
    return response('', 200);
})->where('path', '.*');

Route::get('/mingchu/{path?}', function () {
    return response('', 200);
})->where('path', '.*');

确保路由生效:

运行 php artisan route:clear 清除路由缓存。

再次访问 https://你的域名/mingchucs,应该不再返回错误,而是一个空白页面(HTTP 200)。

6、验证IOS的 Universal Link打开应用

将ios包安装到苹果手机上,使用 Safari 浏览器 访问 https://你的fakq/mingchucs,长按地址栏的链接,看菜单中是否有"在"您的App名称"中打开"的选项。

如图:

点击"打开"就可以直接打开应用了

相关推荐
wuxianda103018 小时前
uniapp 与跨端打包项目:壳子和框架层默认特征,相似是从哪里来的
uni-app
码间留白18 小时前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
wuxianda103019 小时前
苹果 App 上架 4.3(a) 问题解决方案(适用 uniapp、Objective-C、Swift、Flutter 等项目)
uni-app·objective-c·swift
码间留白2 天前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
anyup3 天前
自带 uni-app x 页面级能力,uView Pro X 8 个开箱即用的工具函数
前端·vue.js·uni-app
码间留白8 天前
六轮真机实验后,我把鸿蒙直播推流的 UI 全逼成了原生——uni-app 适配 HarmonyOS NEXT 完整复盘
uni-app·鸿蒙·harmonyos next·直播推流·arkts/arkui
wuxianda10309 天前
2026 苹果审核 4.3 (a) 被拒全解析|Guideline 4.3a spam 马甲包拒审原因 + 避坑方案
flutter·uni-app·苹果上架
头发还在的女程序员11 天前
基于 Spring Boot + Vue 3 + uni-app 的灵活用工系统:四端架构与业务流程设计
vue.js·spring boot·uni-app·灵活用工·灵工系统
Dumbness13 天前
订阅消息弹窗必须在用户点击里调:联调实验室里 timing 和 Mock 支付通知踩的坑
javascript·uni-app
码间留白14 天前
uni-app 鸿蒙离线打包:一个改动从源码到真机要穿过几条链
uni-app·鸿蒙·deveco·离线打包·uts插件