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

在開(kāi)發(fā)應(yīng)用時(shí)，需要配置應(yīng)用的一些標(biāo)簽，例如應(yīng)用的包名、圖標(biāo)等標(biāo)識(shí)特征的屬性。本文描述了在開(kāi)發(fā)應(yīng)用需要配置的一些關(guān)鍵標(biāo)簽。圖標(biāo)和標(biāo)簽通常一起配置，可以分為應(yīng)用圖標(biāo)、應(yīng)用標(biāo)簽和入口圖標(biāo)、入口標(biāo)簽，分別對(duì)應(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è)備桌面上顯示出來(lái)的，如圖一所示。入口圖標(biāo)是以UIAbility為粒度，支持同一個(gè)應(yīng)用存在多個(gè)入口圖標(biāo)和標(biāo)簽，點(diǎn)擊后進(jìn)入對(duì)應(yīng)的UIAbility界面。

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

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

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

• 應(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)用列表，會(huì)顯示出對(duì)應(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)識(shí)應(yīng)用對(duì)用戶顯示的名稱，需要配置為字符串資源的索引。

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

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

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

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

  {
    "module": {
      // ...
      "abilities": [
        {
          // $開(kāi)頭的為資源值
          "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)識(shí)應(yīng)用的版本號(hào)，該標(biāo)簽值為32位非負(fù)整數(shù)。此數(shù)字僅用于確定某個(gè)版本是否比另一個(gè)版本更新，數(shù)值越大表示版本越高。versionName標(biāo)簽標(biāo)識(shí)版本號(hào)的文字描述。

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

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

• Module權(quán)限配置

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