Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
9c3bbb09
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
9c3bbb09
编写于
9月 02, 2022
作者:
O
openharmony_ci
提交者:
Gitee
9月 02, 2022
浏览文件
操作
浏览文件
下载
差异文件
!9000 更改完善 配置清单资料内容
Merge pull request !9000 from junyi233/myfeature
上级
c894956b
c8068ff2
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
34 addition
and
30 deletion
+34
-30
zh-cn/application-dev/quick-start/stage-structure.md
zh-cn/application-dev/quick-start/stage-structure.md
+34
-30
未找到文件。
zh-cn/application-dev/quick-start/stage-structure.md
浏览文件 @
9c3bbb09
...
...
@@ -176,7 +176,7 @@ hap包的配置信息,该标签下的配置只对当前hap包生效。
| type | 该标签标识当前hap的类型。类型有三种,分别是entry、feature和har。 | 字符串 | 该标签不可缺省。 |
| srcEntrance | 该标签标识hap所对应的入口js代码路径,标签值为字符串(最长为127字节)。 | 字符串 | 该标签可缺省。 |
| description | 该标签标识hap包的描述信息,标签值是是字符串类型或对描述内容的资源索引,以支持多语言。 | 字符串 | 该标签可缺省,缺省值为空。 |
| process | 该标签标识hap的进程名,标签值为字符串类型(最长为31个字节)。如果在hap标签下配置了process,该应用的所有ability都运行在该进程中。 | 字符串 | 可缺省,缺省为
hap的名称。
|
| process | 该标签标识hap的进程名,标签值为字符串类型(最长为31个字节)。如果在hap标签下配置了process,该应用的所有ability都运行在该进程中。 | 字符串 | 可缺省,缺省为
app标签下的bundleName。
|
| mainElement | 该标签标识hap的入口ability名称或者extension名称。只有配置为mainElement的ability或者extension才允许在服务中心露出。创建OpenHarmony原子化服务时,该标签不可缺省。 | 字符串 | OpenHarmony应用下,该标签可缺省。 |
| deviceTypes | 该标签标识hap可以运行在哪类设备上,标签值采用字符串数组的表示,系统预定义的设备类型见表4。
<br
/>
与syscap不同的是,deviceTypes是以设备类型为粒度,而syscap是以设备能力(例如蓝牙、wifi)为粒度。 | 字符串数组 | 该标签不可缺省,可以为空值。 |
| deliveryWithInstall | 该标签标识当前hap是否在用户主动安装的时候安装,true表示主动安装时安装,false表示主动安装时不安装。 | 布尔值 | 该标签不可缺省。 |
...
...
@@ -453,7 +453,7 @@ skills示例
| uri | 该标签标识ability提供的数据uri,为字符数组类型(最大长度255),用反向域名的格式表示。该标签在type为dataShare类型的extensionAbility时,不可缺省。 | 字符串 | 该标签可缺省,缺省值为空。 |
| skills | 该标签标识ability能够接收的意图的特征集,为数组格式。
<br
/>
配置规则 : entry包可以配置多个具有入口能力的skills标签(配置了action.system.home和entity.system.home)的ability,其中第一个配置了skills标签的ability中的label和icon作为OpenHarmony服务或应用的label和icon。
<br/>
OpenHarmony服务的Feature包不能配置具有入口能力的skills标签。
<br/>
OpenHarmony应用的Feature包可以配置具有入口能力的skills标签。
<br
/>
skills内部结构参考
[
skills对象内部结构
](
#skills对象内部结构
)
。 | 数组 | 该标签可缺省,缺省值为空。 |
| metadata | 该标签标识extensionAbility的元信息。metadata内部结构参考
[
metadata对象内部结构
](
#metadata对象内部结构
)
。 | 对象 | 该标签可缺省,缺省值为空。 |
| visible | 该标签标识extensionAbility是否可以被其它应用调用,为布尔类型。true表示可以被其它应用调用, false表示不可以被其它应用调用。 |
| 该标签可缺省,缺省值为false。 |
| visible | 该标签标识extensionAbility是否可以被其它应用调用,为布尔类型。true表示可以被其它应用调用, false表示不可以被其它应用调用。 |
布尔值
| 该标签可缺省,缺省值为false。 |
extensionAbility示例 :
...
...
@@ -495,15 +495,15 @@ extensionAbility示例 :
表10 definePermissions定义权限字段说明
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| ---------------------- | ------------------------------------------------------------ | -------- | ------------------------ |
| name | 标识权限的名称。 | 字符串 | 不可缺省 |
| grantMode | 标识权限的授予方式,授予模式如下:
<br
/>
system_grant:安装后系统自动授予该权限。
<br
/>
user_grant:使用动态申请,用户授权后才可使用 | 字符串 | 可缺省,缺省值为
空。
|
| availableLevel | 标识权限限制门限,可选值为"system_core"、"system_basic"、"normal"。该标签有缺省值,缺省值为normal。权限范围如下:
<br
/>
system_core:系统核心权限。
<br
/>
system_basic:系统基础权限。
<br
/>
normal:普通权限。所有应用允许申请的权限。 | 字符串 | 可缺省,缺省值为"normal" |
| provisionEnable | 标识权限是否支持证书方式申请权限,包括高级别的权限,true标识需要开发者可以通过provision证书acls方式申请权限。 | 布尔值 | 可缺省,缺省值为true |
| distributedSceneEnable | 标识权限是否支持分布式场景下使用该权限。 | 布尔值 | 可缺省,缺省值为false |
| label | 标识权限的简短描述,配置为对描述内容的资源索引。 | 字符串 | 可缺省,缺省值为空 |
| description | 标识权限的详细描述,可以是表示描述内容的字符串,也可以是对描述内容的资源索引。 | 字符串 | 可缺省,缺省值为空 |
| 属性名称 | 含义 | 数据类型 | 是否可缺省
|
| ---------------------- | ------------------------------------------------------------ | -------- | ------------------------
------
|
| name | 标识权限的名称。 | 字符串 | 不可缺省
|
| grantMode | 标识权限的授予方式,授予模式如下:
<br
/>
system_grant:安装后系统自动授予该权限。
<br
/>
user_grant:使用动态申请,用户授权后才可使用 | 字符串 | 可缺省,缺省值为
system_grant。
|
| availableLevel | 标识权限限制门限,可选值为"system_core"、"system_basic"、"normal"。该标签有缺省值,缺省值为normal。权限范围如下:
<br
/>
system_core:系统核心权限。
<br
/>
system_basic:系统基础权限。
<br
/>
normal:普通权限。所有应用允许申请的权限。 | 字符串 | 可缺省,缺省值为"normal"
|
| provisionEnable | 标识权限是否支持证书方式申请权限,包括高级别的权限,true标识需要开发者可以通过provision证书acls方式申请权限。 | 布尔值 | 可缺省,缺省值为true
|
| distributedSceneEnable | 标识权限是否支持分布式场景下使用该权限。 | 布尔值 | 可缺省,缺省值为false
|
| label | 标识权限的简短描述,配置为对描述内容的资源索引。 | 字符串 | 可缺省,缺省值为空
|
| description | 标识权限的详细描述,可以是表示描述内容的字符串,也可以是对描述内容的资源索引。 | 字符串 | 可缺省,缺省值为空
|
#### requestPermissions对象内部结构
...
...
@@ -511,11 +511,11 @@ extensionAbility示例 :
表11 requestPermissions权限申请字段说明
| 属性名称 | 含义 |
**类型**
|
**取值范围**
|
**默认值**
|
**规则约束**
|
| --------- | ------------------------------------------------------------ | -------------------------------
| ----------------------------------------------------------- | --
-------------------- | ------------------------------------------------------------ |
| name | 必须,填写需要使用的权限名称。 | 字符串
| 自定义 | 无
| 未填写时,解析失败。 |
| reason | 可选,当申请的权限为user_grant权限时此字段必填。描述申请权限的原因。 | 字符串
| 使用string类资源引用。格式为
`$string: ***`
。 | 空
| user_grant权限必填,否则不允许在应用市场上架。需做多语种适配。 |
| usedScene | 可选,当申请的权限为user_grant权限时此字段必填。描述权限使用的场景和时机。场景类型有 :ability、when(调用时机)。可配置多个ability。 | abilit
y :字符串数组when :字符串 | ability :ability的名称when :inuse(使用时)、always(始终) | ability :空when :inuse | user_grant权限必填ability,可选填when。
|
| 属性名称 | 含义 |
**类型**
|
**取值范围**
|
**默认值**
|
**规则约束**
|
| --------- | ------------------------------------------------------------ | -------------------------------
--------- | ------------------------------------------------------------ |
-------------------- | ------------------------------------------------------------ |
| name | 必须,填写需要使用的权限名称。 | 字符串
| 自定义 | 无
| 未填写时,解析失败。 |
| reason | 可选,当申请的权限为user_grant权限时此字段必填。描述申请权限的原因。 | 字符串
| 使用string类资源引用。格式为
`$string: ***`
。 | 空
| user_grant权限必填,否则不允许在应用市场上架。需做多语种适配。 |
| usedScene | 可选,当申请的权限为user_grant权限时此字段必填。描述权限使用的场景和时机。场景类型有 :ability、when(调用时机)。可配置多个ability。 | abilit
ies:ability字符串数组,when:字符串 | abilities:ability的名称,when:inuse(使用时)、always(始终) | abilities:空 when:空 | user_grant权限必填abilities,可选填when。
|
requestPermissions示例 :
...
...
@@ -546,20 +546,22 @@ forms标签标识卡片的配置,form卡片是可以嵌入桌面上并接收
表12 forms对象的内部结构说明
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| ----------------- | ------------------------------------------------------------ | ---------- | ----------------------------- |
| name | 标识卡片的类名。字符串最大长度为127字节。 | 字符串 | 否 |
| description | 标识卡片的描述。取值可以是描述性内容,也可以是对描述性内容的资源索引,以支持多语言。字符串最大长度为255字节。 | 字符串 | 可缺省,缺省为空。 |
| src | 该标签标识JS卡片对应的UI代码。建议开发者通过自适应布局显示不同规格卡片,如果不同规格卡片布局相差较大,建议通过不同卡片来区分。 | 字符串 | 可缺省,缺省为空。 |
| window | 该标签标识JS卡片的自适应能力。window结构参考表12。 | 对象 | 可缺省,缺省为空。 |
| isDefault | 标识该卡片是否为默认卡片,每个Ability有且只有一个默认卡片。 true :默认卡片。 false :非默认卡片。 | 布尔值 | 否 |
| colorMode | 标识卡片的主题样式,取值范围如下 : auto :自适应。 dark :深色主题。 light :浅色主题。 | 字符串 | 可缺省,缺省值为“auto”。 |
| supportDimensions | 标识卡片支持的外观规格,取值范围 : 1
* 2 :表示1行2列的二宫格。 2 *
1 :表示2行1列的二宫格。 2
* 2 :表示2行2列的四宫格。 2 *
4 :表示2行4列的八宫格。 4
*
4 :表示4行4列的十六宫格。 | 字符串数组 | 否 |
| defaultDimension | 标识卡片的默认外观规格,取值必须在该卡片supportDimensions配置的列表中。 | 字符串 | 否 |
| updateDuration | 该标签标识卡片定时刷新的更新频率,单位为30分钟,取值为30的倍数值。卡片的最高频率为每30分钟刷新一次,和定点刷新二选一,二者都配置的情况下,定时优先。 | 数值 | 可缺省,缺省为空。 |
| metadata | 该标签标识卡片的自定义信息。metadata内部结构参考表5。 | 对象 | 可缺省,缺省为空。 |
| formConfigAbility | 该标签标识卡片调整的Ability名称。标签值为字符串类型(最长127字符)。该标签值必须满足下面的格式 :
<br/>
ability://单个ability名字
<br/>
单个ability名字必须为本应用的ability。 | 字符串 | 可缺省,缺省为空。 |
| formVisibleNotify | 该标签标识卡片是否被允许使用卡片可见性通知。标签值为true或false | 布尔值 | 该标签可缺省,默认值为false。 |
| 属性名称 | 含义 | 数据类型 | 是否可缺省 |
| ------------------- | ------------------------------------------------------------ | ---------- | ----------------------------- |
| name | 标识卡片的类名。字符串最大长度为127字节。 | 字符串 | 否 |
| description | 标识卡片的描述。取值可以是描述性内容,也可以是对描述性内容的资源索引,以支持多语言。字符串最大长度为255字节。 | 字符串 | 可缺省,缺省为空。 |
| src | 该标签标识JS卡片对应的UI代码。建议开发者通过自适应布局显示不同规格卡片,如果不同规格卡片布局相差较大,建议通过不同卡片来区分。 | 字符串 | 可缺省,缺省为空。 |
| window | 该标签标识JS卡片的自适应能力。window结构参考表12。 | 对象 | 可缺省,缺省为空。 |
| isDefault | 标识该卡片是否为默认卡片,每个Ability有且只有一个默认卡片。 true :默认卡片。 false :非默认卡片。 | 布尔值 | 否 |
| colorMode | 标识卡片的主题样式,取值范围如下 : auto :自适应。 dark :深色主题。 light :浅色主题。 | 字符串 | 可缺省,缺省值为“auto”。 |
| supportDimensions | 标识卡片支持的外观规格,取值范围 : 1
* 2 :表示1行2列的二宫格。 2 *
1 :表示2行1列的二宫格。 2
* 2 :表示2行2列的四宫格。 2 *
4 :表示2行4列的八宫格。 4
*
4 :表示4行4列的十六宫格。 | 字符串数组 | 否 |
| defaultDimension | 标识卡片的默认外观规格,取值必须在该卡片supportDimensions配置的列表中。 | 字符串 | 否 |
| updateEnabled | 该标签标识该卡片是否支持实时刷新,true标识卡片支持实时刷新,false标识不支持。 | 布尔值 | 否 |
| scheduledUpdateTime | 该标签标识卡片定点刷新的时间,采用24小时计数,精确到分钟。 | 字符串 | 是 |
| updateDuration | 该标签标识卡片定时刷新的更新频率,单位为30分钟,取值为30的倍数值。卡片的最高频率为每30分钟刷新一次,和定点刷新二选一,二者都配置的情况下,定时优先。 | 数值 | 可缺省,缺省为空。 |
| metadata | 该标签标识卡片的自定义信息。metadata内部结构参考表5。 | 对象 | 可缺省,缺省为空。 |
| formConfigAbility | 该标签标识卡片调整的Ability名称。标签值为字符串类型(最长127字符)。该标签值必须满足下面的格式 :
<br/>
ability://单个ability名字
<br/>
单个ability名字必须为本应用的ability。 | 字符串 | 可缺省,缺省为空。 |
| formVisibleNotify | 该标签标识卡片是否被允许使用卡片可见性通知。标签值为true或false | 布尔值 | 该标签可缺省,默认值为false。 |
表13 window内部结构说明
...
...
@@ -591,6 +593,8 @@ form示例 :
"scheduledUpdateTime"
:
"10:30"
,
"updateDuration"
:
1
,
"defaultDimension"
:
"2*2"
,
"updateEnabled"
:
true
,
"scheduledUpdateTime"
:
"21:33"
,
"supportDimensions"
:
[
"2*2"
],
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录