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

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

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

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

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

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

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

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

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

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

• 入口圖標(biāo)和標(biāo)簽配置

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

  入口圖標(biāo)需要在module.json5配置文件中配置，在abilities標(biāo)簽下面有icon標(biāo)簽。例如希望在桌面上顯示該UIAbility的圖標(biāo)，則需要在skills標(biāo)簽下面的entities中添加"entity.system.home"、actions中添加"action.system.home"。同一個應(yīng)用有多個UIAbility配置上述字段時，桌面上會顯示出多個圖標(biāo)，分別對應(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標(biāo)簽和versionName標(biāo)簽。versionCode用于標(biāo)識應(yīng)用的版本號，該標(biāo)簽值為32位非負整數(shù)。此數(shù)字僅用于確定某個版本是否比另一個版本更新，數(shù)值越大表示版本越高。versionName標(biāo)簽標(biāo)識版本號的文字描述。

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

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

• Module權(quán)限配置

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