Cordova应用中Framework7在iOS平台菜单链接失效问题求助

排查及修复步骤 #

1. 修正路由配置的大小写错误 #

routes.js中第一个路由的属性名写成了大写Url，Framework7路由配置要求属性名为小写url，iOS平台对大小写更敏感，这会直接导致路由匹配失败：

// 错误写法
{
  path: '/',
  Url: './index.html',
}

// 正确写法
{
  path: '/',
  url: './index.html',
}

2. 补充缺失的路由规则 #

菜单链接href="/my-ads/"在现有路由配置中没有对应条目，这是链接无法跳转的直接原因，需添加匹配的路由：

var routes = [
  // ... 现有路由
  {
    path: '/my-ads/',
    url: './my-ads.html',
  },
  // ... 其他路由
];

3. 调整视图初始化配置 #

Cordova iOS的文件路径逻辑和浏览器有差异，初始化mainView时无需重复指定url（根路由已指向index.html），避免冲突：

// 原代码
var mainView = app.views.create('.view-main', {
    url: './index.html'
});

// 修改后
var mainView = app.views.create('.view-main');

4. 检查Cordova iOS安全配置 #

在config.xml中确认允许内部导航，确保页面能正常跳转：

<allow-navigation href="file:///*" />
<allow-intent href="file:///*" />

5. 验证页面文件路径 #

确保所有页面文件（如my-ads.html）存在于项目对应目录，文件名、路径的大小写和路由配置完全一致，iOS平台对路径拼写要求严格。

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