應(yīng)用/組件級配置

在開發(fā)應(yīng)用時，需要配置應(yīng)用的一些標簽，例如應(yīng)用的包名、圖標等標識特征的屬性。本文描述了在開發(fā)應(yīng)用需要配置的一些關(guān)鍵標簽。圖標和標簽通常一起配置，可以分為應(yīng)用圖標、應(yīng)用標簽和入口圖標、入口標簽，分別對應(yīng)app.json5配置文件和module.json5配置文件文件中的icon和label標簽。應(yīng)用圖標和標簽是在設(shè)置應(yīng)用中使用，例如設(shè)置應(yīng)用中的應(yīng)用列表。入口圖標是應(yīng)用安裝完成后在設(shè)備桌面上顯示出來的，如圖一所示。入口圖標是以UIAbility為粒度，支持同一個應(yīng)用存在多個入口圖標和標簽，點擊后進入對應(yīng)的UIAbility界面。

圖1 應(yīng)用圖標和標簽

• 應(yīng)用包名配置

  應(yīng)用需要在工程的AppScope目錄下的app.json5配置文件中配置bundleName標簽，該標簽用于標識應(yīng)用的唯一性。推薦采用反域名形式命名（如com.example.demo，建議第一級為域名后綴com，第二級為廠商/個人名，第三級為應(yīng)用名，也可以多級）。

• 應(yīng)用圖標和標簽配置

  Stage模型的應(yīng)用需要配置應(yīng)用圖標和應(yīng)用標簽。應(yīng)用圖標和標簽是在設(shè)置應(yīng)用中使用，例如設(shè)置應(yīng)用中的應(yīng)用列表，會顯示出對應(yīng)的圖標和標簽。

  應(yīng)用圖標需要在工程的AppScope目錄下的app.json5配置文件中配置icon標簽。應(yīng)用圖標需配置為圖片的資源索引，配置完成后，該圖片即為應(yīng)用的圖標。

  應(yīng)用標簽需要在工程的AppScope模塊下的app.json5配置文件中配置label標簽。標識應(yīng)用對用戶顯示的名稱，需要配置為字符串資源的索引。

    {
      "app": {
        "icon": "$media:app_icon",
        "label": "$string:app_name"
        // ...
      }
    }

• 入口圖標和標簽配置

  Stage模型支持對組件配置入口圖標和入口標簽。入口圖標和入口標簽會顯示在桌面上。

  入口圖標需要在module.json5配置文件中配置，在abilities標簽下面有icon標簽。例如希望在桌面上顯示該UIAbility的圖標，則需要在skills標簽下面的entities中添加"entity.system.home"、actions中添加"action.system.home"。同一個應(yīng)用有多個UIAbility配置上述字段時，桌面上會顯示出多個圖標，分別對應(yīng)各自的UIAbility。

  {
    "module": {
      // ...
      "abilities": [
        {
          // $開頭的為資源值
          "icon": "$media:icon",
          "label": "$string:EntryAbility_label",
          "skills": [
            {
              "entities": [
                "entity.system.home"
              ],
              "actions": [
                "action.system.home"
              ]
            }
          ],
        }
      ]
    }
  }

• 應(yīng)用版本聲明配置

  應(yīng)用版本聲明需要在工程的AppScope目錄下的app.json5配置文件中配置versionCode標簽和versionName標簽。versionCode用于標識應(yīng)用的版本號，該標簽值為32位非負整數(shù)。此數(shù)字僅用于確定某個版本是否比另一個版本更新，數(shù)值越大表示版本越高。versionName標簽標識版本號的文字描述。

• Module支持的設(shè)備類型配置

  Module支持的設(shè)備類型需要在module.json5配置文件中配置deviceTypes標簽，如果deviceTypes標簽中添加了某種設(shè)備，則表明當前的Module支持在該設(shè)備上運行。

• Module權(quán)限配置

  Module訪問系統(tǒng)或其他應(yīng)用受保護部分所需的權(quán)限信息需要在module.json5配置文件中配置requestPermission標簽。該標簽用于聲明需要申請權(quán)限的名稱、申請權(quán)限的原因以及權(quán)限使用的場景。