manifest.json文件中包含了應(yīng)用描述、接口聲明、頁(yè)面路由信息

manifest

config

用于定義系統(tǒng)配置和全局?jǐn)?shù)據(jù)。

config.network

router

用于定義頁(yè)面的組成和相關(guān)配置信息，如果頁(yè)面沒(méi)有配置路由信息，則在編譯打包時(shí)跳過(guò)。

示例代碼：

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

router.pages

用于定義單個(gè)頁(yè)面路由信息。

router.pages.filter

匹配頁(yè)面某種請(qǐng)求，如請(qǐng)求 uri 和 filter 中 uri 匹配成功，則在匹配頁(yè)面打開。

filter 匹配原則是按照 manifest.json 中 router.pages 中頁(yè)面順序自上往下逐一匹配，uri 匹配成功即會(huì)在該頁(yè)面中使用，故不建議多頁(yè)面采用相同 uri 匹配規(guī)則，可能會(huì)導(dǎo)致頁(yè)面跳轉(zhuǎn)出錯(cuò)。

filter 的結(jié)構(gòu)如下：

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

可以處理所有http和https請(qǐng)求的filter定義如下：

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

router.errorPage

當(dāng)頁(yè)面跳轉(zhuǎn)異常時(shí)，快應(yīng)用默認(rèn)將會(huì)跳轉(zhuǎn)到 sdk 的默認(rèn)錯(cuò)誤頁(yè)，同時(shí)前端 app.ux 也會(huì)收到 onPageNotFound 回調(diào)

此參數(shù)可提供給開發(fā)者配置自定義錯(cuò)誤頁(yè)面

參數(shù)：自定義錯(cuò)誤頁(yè)面的參數(shù)，需要提供一個(gè)在 pages 項(xiàng)里已經(jīng)配置好的 key 值

注意：開發(fā)者自定義錯(cuò)誤頁(yè)面的時(shí)候，推薦在 script 標(biāo)簽加入以下這段代碼。按照這樣設(shè)置，當(dāng)用戶 deeplink 跳轉(zhuǎn)進(jìn)快應(yīng)用報(bào)錯(cuò)時(shí)，點(diǎn)擊返回鍵，可以跳到當(dāng)前快應(yīng)用的首頁(yè)，繼續(xù)瀏覽快應(yīng)用的頁(yè)面。

import router from '@system.router'
export default {
  onBackPress() {
    // 由deep-link等方式進(jìn)來(lái)，異常發(fā)生時(shí)，一進(jìn)來(lái)首頁(yè)就是Error Page
    // 則此時(shí)返回需要手動(dòng)修改，使其跳轉(zhuǎn)到首頁(yè)
    if (router.getLength() === 1) {
      router.replace({
        // 返回首頁(yè)
        path: '/'
      })
      return true
    }
  }
}

display

用于定義與 UI 顯示相關(guān)的配置。

如果在 display 對(duì)象下定義以下屬性值，則生效范圍為此快應(yīng)用全部頁(yè)面；

如果在 display.pages 對(duì)象里的頁(yè)面 key 值下定義以下屬性值，則生效范圍僅為此頁(yè)面；并且，此處指定的頁(yè)面 display 屬性值，優(yōu)先級(jí)高于上述的全局范圍的屬性值

subpackages 1040+

用于定義分包的相關(guān)配置。分包的詳細(xì)使用方法參見 分包加載。

示例：

{
  "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"
  },
  "router": {
    "entry": "Hello",
    "pages": {
      "Hello": {
        "component": "hello",
        "path": "/",
        "filter": {
          "view": {
            "uri": "https?://.*"
          }
        }
      }
    }
  },
  "display": {
    "backgroundColor": "#ffffff",
    "fullScreen": false,
    "titleBar": true,
    "titleBarBackgroundColor": "#000000",
    "titleBarTextColor": "#fffff",
    "pages": {
      "Hello": {
        "backgroundColor": "#eeeeee",
        "fullScreen": true,
        "titleBarBackgroundColor": "#0000ff",
        "titleBarText": "Hello"
      }
    }
  }
}

menuBarData

用于定義 menuBar 的相關(guān)配置。

示例：

注意：實(shí)際代碼中 json 文件不能包含注釋行，此處注釋僅為說(shuō)明用

{
  "package": "com.company.unit",
  "name": "appName",
  "icon": "/Common/icon.png",
  "versionName": "1.0",
  "versionCode": 1,
  "minPlatformVersion": 1000,
  "display": {
    "menuBarData": {
      // 全局配置
      "menuBar" : true,
      "menuBarStyle":"dark",
      "shareTitle":"分享標(biāo)題",
      "shareDescription":"分享描述",
      "shareIcon":"分享url"
    },
    "pages": {
      "Hello": {
        // 頁(yè)面配置，默認(rèn)使用頁(yè)面menuBarData配置，頁(yè)面無(wú)配置使用全局menuBarData配置
        "menuBarData": {
          "menuBar" : true,
          "menuBarStyle":"dark",
          "shareTitle":"分享標(biāo)題",
          "shareDescription":"分享描述",
          "shareIcon":"分享url"
         }
      }
    }
}

menuBar 支持明細(xì)

如果以下沒(méi)有特別備注，則 menuBar 在此廠商手機(jī) 1070+ 的 sdk 上會(huì)默認(rèn)顯示。同時(shí)，開發(fā)者可通過(guò)配置 menuBarData.menuBar 決定是否顯示。