HarmonyOS應用基礎知識

首頁>技術>阿里二大爺2020-09-13 21:50

HarmonyOS應用基礎知識

APP

HarmonyOS的應用軟體包以APP Pack（Application Package）形式釋出，它是由一個或多個HAP（HarmonyOS Ability Package）以及描述每個HAP屬性的pack.info組成。HAP是Ability的部署包，HarmonyOS應用程式碼圍繞Ability元件展開。

一個HAP是由程式碼、資源、第三方庫及應用配置檔案組成的模組包，可分為entry和feature兩種模組型別，如圖1所示。

entry：應用的主模組。一個APP中，對於同一裝置型別必須有且只有一個entry型別的HAP，可獨立安裝執行。feature：應用的動態特性模組。一個APP可以包含一個或多個feature型別的HAP，也可以不含。只有包含Ability的HAP才能夠獨立執行。

圖1 APP邏輯檢視

Ability

Ability是應用所具備的能力的抽象，一個應用可以包含一個或多個Ability。Ability分為兩種型別：FA（Feature Ability）和PA（Particle Ability）。FA/PA是應用的基本組成單元，能夠實現特定的業務功能。FA有UI介面，而PA無UI介面。

庫檔案

庫檔案是應用依賴的第三方程式碼形式，存放在libs目錄，是.so檔案。

資原始檔

應用的資原始檔（字串、圖片、音訊等）存放於resources目錄下，便於開發者使用和維護，詳見資原始檔分類。

配置檔案

配置檔案 (config.json) 是應用的Ability資訊，用於宣告應用的Ability，以及應用所需許可權等資訊，詳見應用配置檔案。

pack.info

描述應用軟體包中每個HAP的屬性，由IDE編譯生成，應用市場根據該檔案進行拆包和HAP的分類儲存。HAP的具體屬性包括：

delivery-with-install: 用於標識該HAP是否需要在主動安裝時進行安裝。name：HAP檔名。module-type：模組型別，entry或feature。device-type：用於標識支援該HAP執行的裝置型別。應用配置檔案簡介

應用的每個HAP的根目錄下都存在一個“config.json”配置檔案，主要涵蓋以下三個方面：

應用的全域性配置資訊，包含應用的包名、生產廠商、版本號等基本資訊。應用在具體裝置上的配置資訊。HAP包的配置資訊，包含每個Ability必須定義的基本屬性（如包名、類名、型別以及Ability提供的能力），以及應用訪問系統或其他應用受保護部分所需的許可權等。檔案約定

配置檔案“config.json”採用JSON檔案格式，由屬性和值兩部分構成：

屬性屬性出現順序不分先後，且每個屬性最多隻允許出現一次。值每個屬性的值為JSON的基本資料型別（數值、字串、布林值、陣列、物件或者null型別）。如果屬性值需要引用資原始檔，可參見資原始檔。配置檔案的元素

此部分提供“config.json”檔案中所有屬性的詳細解釋。

配置檔案的內部結構

應用的配置檔案“config.json”中由“app”、“deviceConfig”和“module”三個部分組成，缺一不可。配置檔案的內部結構說明參見表1。

表1 配置檔案的內部結構說明

app物件的內部結構

app物件包含應用的全域性配置資訊，內部結構說明參見表2。

表2 app物件的內部結構說明

app示例：

&#34;app&#34;: { &#34;bundleName&#34;: &#34;com.huawei.hiworld.example&#34;,  &#34;vendor&#34;: &#34;huawei&#34;,  &#34;version&#34;: { &#34;code&#34;: 2,  &#34;name&#34;: &#34;2.0&#34; } &#34;apiVersion&#34;: { &#34;compatible&#34;: 3,  &#34;target&#34;: 3 }}

deviceConfig物件的內部結構

deviceConfig包含在具體裝置上的應用配置資訊，可以包含default、car、tv、wearable、liteWearable、smartVision等屬性。default標籤內的配置是適用於所有裝置通用，其他裝置型別如果有特殊的需求，則需要在該裝置型別的標籤下進行配置。內部結構說明參見表3。

表3 deviceConfig物件的內部結構說明

default、car、tv、wearable、liteWearable、smartVision等物件的內部結構說明，可參見表4。

表4 default/car/tv/wearable等物件的內部結構說明

表5 network物件的內部結構說明

表6 securityConfig物件的內部結構說明

deviceConfig示例：

 &#34;deviceConfig&#34;: { &#34;default&#34;: { &#34;process&#34;: &#34;com.huawei.hiworld.example&#34;,  &#34;directLaunch&#34;: false,  &#34;supportBackup&#34;: false, &#34;network&#34;: { &#34;usesCleartext&#34;: true,  &#34;securityConfig&#34;: { &#34;domainSettings&#34;: {  &#34;cleartextPermitted&#34;: true,   &#34;domains&#34;: [ {  &#34;subDomains&#34;: true,   &#34;name&#34;: &#34;example.ohos.com&#34; }  ] } } } }}

module物件的內部結構

module物件包含HAP包的配置資訊，內部結構說明參見表7。

表7 module物件的內部結構說明

module示例：

&#34;module&#34;: { &#34;package&#34;: &#34;com.example.myapplication.entry&#34;,  &#34;name&#34;: &#34;.MyOHOSAbilityPackage&#34;,  &#34;description&#34;: &#34;$string:description_application&#34;,  &#34;supportedModes&#34;: [ &#34;drive&#34; ],  ],  &#34;deviceType&#34;: [ &#34;car&#34; ],  &#34;distro&#34;: { &#34;deliveryWithInstall&#34;: true,  &#34;moduleName&#34;: &#34;ohos_entry&#34;,  &#34;moduleType&#34;: &#34;entry&#34; },  &#34;abilities&#34;: [ ... ],  &#34;shortcuts&#34;: [ ... ], &#34;js&#34;: [ ... ],  &#34;reqPermissions&#34;: [ ... ],  &#34;defPermissions&#34;: [ ... ]}

表8 distro物件的內部結構說明

distro示例：

&#34;distro&#34;: { &#34;deliveryWithInstall&#34;: true,  &#34;moduleName&#34;: &#34;ohos_entry&#34;,  &#34;moduleType&#34;: &#34;entry&#34;}

表9 abilities物件的內部結構說明

abilities示例：

&#34;abilities&#34;: [ { &#34;name&#34;: &#34;.MainAbility&#34;,  &#34;description&#34;: &#34;$string:description_main_ability&#34;,  &#34;icon&#34;: &#34;$media:hiworld.png&#34;,  &#34;label&#34;: &#34;HiMusic&#34;,  &#34;type&#34;: &#34;page&#34;,  &#34;formEnabled&#34;: false,  &#34;launchType&#34;: &#34;standard&#34;,  &#34;orientation&#34;: &#34;unspecified&#34;,  &#34;permissions&#34;: [ ],  &#34;visible&#34;: false,  &#34;skills&#34;: [ { &#34;actions&#34;: [  &#34;action.system.home&#34; ],  &#34;entities&#34;: [  &#34;entity.system.home&#34; ] } ],  &#34;configChanges&#34;: [ &#34;locale&#34;,  &#34;layout&#34;,  &#34;fontSize&#34;,  &#34;orientation&#34; ],  &#34;directLaunch&#34;: false,  &#34;process&#34;: &#34;string&#34;,  &#34;backgroundModes&#34;: [ &#34;dataTransfer&#34;,  &#34;audioPlayback&#34;,  &#34;audioRecording&#34;,  &#34;pictureInPicture&#34;,  &#34;voip&#34;,  &#34;location&#34;,  &#34;bluetoothInteraction&#34;,  &#34;wifiInteraction&#34;,  &#34;screenFetch&#34; ],  }]

表10 skills物件的內部結構說明

skills示例：

&#34;skills&#34;: [ { &#34;actions&#34;: [ &#34;action.system.home&#34; ],  &#34;entities&#34;: [ &#34;entity.system.home&#34; ], &#34;uris&#34;: [ {  &#34;scheme&#34;: &#34;http&#34;,  &#34;host&#34;: &#34;www.xxx.com&#34;,  &#34;port&#34;: &#34;8080&#34;,  &#34;path&#34;: &#34;query/student/name&#34;,  &#34;type&#34;: &#34;text&#34; } ] }]

表11 form物件的內部結構說明

form示例：

&#34;form&#34;: { &#34;formEntity&#34;: [ &#34;homeScreen&#34;,  &#34;searchbox&#34; ],  &#34;minHeight&#34;: 100,  &#34;maxHeight&#34;: 200,  &#34;minWidth&#34;: 100,  &#34;maxWidth&#34;: 200}

表12 js物件的內部結構說明

js示例：

&#34;js&#34;: [ { &#34;name&#34;: &#34;default&#34;,  &#34;pages&#34;: [  &#34;pages/index/index&#34;, &#34;pages/detail/detail&#34; ],  &#34;window&#34;: { &#34;designWidth&#34;: 750, &#34;autoDesignWidth&#34;: false } }]

表13 shortcuts物件的內部結構說明

示例：

&#34;shortcuts&#34;: [ { &#34;shortcutId&#34;: &#34;id&#34;, &#34;label&#34;: &#34;$string:shortcut&#34;, &#34;intents&#34;: [ { &#34;targetBundle&#34;: &#34;com.huawei.hiworld.himusic&#34;, &#34;targetClass&#34;: &#34;com.huawei.hiworld.himusic.entry.MainAbility&#34; } ] }]

配置檔案示例

以JSON檔案為config.json的一個簡單示例，該示例的應用宣告為三個Ability。

{ &#34;app&#34;: { &#34;bundleName&#34;: &#34;com.huawei.hiworld.himusic&#34;, &#34;vendor&#34;: &#34;huawei&#34;, &#34;version&#34;: { &#34;code&#34;: 2,  &#34;name&#34;: &#34;2.0&#34; } &#34;apiVersion&#34;: { &#34;compatible&#34;: 3,  &#34;target&#34;: 3 } }, &#34;deviceConfig&#34;: { &#34;default&#34;: { } }, &#34;module&#34;: { &#34;package&#34;: &#34;com.huawei.hiworld.himusic.entry&#34;, &#34;name&#34;: &#34;.MainApplication&#34;, &#34;supportedModes&#34;: [ &#34;drive&#34; ], &#34;distro&#34;: { &#34;moduleType&#34;: &#34;entry&#34;, &#34;deliveryWithInstall&#34;: true, &#34;moduleName&#34;: &#34;hap-car&#34; }, &#34;deviceType&#34;: [ &#34;car&#34; ],  &#34;abilities&#34;: [ { &#34;name&#34;: &#34;.MainAbility&#34;, &#34;description&#34;: &#34;himusic main ability&#34;, &#34;icon&#34;: &#34;$media:ic_launcher&#34;, &#34;label&#34;: &#34;HiMusic&#34;, &#34;launchType&#34;: &#34;standard&#34;, &#34;orientation&#34;: &#34;unspecified&#34;, &#34;visible&#34;: true, &#34;skills&#34;: [  { &#34;actions&#34;: [  &#34;action.system.home&#34; ], &#34;entities&#34;: [  &#34;entity.system.home&#34; ]  } ], &#34;type&#34;: &#34;page&#34;, &#34;formEnabled&#34;: false }, { &#34;name&#34;: &#34;.PlayService&#34;, &#34;description&#34;: &#34;himusic play ability&#34;, &#34;icon&#34;: &#34;$media:ic_launcher&#34;, &#34;label&#34;: &#34;HiMusic&#34;, &#34;launchType&#34;: &#34;standard&#34;, &#34;orientation&#34;: &#34;unspecified&#34;, &#34;visible&#34;: false, &#34;skills&#34;: [  { &#34;actions&#34;: [  &#34;action.play.music&#34;,  &#34;action.stop.music&#34; ], &#34;entities&#34;: [  &#34;entity.audio&#34; ]  } ], &#34;type&#34;: &#34;service&#34;, &#34;formEnabled&#34;: false, &#34;backgroundModes&#34;: [  &#34;audioPlayback&#34; ] }, { &#34;name&#34;: &#34;.UserADataAbility&#34;, &#34;type&#34;: &#34;data&#34;, &#34;uri&#34;: &#34;dataability://com.huawei.hiworld.himusic.UserADataAbility&#34;, &#34;visible&#34;: true } ], &#34;reqPermissions&#34;: [{ &#34;name&#34;: &#34;ohos.permission.DISTRIBUTED_DATASYNC&#34;, &#34;reason&#34;: &#34;&#34;, &#34;usedScene&#34;: {  &#34;ability&#34;: [ &#34;com.huawei.hiworld.himusic.entry.MainAbility&#34;, &#34;com.huawei.hiworld.himusic.entry.PlayService&#34;  ],  &#34;when&#34;: &#34;inuse&#34; } } ] }}

2689