diff --git a/zh-cn/application-dev/reference/apis/js-apis-system-device.md b/zh-cn/application-dev/reference/apis/js-apis-system-device.md index b514f2afb2d0847419ac7615946a48b5ceb97f88..06733e52e5d62efd82e55f0afbfaf5fe32384447 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-system-device.md +++ b/zh-cn/application-dev/reference/apis/js-apis-system-device.md @@ -62,7 +62,6 @@ getInfo(options?: GetDeviceOptions): void | screenDensity4+ | number | 屏幕密度。 | | screenShape4+ | string | 屏幕形状。可取值:
- rect:方形屏;
- circle:圆形屏。 | | apiVersion4+ | number | 系统API版本号。 | -| releaseType4+ | string | 版本发布类型,值为类型+版本号,如Beta1。
类型可能值有:
- Canary:同一apiVersion下,canary版本之间保持API兼容,beta版本不对canary版本兼容。
- Beta:同一apiVersion下,beta版本之间保持API兼容,release版本不对beta版本兼容。
- Release:release版本会保持5个API版本兼容。 | | deviceType4+ | string | 设备类型。 | diff --git a/zh-cn/contribute/template/js-template.md b/zh-cn/contribute/template/js-template.md index ff323eff8e1797a33174e98fb6b0952d37bd1a84..ca660877a784b4d9ff25ce7d661debd33eec0e54 100644 --- a/zh-cn/contribute/template/js-template.md +++ b/zh-cn/contribute/template/js-template.md @@ -13,7 +13,7 @@ | 5 | 文档结构 | - 模块说明
- 起始版本说明
- 导入模块/使用说明
- 接口(属性、常量、方法、枚举、自定义类型)
描述顺序和代码保持一致,如果某些接口具有逻辑顺序,请注意排列。 | | 6 | 接口版本说明 | 1. 每个模块要有起始版本说明,使用引用语法“>”对接口的起始版本进行说明。接口没有标记的,默认与模块同一个起始版本。
2. 已有模块新增接口使用\标签标记对应版本号。写法:`版本号+`
例如`7+`
示例:API 6已有的模块,在API 7新增了一个属性字段,则在属性后加标记,即newAttribute7+
如果新增了一个方法,则在方法标题后增加标记,即 sim.getSimIccId7+,interface、class、枚举等同理。 | | 7 | 废弃接口说明 | 废弃内容不能直接删去,上标标注(deprecated),起始版本和废弃版本均使用引用语法“>”说明。
示例:abandonmentMethod(deprecated)
> 从API version 4 开始支持,从API version 7 开始废弃,建议使用[newMethod]\(#newmethod)替代。| -| 8 | 权限说明 | 与代码保持一致,下沉到各个方法、枚举、属性字段中。
1. 如果仅系统应用可申请,格式:
**需要权限:** ohos.permission.xxxx,仅系统应用可用。
2. 如果该权限所有应用可申请,格式:
**需要权限:** ohos.permission.xxxx
3. 如果该接口涉及多个权限,则采用“和、或”进行分割,格式:
**需要权限:** ohos.permission.A 和 ohos.permission.B
**需要权限:** ohos.permission.A 或 ohos.permission.B | +| 8 | 权限说明 | 与代码保持一致,下沉到各个方法、枚举、属性字段中。
1. 如果仅涉及一个权限,格式:
**需要权限:** ohos.permission.xxxx
2. 如果该接口涉及多个权限,则采用“和、或”进行分割,格式:
**需要权限:** ohos.permission.A 和 ohos.permission.B
**需要权限:** ohos.permission.A 或 ohos.permission.B | | 9 | @syscap | 1. 每个方法都需要进行描述,格式:
**系统能力**:SystemCapability.xxx.xxx
2. 每个表格(属性、枚举、常量、变量)可统一进行说明,分两种情况:
1)每个表格下系统能力无差异的,同方法的写法:
**系统能力**:SystemCapability.xxx.xxx
2)有差异的:在每一个表格项里进行描述。 | | 10 | @system api | 1. 如果某个模块全部接口均为system api,则在模块开头的版本说明下一行,增加:
- 本模块接口为系统接口。
2. 如果某个接口为system api,仅供OEM厂商使用,则需要在描述中增加:
**系统接口:** 此接口为系统接口。 | | 11 | @FAModelOnly
@StageModelOnly | 1. 如果某个模块均只针对某模型实现,则在模块开头的版本说明下一行,增加:
- 本模块接口仅可在FA模型/Stage模型下使用。
2. 如果某个接口只针对某模型实现,则需要在描述中增加:
**模型约束:** 此接口仅可在FA模型/Stage模型下使用。 | @@ -153,7 +153,7 @@ import call from '@ohos.telephony.call'; **系统接口**:此接口为系统接口。(如不涉及可删除) -**需要权限**:ohos.permission.xxx(如不涉及可删除,如果是系统权限要说明) +**需要权限**:ohos.permission.xxx(如不涉及可删除) **系统能力**:SystemCapability.xxx.xxx(必选) @@ -218,7 +218,7 @@ import call from '@ohos.telephony.call'; **系统接口**:此接口为系统接口。(如不涉及可删除) -**需要权限**:ohos.permission.xxx(如不涉及可删除,如果是系统权限要说明) +**需要权限**:ohos.permission.xxx(如不涉及可删除) **系统能力**:SystemCapability.xxx.xxx(必选)