manifest 文件

manifest.json 文件中包含了应用描述、接口声明、页面路由信息

manifest

config

用于定义系统配置和全局数据。

config.network

router

用于定义页面的组成和相关配置信息，如果页面没有配置路由信息，则在编译打包时跳过。

示例代码：

"router": {
  "entry": "Demo",
  "errorPage": "ErrorPage",
  "pages": {
    "Demo": {
      "component": "index"
    },
    "ErrorPage": {
      "component": "index"
     },
  }
}

router.pages

用于定义单个页面路由信息。

router.pages.filter

匹配页面某种请求，如请求 uri 和 filter 中 uri 匹配成功，则在匹配页面打开。

filter 匹配原则是按照 manifest.json 中 router.pages 中页面顺序自上往下逐一匹配，uri 匹配成功即会在该页面中使用，故不建议多页面采用相同 uri 匹配规则，可能会导致页面跳转出错。

filter 的结构如下：

"filter": {
  "<action>": {
    "uri": "<pattern>"
  }
}

可以处理所有 http 和 https 请求的 filter 定义如下：

"filter": {
  "view": {
    "uri": "https?://.*"
  }
}

router.errorPage 1060+

当页面跳转异常时，快应用默认将会跳转到 sdk 的默认错误页，同时前端 app.ux 也会收到 onPageNotFound 回调

此参数可提供给开发者配置自定义错误页面

参数：自定义错误页面的参数，需要提供一个在 pages 项里已经配置好的 key 值

注意：开发者自定义错误页面的时候，推荐在 script 标签加入以下这段代码。按照这样设置，当用户 deeplink 跳转进快应用报错时，点击返回键，可以跳到当前快应用的首页，继续浏览快应用的页面。

import router from '@system.router'
export default {
  onBackPress() {
    // 由deep-link等方式进来，异常发生时，一进来首页就是Error Page
    // 则此时返回需要手动修改，使其跳转到首页
    if (router.getLength() === 1) {
      router.replace({
        // 返回首页
        path: '/'
      })
      return true
    }
  }
}

display

用于定义与 UI 显示相关的配置。

subpackages 1040+

用于定义分包的相关配置。分包的详细使用方法参见分包加载。

示例：

{
  "package": "com.company.unit",
  "name": "appName",
  "icon": "/Common/icon.png",
  "versionName": "1.0",
  "versionCode": 1,
  "minPlatformVersion": 1000,
  "features": [{ "name": "system.network" }],
  "permissions": [{ "origin": "*" }],
  "config": {
    "logLevel": "off",
    "background": {
      "features": [
        "system.audio",
        "system.record",
        "system.request",
        "system.geolocation"
      ]
    },
    "network": {
      "connectTimeout": 10000,
      "readTimeout": 10000,
      "writeTimeout": 10000
    }
  },
  "router": {
    "entry": "Hello",
    "pages": {
      "Hello": {
        "component": "hello",
        "path": "/",
        "filter": {
          "view": {
            "uri": "https?://.*"
          }
        }
      },
      "PackageA/Page1": {
        "component": "page1"
      },
      "PackageA/Page2": {
        "component": "page2"
      }
    }
  },
  "display": {
    "backgroundColor": "#ffffff",
    "fullScreen": false,
    "titleBar": true,
    "titleBarBackgroundColor": "#000000",
    "titleBarTextColor": "#fffff",
    "statusBarImmersive": false,
    "statusBarTextStyle": "auto",
    "statusBarBackgroundColor": "#000000",
    "pages": {
      "Hello": {
        "backgroundColor": "#eeeeee",
        "fullScreen": true,
        "titleBarBackgroundColor": "#0000ff",
        "titleBarText": "Hello",
        "orientation": "landscape"
      }
    }
  },
  "subpackages": [
    {
      "name": "pkgA",
      "resource": "PackageA"
    }
  ],
  "trustedSslDomains": ["www.quickapp.cn", "m.quickapp.cn"]
}

menuBarData 1070+

用于定义 menuBar 的相关配置。

示例：

注意：实际代码中 json 文件不能包含注释行，此处注释仅为说明用

{
  "package": "com.company.unit",
  "name": "appName",
  "icon": "/Common/icon.png",
  "versionName": "1.0",
  "versionCode": 1,
  "minPlatformVersion": 1000,
  "display": {
    "menuBarData": {
      // 全局配置
      "menuBar" : true,
      "menuBarStyle":"dark",
      "shareTitle":"分享标题",
      "shareDescription":"分享描述",
      "shareIcon":"分享url"
    },
    "pages": {
      "Hello": {
        // 页面配置，默认使用页面menuBarData配置，页面无配置使用全局menuBarData配置
        "menuBarData": {
          "menuBar" : true,
          "menuBarStyle":"dark",
          "shareTitle":"分享标题",
          "shareDescription":"分享描述",
          "shareIcon":"分享url"
         }
      }
    }
}

menuBar 支持明细 1070+

如果以下没有特别备注，则 menuBar 在此厂商手机 1070+的 sdk 上会默认显示。同时，开发者可通过配置menuBarData.menuBar决定是否显示。