快應用 manifest文件

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

manifest

config

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

config.network

router

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

示例代碼：

"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 匹配規(guī)則，可能會導致頁面跳轉(zhuǎn)出錯。

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

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

可以處理所有http和https請求的filter定義如下：

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

router.errorPage

當頁面跳轉(zhuǎn)異常時，快應用默認將會跳轉(zhuǎn)到 sdk 的默認錯誤頁，同時前端 app.ux 也會收到 onPageNotFound 回調(diào)

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

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

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

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

display

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

如果在 display 對象下定義以下屬性值，則生效范圍為此快應用全部頁面；

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

subpackages 1040+

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

示例：

{
  "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)配置。

示例：

注意：實際代碼中 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 支持明細

如果以下沒有特別備注，則 menuBar 在此廠商手機 1070+ 的 sdk 上會默認顯示。同時，開發(fā)者可通過配置 menuBarData.menuBar 決定是否顯示。