鴻蒙應用開發入門：進一步了解第一個例子里的細節
https://harmonyos.51cto.com/#zz
4.1 開發完第一個鴻蒙應用后，下面在了解一下完整的鴻蒙應用打包發布后應該是什么樣子：
一個完整的打包后應用結構如下圖所示，這里我們先了解結構，具體怎么打包很簡單只要前提是要簽名!
1. HAP的分類
HAP又可分為entry和feature兩種模塊類型：
1)entry：應用的主模塊。一個APP中，對于同一設備類型必須有且只有一個entry類型的HAP，可獨立安裝運行。
2) feature：應用的動態特性模塊。一個APP可以包含一個或多個feature類型的HAP，也可以不含。
2. HAP的組成
HAP是由代碼(Ability)、第三方庫、資源以及應用配置文件構成，只有包含Ability的HAP才能夠獨立運行。
1)Ability
Ability是應用所具備的能力的抽象，一個應用可以包含一個或多個Ability。Ability分為兩種類型：FA(Feature Ability)和PA(Particle Ability)。FA/PA是應用的基本組成單元，能夠實現特定的業務功能。FA有UI界面，而PA無UI界面。
2)庫文件
庫文件是應用依賴的第三方代碼形式，存放在libs目錄。
3)資源文件
應用的資源文件(字符串、圖片、音頻等)存放于resources目錄下
4)配置文件
配置文件 (config.json) 是應用的Ability信息，用于聲明應用的Ability，以及應用所需權限等信息
3. pack.info文件
描述應用軟件包中每個HAP的屬性，由IDE編譯生成，應用市場根據該文件進行拆包和HAP的分類存儲。
HAP的具體屬性包括：
1)delivery-with-install: 表示該HAP是否支持隨應用安裝。
2)name：HAP文件名。
3)module-type：模塊類型，entry或feature。
4)device-type：表示支持該HAP運行的設備類型。
4.2 config.json詳細細節
1. 應用的每個HAP的根目錄下都存在一個“config.json”配置文件，主要涵蓋以下三個方面：
1)應用的全局配置信息，包含應用的包名、生產廠商、版本號等基本信息。
2)應用在具體設備上的配置信息。
3)HAP包的配置信息，包含每個Ability必須定義的基本屬性(如包名、類名、類型以及Ability提供的能力)，以及應用訪問系統或其他應用受保護部分所需的權限等。
2. config.json配置文件的內部結構
應用的配置文件“config.json”中由“app”、“deviceConfig”和“module”三個部分組成，缺一不可。
3. “config.json”文件約定
配置文件“config.json”采用JSON文件格式，由屬性和值兩部分構成：
1)屬性：屬性出現順序不分先后，且每個屬性最多只允許出現一次。
2)值：每個屬性的值為JSON的基本數據類型(數值、字符串、布爾值、數組、對象或者null類型)。
學習建議：根據官方文檔自己做一個思維導圖，做的過程中熟悉，用的時候查詢，我學習的時候做的，附件在后面，需要一個叫MindMaster的思維導圖工具打開。做完思維導圖系統地熟悉一遍這個配置項后，再在下面的練習中，把每個配置項目的意思備注后面，加深印象。
練習1：認一遍app部分，把說明注釋在第一個例子的app配置后面：
- "app": { //表示應用的全局配置信息，就像這樣，后面的自己做......
- "bundleName": "com.example.myapplication",
- "vendor": "example",
- "version": {
- "code": 1,
- "name": "1.0"
- },
- "apiVersion": {
- "compatible": 3,
- "target": 3
- }
- },
練習2：認一遍deviceConfig部分，把說明注釋在后面：
- "deviceConfig": {//表示應用在具體設備上的配置信息。
- "default": {
- "process": "com.huawei.hiworld.example",
- "directLaunch": false,
- "supportBackup": false,
- "network": {
- "usesCleartext": true,
- "securityConfig": {
- "domainSettings": {
- "cleartextPermitted": true,
- "domains": [
- {
- "subDomains": true,
- "name": "example.ohos.com"
- }
- ]
- }
- }
- }
- }
- }
練習3：認一遍認一下module部分，把說明注釋在后面：
- "module": {//表示HAP包的配置信息。該標簽下的配置只對當前HAP包生效。
- "package": "com.example.myapplication",
- "name": ".MyApplication",
- "reqCapabilities": [
- "video_support"
- ],
- "deviceType": [
- "tv"
- ],
- "distro": {
- "deliveryWithInstall": true,
- "moduleName": "entry",
- "moduleType": "entry"
- },
- "abilities": [
- {
- "skills": [
- {
- "entities": [
- "entity.system.home"
- ],
- "actions": [
- "action.system.home"
- ]
- }
- ],
- "orientation": "landscape",
- "formEnabled": false,
- "name": "com.example.myapplication.MainAbility",
- "icon": "$media:icon",
- "description": "$string:mainability_description",
- "label": "MyApplication",
- "type": "page",
- "launchType": "standard"
- },
- {
- "orientation": "landscape",
- "formEnabled": false,
- "name": "com.example.myapplication.Secondbility",
- "icon": "$media:icon",
- "description": "$string:secondbility_description",
- "label": "entry",
- "type": "page",
- "launchType": "standard"
- }
- ]
- }
4.3 進一步了解資源目錄的細節
1. 資源文件的知識點
應用的資源文件都在resources目錄下，resources子目錄分兩大類目錄：具體的知識點，同樣我們做成思維導圖，見后面附件。
2. 資源文件的使用
base目錄與限定詞目錄中的資源文件：通過指定資源類型(type)和資源名稱(name)來引用。
1)Java文件引用資源文件的格式：
(1)普通資源：ResourceTable.type_name。
(2)系統資源，則采用：ohos.global.systemres.ResourceTable.type_name。
(3)目前支持的系統資源文件：
① ic_app：表示HarmonyOS應用的默認圖標，類型為媒體。
② request_location_reminder_title：表示“請求使用設備定位功能”的提示標題，類型為字符串。
③ request_location_reminder_content：表示“請求使用設備定位功能”的提示內容，類型為字符串。
示例一：在Java文件中，引用系統資源。
- ResourceManager rsManager = this.getResourceManager();
- try {
- String str = rsManager
- .getElement(ohos.global.systemres.ResourceTable.
- String_request_location_reminder_title).getString();
- Text text = (Text) findComponentById(ResourceTable.Id_text);
- text.setText(str);
- } catch (Exception e) {
- terminateAbility();
- }
示例二：在Java文件中，引用string.json文件中類型為“String”、名稱為“app_name”的資源。
string.json的例子：
- {
- "color":[
- {
- "name":"red",
- "value":"#ff0000"
- },
- {
- "name":"red_ref",
- "value":"$color:red"
- }
- ]
- }
- ohos.global.resource.ResourceManager resManager = getResourceManager();
- int color = resManager.getElement(ResourceTable.Color_red).getColor();
示例四：在Java文件中，獲取profile中的文件內容。
- Resource resource = null;
- try {
- Text text = (Text) findComponentById(ResourceTable.Id_text);
- resource = getResourceManager().getResource(ResourceTable.Profile_test1);
- InputStreamReader inputStreamReader = new InputStreamReader(resource, "utf-8");
- BufferedReader bufferedReader = new BufferedReader(inputStreamReader);
- String lineTxt = "";
- while((lineTxt = bufferedReader.readLine()) != null){
- text.append(","+lineText);
- }
- } catch (Exception e) {
- }
2)XML文件引用資源文件的格式：
(1)普通資源，$type:name
(2)系統資源，則采用：$ohos:type:name。
在XML文件中，引用 string.json文件中類型為“String”、名稱為“app_name”的資源，示例如下：
- <?xml version="1.0" encoding="utf-8"?>
- <DirectionalLayout xmlns:ohos="http://schemas.huawei.com/res/ohos"
- ohos:width="match_parent"
- ohos:height="match_parent"
- ohos:orientation="vertical">
- <Text ohos:text="$string:app_name"/>
- </DirectionalLayout>
9. rawfile目錄中的資源文件
通過指定文件路徑和文件名稱來引用。
在Java文件中，引用一個路徑為“resources/rawfile/”、名稱為“ttt.txt”的資源文件，示例如下：
- Resource resource = null;
- try {
- Text text = (Text) findComponentById(ResourceTable.Id_text);
- resource = getResourceManager().getRawFileEntry("resources/rawfile/ttt.txt").openRawFile();
- InputStreamReader inputStreamReader = new InputStreamReader(resource, "utf-8");
- BufferedReader bufferedReader = new BufferedReader(inputStreamReader);
- String lineTxt = "";
- while((lineTxt = bufferedReader.readLine()) != null){
- text.append(","+lineTxt );
- }
- } catch (Exception e) {
- }
文章配套視頻課程《鴻蒙手機應用開發入門》https://edu.51cto.com/course/26133.html
©著作權歸作者和HarmonyOS技術社區共同所有，如需轉載，請注明出處，否則將追究法律責任
https://harmonyos.51cto.com/#zz
