• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# deviceConfig内部结构
2
3
4deviceConfig包含设备上的应用配置信息,可以包含default,tv,car,wearable等属性。default标签内的配置适用于所有通用设备,其他设备类型如果有特殊的需求,则需要在该设备类型的标签下进行配置。
5
6## deviceConfig对象内部结构
7
8**表1** **deviceConfig对象内部结构说明**
9
10| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
11| -------- | -------- | -------- | -------- |
12| default | 能够使用全部系统能力的OpenHarmony设备。 | 对象 | 可缺省,缺省值为空。 |
13| tablet | 标识平板的应用配置信息。 | 对象 | 可缺省,缺省值为空。 |
14| tv | 标识智慧屏特有的应用配置信息。 | 对象 | 可缺省,缺省值为空。 |
15| car | 标识车机特有的应用配置信息。 | 对象 | 可缺省,缺省值为空。 |
16| wearable | 标识智能穿戴特有的应用配置信息。 | 对象 | 可缺省,缺省值为空。 |
17
18
19上表中各类设备对象的内部结构说明请见表2。
20
21## deviceConfig设备对象内部结构
22
23**表2** **deviceConfig设备对象内部结构说明**
24
25| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
26| -------- | -------- | -------- | -------- |
27| process | 标识应用或者Ability的进程名。如果在deviceConfig标签下配置了process标签,则该应用的所有Ability都运行在这个进程中。如果在abilities标签下也为某个Ability配置了process标签,则该Ability就运行在这个进程中。该标签最大长度为31。 | 字符串 | 可缺省,缺省值为空。 |
28| keepAlive | 标识应用是否始终保持运行状态,仅支持系统应用配置,三方应用配置不生效。该标签为布尔类型,可缺省,缺省值为false,如果配置为true,应用将始终保持为运行状态,并在系统启动的时候被系统驱动起来,应用进程退出后,系统也会重新启动应用进程。 | 布尔值 | 可缺省,缺省值为false。 |
29| supportBackup | 标识应用是否支持备份和恢复。如果配置为"false",则不支持为该应用执行备份或恢复操作。 | 布尔值 | 可缺省,缺省值为false。 |
30| compressNativeLibs | 标识libs库是否以压缩存储的方式打包到HAP。如果配置为"false",则libs库以不压缩的方式存储,HAP在安装时无需解压libs,运行时会直接从HAP内加载libs库。 | 布尔值 | 可缺省,缺省值为false。 |
31| network | 标识网络安全性配置。该标签允许应用通过配置文件的安全声明来自定义其网络安全,无需修改应用代码。 | 对象 | 可缺省,缺省值为空。 |
32
33## network对象的内部结构
34
35**表3** **network对象的内部结构说明**
36
37| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
38| -------- | -------- | -------- | -------- |
39| cleartextTraffic | 标识是否允许应用使用明文网络流量(例如,明文HTTP)。<br/>true:允许应用使用明文流量的请求。false:拒绝应用使用明文流量的请求。 | 布尔值 | 可缺省,缺省值为false。 |
40| securityConfig | 标识应用的网络安全配置信息。 | 对象 | 可缺省,缺省为空。 |
41
42## securityConfig对象的内部结构
43
44**表4** **securityConfig对象的内部结构说明**
45
46| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
47| -------- | -------- | -------- | -------- |
48| domainSettings | 标识自定义的网域范围的安全配置,支持多层嵌套,即一个domainSettings对象中允许嵌套更小网域范围的domainSettings对象。 | 对象类型 | 可缺省,缺省为空。 |
49
50## domainSettings对象内部结构
51
52**表5** **domainSettings对象内部结构说明**
53
54| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
55| -------- | -------- | -------- | -------- |
56| cleartextPermitted | 标识自定义的网域范围内是否允许明文流量传输。当cleartextTraffic和security同时存在时,自定义网域是否允许明文流量传输以cleartextPermitted的取值为准。true:允许明文流量传输。false:拒绝明文流量传输。 | 布尔类型 | 可缺省,缺省值为空。 |
57| domains | 标识域名配置信息,包含两个参数:subdomains和name。subdomains(布尔类型):表示是否包含子域名。如果为"true",此网域规则将与相应网域及所有子网域(包括子网域的子网域)匹配。否则,该规则仅适用于精确匹配项。name(字符串):表示域名名称。 | 对象数组 | 可缺省,缺省值为空。 |
58
59deviceConfig示例
60
61```json
62"deviceConfig": {
63  "default": {
64    "process": "com.example.test.example",
65    "supportBackup": false,
66    "network": {
67      "cleartextTraffic": true,
68      "securityConfig": {
69        "domainSettings": {
70          "cleartextPermitted": true,
71          "domains": [
72            {
73              "subdomains": true,
74              "name": "example.ohos.com"
75            }
76          ]
77        }
78      }
79    }
80  }
81}
82```
83