【HarmonyOS之旅】HarmonyOS开发基础知识(二)

目录

1 -> 配置文件说明(Java)

1.1 -> 配置文件的内部结构

1.2 -> app对象的内部结构

1.3 -> deviceConfig对象的内部结构

1.4 -> module对象的内部结构

1.5 -> HAP与HAR的配置文件的合并

1.5.1 -> 配置文件合并规则

1.5.2 -> mergeRule对象的使用

1.5.3 -> bundleName占位符的使用

2 -> 应用数据管理

2.1 -> 本地应用数据管理

2.2 -> 分布式数据服务

2.3 -> 分布式文件服务

2.4 -> 数据搜索服务

2.5 -> 数据存储管理

3 -> 应用安全管理

3.1 -> 应用开发准备阶段

3.2 -> 应用开发调试阶段

3.2.1 -> 编码安全

3.2.2 -> 权限使用

3.3 -> 应用发布分发阶段

1 -> 配置文件说明(Java)

此部分提供配置文件“config.json”中所有属性的详细解释。

DevEco Studio提供了两种编辑“config.json”文件的方式。在“config.json”的编辑窗口中，可在右上角切换代码编辑视图或可视化编辑视图。

1.1 -> 配置文件的内部结构

“config.json”由app、deviceConfig和module三个部分组成，缺一不可。

1.2 -> app对象的内部结构

app对象包含应用的全局配置信息。

app示例：

app示例：

"app": {
    "bundleName": "com.huawei.hiworld.example", 
    "vendor": "huawei", 
    "version": {
        "code": 2, 
        "name": "2.0.0"
    }
}

1.3 -> deviceConfig对象的内部结构

deviceConfig包含在具体设备上的应用配置信息，可以包含default、phone、tablet、tv、car、wearable、liteWearable和smartVision等属性。default标签内的配置是适用于所有设备通用，其他设备类型如果有特殊的需求，则需要在该设备类型的标签下进行配置。

default、phone、tablet、tv、car、wearable、liteWearable和smartVision等对象的内部结构说明。

deviceConfig示例：

 "deviceConfig": {
    "default": {
        "process": "com.huawei.hiworld.example", 
        "supportBackup": false,
        "network": {
            "cleartextTraffic": true, 
            "securityConfig": {
                "domainSettings": {
                    "cleartextPermitted": true, 
                    "domains": [
                        {
                            "subdomains": true, 
                            "name": "example.ohos.com"
                        }
                    ]
                }
            }
        }
    }
}

1.4 -> module对象的内部结构

module对象包含HAP包的配置信息。

module示例：

"module": {
    "mainAbility": "MainAbility",
    "package": "com.example.myapplication.entry", 
    "name": ".MyOHOSAbilityPackage", 
    "description": "$string:description_application", 
    "supportedModes": [
        "drive"
    ], 
    "deviceType": [
        "car"
    ], 
    "distro": {
        "deliveryWithInstall": true, 
        "moduleName": "ohos_entry", 
        "moduleType": "entry"
    }, 
    "abilities": [
        ...
    ], 
    "shortcuts": [
        ...
    ],
    "js": [
        ...
    ], 
    "reqPermissions": [
        ...
    ], 
    "defPermissions": [
        ...
    ],
    "colorMode": "light"
}

distro示例：

"distro": {
    "deliveryWithInstall": true, 
    "moduleName": "ohos_entry", 
    "moduleType": "entry",
    "installationFree": true
} 

metaData示例：

"metaData": {
    "parameters" : [{
        "name" : "string",
        "type" : "Float",
        "description" : "$string:parameters_description"
    }],
    "results" : [{
        "name" : "string",
        "type" : "Float",
        "description" : "$string:results_description"
    }],
    "customizeData" : [{
        "name" : "string",
        "value" : "string",
        "extra" : "$string:customizeData_description"
    }]
}

abilities示例：

"abilities": [
    {
        "name": ".MainAbility",
        "description": "himusic main ability",
        "icon": "$media:ic_launcher",
        "label": "HiMusic",
        "launchType": "standard",
        "orientation": "unspecified",
        "permissions": [
        ], 
        "visible": true,
        "skills": [
            {
                "actions": [
                    "action.system.home"
                ],
                "entities": [
                    "entity.system.home"
                ]
            }
        ],
        "configChanges": [
            "locale", 
            "layout", 
            "fontSize", 
            "orientation"
        ], 
        "type": "page"
    },
    {
        "name": ".PlayService",
        "description": "himusic play ability",
        "icon": "$media:ic_launcher",
        "label": "HiMusic",
        "launchType": "standard",
        "orientation": "unspecified",
        "visible": false,
        "skills": [
            {
                "actions": [
                    "action.play.music",
                    "action.stop.music"
                ],
                "entities": [
                    "entity.audio"
                ]
            }
        ],
        "type": "service",
        "backgroundModes": [
            "audioPlayback"
        ]
    },
    {
        "name": ".UserADataAbility",
        "type": "data",
        "uri": "dataability://com.huawei.hiworld.himusic.UserADataAbility",
        "visible": true
    }
]

skills示例：

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

js示例：

"js": [
    {
        "name": ".default", 
        "pages": [            
            "pages/index/index",
            "pages/detail/detail"
        ],         
        "window": {
            "designWidth": 720,
            "autoDesignWidth": false
        },
        "type": "form",
        "mode": {
            "type": form,
            "syntax": hml
        }
    }
]

shortcuts示例：

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

forms示例：

"forms": [
    {
        "name": "Form_Js",
        "description": "It's Js Form",
        "type": "JS",
        "jsComponentName": "card",
        "colorMode": "auto",
        "isDefault": true,
        "updateEnabled": true,
        "scheduledUpdateTime": "11:00",
        "updateDuration": 1,
        "defaultDimension": "2*2",
        "supportDimensions": [
            "2*2",
            "2*4",
            "4*4"
        ]
    },
    {
        "name": "Form_Java",
        "description": "It's Java Form",
        "type": "Java",
        "colorMode": "auto",
        "isDefault": false,
        "updateEnabled": true,
        "scheduledUpdateTime": "21:05",
        "updateDuration": 1,
        "defaultDimension": "1*2",
        "supportDimensions": [
            "1*2"
        ],
        "landscapeLayouts": [
            "$layout:ability_form"
        ],
        "portraitLayouts": [
            "$layout:ability_form"
        ],
        "formConfigAbility": "ability://com.example.myapplication.fa/.MainAbility",
        "metaData": {
            "customizeData": [
                {
                    "name": "originWidgetName",
                    "value": "com.huawei.weather.testWidget"
                }
            ]
        }
    }
]

distroFilter示例：

"distroFilter": 
{
    "apiVersion": {
        "policy": "include",
        "value": [4,5]
    },
    "screenShape": {
        "policy": "include",
        "value": ["circle","rect"]
    },
    "screenWindow": {
        "policy": "include",
        "value": ["454*454","466*466"]
    }
}

1.5 -> HAP与HAR的配置文件的合并

如果应用模块中调用了HAR，在编译构建HAP时，需要将HAP的“config.json”文件与一个或多个HAR的“config.json”文件，合并为一个“config.json”文件。在合并过程中，不同文件的同一个标签的取值可能发生冲突，此时，需要通过配置mergeRule来解决冲突。

1.5.1 -> 配置文件合并规则

HAP与HAR的“config.json”文件合并时，需要将HAR的配置信息全部合并到HAP的配置文件。

HAP的优先级总是高于HAR。当HAP依赖于多个HAR时，先加载的HAR的优先级高于后加载的HAR，按照HAR的加载顺序依次合并到HAP文件。

1.5.2 -> mergeRule对象的使用

mergeRule通常在HAP的“config.json”文件中使用，可以在abilities、defPermissions、 reqPermissions、js等属性中添加。不同属性的合并策略。

注意

• HAR配置文件中不能包含“action.system.home”和“entity.system.home”配置项，否则会导致编译报错。
• abilities对象中name字段的取值，必须为完整的类名，否则会导致合并出错。

mergeRule的使用示例：

在下面的示例中，HAP与HAR中的Ability的name取值相同，需要对两者“config.json”文件中的Ability进行合并。由于两个文件中的部分字段(例如launchType)存在冲突，需要在HAP的abilities标签下添加mergeRule。

1. 合并前HAP的“config.json”文件，如下所示：

其中，remove表示合并后需要移除的子标签，replace表示合并后需要替换的子标签(HAP替换HAR)。

"abilities": [
    {
        "mergeRule": {
            "remove": ["orientation"],
            "replace": ["launchType"]
        }
        "name": "com.harmony.myapplication.entry.MainAbility",
        "type": "page",
        "launchType": "standard",
        "visible": false
    }
],

2. 合并前HAR的“config.json”文件，如下所示：

"abilities": [
    {
        "name": "com.harmony.myapplication.entry.MainAbility",
        "type": "page",
        "launchType": "singleton",
        "orientation": "portrait",
        "visible": false
    }
],

3. 将上述两个“config.json”文件按照mergeRule进行合并，处理完成后mergeRule字段也会被移除。合并后的结果文件，如下所示：

"abilities": [
    {
        "name": "com.harmony.myapplication.entry.MainAbility",
        "type": "page",
        "launchType": "standard",
        "visible": false
    }
],

1.5.3 -> bundleName占位符的使用

HAR的“config.json”文件中多处需要使用包名，例如自定义权限、自定义action等场景，但是包名只有当HAR编译到HAP时才能确定下来。在编译之前，HAR中的包名可以采用占位符来表示，采用{bundleName}形式。

支持bundleName占位符的标签有actions、entities、permissions、readPermission、writePermission、defPermissions.name。

使用示例：

1. HAR中自定义action时，使用{bundleName}来代替包名。如下所示：

"skills": [
    {
        "actions": [
            "{bundleName}.ACTION_PLAY"
        ],
        "entities": [
            "{bundleName}.ENTITY_PLAY"
        ],
    }
],

2. 将HAR编译到bundleName为“com.huawei.hiworld”的HAP包后，原来的{bundleName}将被替换为HAP的实际包名。替换后的结果如下所示：

"app": {
    "bundleName": "com.huawei.hiworld",
    ……
},
"module": {
    "abilities": [
        {
            "skills": [
                {
                    "actions": [
                        "com.huawei.hiworld.ACTION_PLAY"
                    ],
                    "entities": [
                        "com.huawei.hiworld.ENTITY_PLAY"
                    ],
                }
            ],

2 -> 应用数据管理

HarmonyOS应用数据管理支持单设备的各种结构化数据的持久化，以及跨设备之间数据的同步、共享以及搜索功能。开发者通过应用数据管理，能够方便地完成应用程序数据在不同终端设备间的无缝衔接，满足用户跨设备使用数据的一致性体验。

2.1 -> 本地应用数据管理

提供单设备上结构化数据的存储和访问能力。使用SQLite作为持久化存储引擎，提供了多种类型的本地数据库，分别是关系型数据库(Relational Database)和对象关系映射数据库(Object Relational Mapping Database)，此外还提供一种轻量级偏好数据库(Light Weight Preference Database)，用以满足开发人员使用不同数据模型对应用数据进行持久化和访问的需求。

2.2 -> 分布式数据服务

分布式数据库支持用户数据跨设备相互同步，为用户提供在多种终端设备上一致的数据访问体验。通过调用分布式数据接口，应用可以将数据保存到分布式数据库中。通过结合帐号、应用唯一标识和数据库三元组，分布式数据库对属于不同应用的数据进行隔离。

2.3 -> 分布式文件服务

在多个终端设备间为单个设备上应用程序创建的文件提供多终端的分布式共享能力。每台设备上都存储一份全量的文件元数据，应用程序通过文件元数据中的路径，可以实现同一应用文件的跨设备访问。

2.4 -> 数据搜索服务

在单个设备上，为应用程序提供搜索引擎级的全文索引管理、建立索引和搜索功能。

2.5 -> 数据存储管理

为应用开发者提供系统存储路径、存储设备列表，存储设备属性的查询和管理功能。

3 -> 应用安全管理

3.1 -> 应用开发准备阶段

1. 依据国家《移动互联网应用程序信息服务管理规定》，同时为了促进生态健康有序发展，保护应用开发者和用户的合法权益，需要每一位HarmonyOS开发者注册账号，并建议同步进行实名认证。实名认证包括个人开发者实名认证和企业开发者实名认证，没有完成实名认证的开发者，无法进行应用上架发布。
2. 建议使用官方渠道下载的开发工具。
3. 在发布HarmonyOS应用前，可以在本地进行应用调试。HarmonyOS通过数字证书和Profile文件对应用进行管控，只有经过签名的HAP才允许安装到设备上运行。

3.2 -> 应用开发调试阶段

3.2.1 -> 编码安全

• 避免不对外交互的Ability可以被其他应用直接访问。
• 避免带有敏感功能公共事件可以被其他应用直接访问。
• 避免通过隐式方式进行调用组件，防止组件劫持。
• 避免通过隐式方式发送公共事件，防止公共事件携带的数据被劫持。
• 应用作为数据使用方需校验数据提供方的身份，防止被仿冒进行攻击。
• 对跨信任边界传入的Intent须进行合法性判断，防止应用异常崩溃。
• 避免在配置文件中开启应用备份和恢复开关。
• 避免将敏感数据存放到剪贴板中。
• 避免将敏感数据写入公共数据库、存储区中。
• 避免直接使用不可信数据来拼接SQL语句。
• 避免向可执行函数传递不可信数据。
• 避免使用Socket方式进行本地通信，如需使用，localhost端口号随机生成，并对端口连接对象进行身份认证和鉴权。
• 建议使用Https代替Http进行通信，并对Https证书进行严格校验。
• 建议使用校验机制保证WebView在加载网站服务时URL地址的合法性。
• 对于涉及支付及高保密数据的应用，建议进行手机root环境监测。
• 建议开启安全编译选项，增加应用分析逆向难度。
• 禁止应用执行热更新操作，应用更新可以通过应用市场上架来完成。
• 建议应用在开发阶段进行自测试。

3.2.2 -> 权限使用

• 应用申请的权限，都必须有明确、合理的使用场景和功能说明，确保用户能够清晰明了地知道申请权限的目的、场景、用途；禁止诱导、误导用户授权；应用使用权限必须与申请所述一致。
• 应用权限申请遵循最小化原则，只申请业务功能所必要的权限，禁止申请不必要的权限。
• 应用在首次启动时，避免频繁弹窗申请多个敏感权限；敏感权限须在用户使用对应业务功能时动态申请。
• 用户拒绝授予某个权限时，与此权限无关的其他业务功能应能正常使用，不能影响应用的正常注册或登录。
• 业务功能所需要的权限被用户拒绝且禁止后不再提示，当用户主动触发使用此业务功能或为实现业务功能所必须时，应用程序可通过界面内文字引导，让用户主动到“系统设置”中授权。
• 非系统应用自定义权限名，禁止使用系统权限名前缀(如: 以ohos开头为系统权限)，建议以应用包名或公司反域名为前缀，防止与系统或其他应用定义的权限重名。

3.3 -> 应用发布分发阶段

应用调试完毕后，可以进行打包HarmonyOS应用，在AGC提交上架申请。为了确保HarmonyOS应用的完整性，确保提交应用的开发者身份合法，HarmonyOS通过数字证书和Profile文件对应用进行管控。上架到华为应用市场的APP必须通过签名才允许上架。因此，为了保证应用能够顺利发布，需要提前申请相应的发布证书与发布Profile。

提交发布申请后，应用市场将对应用进行安全审核，包括权限、隐私、安全等，如果审核不通过则不能上架；应用发布成功后，华为应用市场会对上架应用进行重签名，原有的应用签名将被替换为新签名。

感谢各位大佬支持！！！

互三啦！！！