快應(yīng)用 項(xiàng)目配置信息

熟悉描述整個(gè)項(xiàng)目的配置文件（<ProjectName>/src/manifest.json），掌握常用字段的意義：路由router、UI顯示display

通過本節(jié)，你將學(xué)會：

• 配置應(yīng)用基本信息
• 配置頁面路由
• 配置頁面UI顯示

配置應(yīng)用基本信息

每個(gè)應(yīng)用都要有專屬的名稱，圖標(biāo)等，這些信息都需要在manifest.json文件中配置；詳細(xì)信息請參考文檔：manifest文件

應(yīng)用包名（package）

應(yīng)用包名，是區(qū)別于其他應(yīng)用的唯一標(biāo)識

推薦采用com.company.module的格式，示例如下：

{
  "package": "com.example.demo"
}

應(yīng)用名稱（name）

應(yīng)用名稱，6個(gè)漢字以內(nèi)，與應(yīng)用商店保存的名稱一致；框架提供保存到桌面的功能，桌面上顯示的應(yīng)用名即為此屬性

示例如下：

{
  "name": "發(fā)票小助手"
}

應(yīng)用圖標(biāo)（icon）

規(guī)則為正方形（不能是圓角），且務(wù)必?zé)o白邊

{
  "icon": "/Common/logo.png"
}

注意：

請使用絕對路徑，其中/對應(yīng)于路徑<ProjectName>/src/

應(yīng)用版本名稱、版本號（versionName、versionCode）

應(yīng)用版本名稱、版本號為開發(fā)者的應(yīng)用包維護(hù)的版本信息

應(yīng)用版本名稱為主版本.次版本格式

應(yīng)用版本號為整數(shù)，從1開始，每次更新上架請自增1

示例如下：

{
  "versionName": "1.0",
  "versionCode": 1
}

支持的最小平臺版本號（minPlatformVersion）

支持的最小平臺版本號為必填項(xiàng)，默認(rèn)值為1000，標(biāo)識開發(fā)者的rpk包兼容支持的最小運(yùn)行平臺版本

當(dāng)使用了1000以上的平臺版本新增特性時(shí)，就必須確保minPlatformVersion最低為該平臺版本號，避免上線后在更低版本平臺上運(yùn)行出錯(cuò)

示例如下：

{
  "minPlatformVersion": "1000"
}

配置接口列表（features）

在使用接口時(shí)，需要先在manifest中聲明接口。在每個(gè)接口文檔的頂部，都附有聲明接口的配置代碼

以fetch網(wǎng)絡(luò)請求為例，示例如下：

{
  "features": [
    { "name": "system.fetch" }
  ]
}

配置頁面路由（router）

路由，用于定義頁面的實(shí)際地址、跳轉(zhuǎn)地址。如果ux頁面沒有配置路由，則不參與項(xiàng)目編譯。一個(gè)目錄下最多只能存在一個(gè)主頁面文件（不包括組件文件）

首頁名稱（router.entry）

首頁，即應(yīng)用平臺啟動時(shí)默認(rèn)打開的頁面。首頁需配置為應(yīng)用中某頁面的名稱，即在<ProjectName>/src目錄下，頁面目錄的相對路徑

示例如下：

假設(shè)工程根目錄如下所示

└── src
    └── Demo                  頁面目錄，存放各自頁面私有的資源文件和組件文件
        └── index.ux          頁面文件，文件名不必與父文件夾相同（推薦index.ux）

假設(shè)首頁為Demo目錄下的index.ux文件，則首頁對應(yīng)的頁面名稱為Demo

{
  "router": {
    "entry": "Demo"
  }
}

頁面路由對象（router.pages）

頁面路由對象，key為頁面名稱（<ProjectName>/src目錄下，頁面目錄的相對路徑），value為頁面具體路由配置，key不要重復(fù)

頁面具體路由配置（router.pages的value）包括以下屬性：

• component：頁面對應(yīng)的ux文件名
• path：頁面路徑，不填則默認(rèn)為頁面名稱（<ProjectName>/src目錄下，頁面目錄的相對路徑）

示例如下：

假設(shè)工程根目錄如下所示

└── src
    |── Demo                  頁面目錄，存放各自頁面私有的資源文件和組件文件
    |   └── index.ux         頁面文件，文件名不必與父文件夾相同（推薦index.ux）
    └── Doc
        └── Layout            頁面目錄，存放各自頁面私有的資源文件和組件文件
            └── index.ux     頁面文件，文件名不必與父文件夾相同（推薦index.ux）

當(dāng)頁面名稱（router.pages的key）為Demo時(shí)，對應(yīng)的頁面配置（router.pages的value）包括：

• component：頁面對應(yīng)的ux文件名index
• path：頁面路徑，默認(rèn)為頁面名稱Demo

{
  "router": {
    "pages": {
      "Demo": {
        "component": "index"
      },
      "Doc/Layout": {
        "component": "index"
      }
    }
  }
}

現(xiàn)在，開發(fā)者就可以通過/Demo訪問到Demo目錄下的index.ux頁面了

配置頁面UI顯示（display）

UI顯示，用于定義與UI顯示相關(guān)的配置。支持定義：頁面公用的默認(rèn)UI顯示、頁面私有的UI顯示

頁面公用的默認(rèn)UI顯示

頁面公用的默認(rèn)UI顯示，即被所有頁面共享

以標(biāo)題欄文字的配置為例：

{
  "display": {
    "titleBarText": "頁面公用的默認(rèn)標(biāo)題"
  }
}

未配置私有標(biāo)題的頁面，標(biāo)題欄文字均將顯示為頁面公用的默認(rèn)標(biāo)題

頁面私有的UI顯示

頁面私有的UI顯示，在display.pages對象下配置：key為頁面名稱（與路由中的頁面名稱保持一致），value為頁面私有的UI顯示

以標(biāo)題欄文字的配置為例：

{
  "display": {
    "pages": {
      "Demo": {
        "titleBarText": "Demo頁面的標(biāo)題"
      }
    }
  }
}

總結(jié)

熟悉了常用配置項(xiàng)后，開發(fā)者就可以熟練的配置頁面路由、UI顯示等信息了