20 Commits

Author SHA1 Message Date
openharmony_ci f995021298 !5844 merge docs/battery-info-zh-cn into master
docs(ohbattery_info): 同步电池信息接口中文注释一致性

Created-by: cjw123qq
Commit-by: cjw123qq
Merged-by: openharmony_ci
Description: ## Summary

按 docs 文档内容刷新 `zh-cn/BasicServicesKit/ohbattery_info.h` 中文接口注释,保持资料一致性。仅修改注释,无接口签名变更,英文路径 `BasicServicesKit/ohbattery_info.h` 不受影响。

主要同步内容:
- 文件头 / 事件 / 枚举 / 充电类型 / 接口 @brief 描述按 docs 最新中文表述刷新
- `OH_BatteryInfo_GetCapacity` 补充使用场景与取值范围说明
- `OH_BatteryInfo_GetPluggedType` 补充使用场景与返回值说明

## Related Issue

Closes https://gitcode.com/openharmony/interface_sdk_c/issues/4581

Co-Authored-By: Agent

See merge request: openharmony/interface_sdk_c!5844
2026-08-18 22:16:52 +08:00
SnakyHY 2a75dac3d8 request/time_service 新旧文档扫描
Signed-off-by: SnakyHY <haoyun9@h-partners.com>
2026-08-14 16:24:24 +08:00
cjw123qq 3767493ed4 docs(ohbattery_info): 同步电池信息接口中文注释一致性
按 docs 文档内容刷新 zh-cn/BasicServicesKit/ohbattery_info.h 中文接口注释,保持资料一致性。英文路径 BasicServicesKit/ohbattery_info.h 不受影响。

Issue: #4581

Co-Authored-By: Agent
Signed-off-by: cjw123qq <chenjunwu4@h-partners.com>

AI[100%] Human Fixed[0%] Human[0%] AI Adopted[100%]
Co-authored-by: opencode (glm-5.2) <ai@local>
2026-08-08 10:11:08 +08:00
openharmony_ci 04814acf2c !5666 merge commonevent_c_desc_sync into master
公共事件C接口描述回刷(对照docs仓MR同步中英文)

Created-by: wangsen1994
Commit-by: wangsen1994
Merged-by: openharmony_ci
Description: ### 相关的Issue

#4429

### 原因(目的、解决的问题等)

docs 仓公共事件相关中文资料已修改(MR !153287/!156408)并完成英文翻译(MR !154911/!157063),需将对应中英文描述回刷到 SDK C 接口代码,使 SDK 接口描述与 docs 仓最新资料保持一致。

### 描述(做了什么,变更了什么)

对照 docs 仓上述 MR 的资料变更,将公共事件 C 接口 oh_commonevent.h(中英文各一份,共 2 个文件)的 Doxygen 注释描述回刷为与 docs 最新内容一致:
- 仅修改 @brief 描述/结构体字段描述/枚举成员描述/@param与@return描述等描述文本
- 不改动 @since/@version/@library/@kit/@syscap/@addtogroup/@file 等标签
- 不改动 C 函数/结构体/枚举成员/typedef 等声明与文件结构,版权头/#ifndef 保持不变

另:移除 OH_CommonEvent_Publish 函数 @return 注释中新增错误码 COMMONEVENT_ERR_NOT_SYSTEM_SERVICE 的返回说明(中英文各一处),属非兼容变更。

涉及文件:
- BasicServicesKit/commonevent/oh_commonevent.h
- zh-cn/BasicServicesKit/commonevent/oh_commonevent.h

### 自检结果(结果截图添加到下面)
- [x] 是否通过C语法扫描
- [x] 是否通过注释规则扫描
- [x] 是否更新json文件
- [x] 实现代码是否已经合入
- [x] 目标是否已经添加到interface/sdk_c仓ndk依赖目标(ndk_targets.gni)里
- [x] 头文件library声明与SDK so库名称一致

### 兼容性影响评估,如有影响请写明(Y/N)
- [x] Y 不兼容(OH_CommonEvent_Publish @return 返回错误码列表移除 COMMONEVENT_ERR_NOT_SYSTEM_SERVICE 说明,文档化契约变更)
  - [ ] 是否经过评审

### L0新增用例自检结果
- [ ] 是,有新增L0用例,且完成自检
- [x] 否

### API参考文档影响评估(提供docs仓pr链接)
- [x] 是,已刷新API参考文档
- https://gitcode.com/openharmony/docs/pull/153287
- https://gitcode.com/openharmony/docs/pull/156408
- https://gitcode.com/openharmony/docs/pull/154911
- https://gitcode.com/openharmony/docs/pull/157063

See merge request: openharmony/interface_sdk_c!5666
2026-07-25 18:37:15 +08:00
wangsen1994 a83d66fe24 移除OH_CommonEvent_Publish返回说明中的NOT_SYSTEM_SERVICE错误码(非兼容)
OH_CommonEvent_Publish 函数 @return 注释中移除新增错误码 COMMONEVENT_ERR_NOT_SYSTEM_SERVICE 的返回说明(中英文各一处),属非兼容变更(文档化的返回错误码列表变更)。

涉及文件:
- BasicServicesKit/commonevent/oh_commonevent.h
- zh-cn/BasicServicesKit/commonevent/oh_commonevent.h

Signed-off-by: wangsen1994 <wangsen51@huawei.com>
2026-07-25 14:16:48 +08:00
wangsen1994 8bb22ec4e0 公共事件C接口描述回刷(对照docs仓MR同步中英文)
对照 docs 仓资料变更(中文修改 MR !153287/!156408,英文翻译 MR !154911/!157063),将公共事件 C 接口 oh_commonevent.h(中英文各一份)的 Doxygen 注释描述回刷为与 docs 最新内容一致:
- 仅修改 @brief 描述/结构体字段描述/枚举成员描述/@param与@return描述等描述文本
- 不改动 @since/@version/@library/@kit/@syscap/@addtogroup/@file 等标签
- 不改动 C 函数/结构体/枚举成员/typedef 等声明与文件结构,版权头/#ifndef 保持不变

涉及文件:
- BasicServicesKit/commonevent/oh_commonevent.h
- zh-cn/BasicServicesKit/commonevent/oh_commonevent.h

对应 docs 仓 PR:
- https://gitcode.com/openharmony/docs/pull/153287
- https://gitcode.com/openharmony/docs/pull/156408
- https://gitcode.com/openharmony/docs/pull/154911
- https://gitcode.com/openharmony/docs/pull/157063

Signed-off-by: wangsen1994 <wangsen51@huawei.com>
2026-07-24 14:15:45 +08:00
zhaobaoxin d14dccb93d update
Signed-off-by: zhaobaoxin <zhaobaoxin1@huawei.com>
Change-Id: I5cf134fb833bd33d577d76e8f7823ed99a591984
2026-07-23 11:11:13 +08:00
zhenghui25 8e5e8a07d6 CAPI遗留问题处理
Signed-off-by: zhenghui25 <zhenghui25@h-partners.com>
2026-06-08 19:01:34 +08:00
openharmony_ci 94056a28ac !5046 merge pr_5044 into master
SR20260116787689 API注释和API参考文档一致性整改

Created-by: laijian
Commit-by: laijian
Merged-by: openharmony_ci
Description: ### 相关的Issue


### 原因(目的、解决的问题等)
SR20260116787689 API注释和API参考文档一致性整改

### 描述(做了什么,变更了什么)
SR20260116787689 API注释和API参考文档一致性整改

### 自检结果(结果截图添加到下面)
- [ ] 是否通过C语法扫描
- [x] 是否通过注释规则扫描
- [ ] 是否更新json文件
- [ ] 实现代码是否已经合入
- [ ] 目标是否已经添加到interface/sdk_c仓ndk依赖目标(ndk_targets.gni)里
- [x] 头文件library声明与SDK so库名称一致

### 兼容性影响评估,如有影响请写明(Y/N)
- [ ] 不兼容
  - [x] 是否经过评审

### L0新增用例自检结果
- [ ] 是,有新增L0用例,且完成自检
- [x] 否

### API参考文档影响评估(提供docs仓pr链接)
- [ ] 是,已刷新API参考文档
- [x] 否,不涉及刷新API参考文档

See merge request: openharmony/interface_sdk_c!5046
2026-06-01 11:10:25 +08:00
laijian 797997fd53 SR20260116787689 API注释和API参考文档一致性整改
Signed-off-by: laijian <laijian2@h-partners.com>
2026-05-29 14:59:22 +08:00
wangyantian 0e2df0bb4c fix: sync ohbattery_info.h descriptions with doc
Align header file descriptions with capi-ohbattery-info-h.md:
- EN: GetPluggedType PLUGGED_TYPE_NONE return condition changed from
  "if there is no power supply" to "if the power supply is removed"
- ZH: GetCapacity description changed from "返回当前电池容量" to
  "返回当前电池容量百分比"

Co-Authored-By: Agent
Signed-off-by: wangyantian <wangyantian@huawei.com>
Change-Id: I09fe9df5c3a754dd89bb35e84800cab663bfb019
2026-05-22 09:47:52 +08:00
SnakyHY f939db27ce time service API参考与注释一致性回刷
Signed-off-by: SnakyHY <haoyun9@h-partners.com>
Change-Id: Ic066403d0dda95ae7353f212a9096e729a9d0864
2026-05-18 14:45:44 +08:00
openharmony_ci 3ccf8ca2ad !5125 merge master into master
fix link reference format in battery info

Created-by: wangyantian0
Commit-by: wangyantian
Merged-by: openharmony_ci
Description: ### 相关的Issue
https://gitcode.com/openharmony/interface_sdk_c/issues/3974

### 原因(目的、解决的问题等)


### 描述(做了什么,变更了什么)


### 自检结果(结果截图添加到下面)
- [ ] 是否通过C语法扫描
- [ ] 是否通过注释规则扫描
- [ ] 是否更新json文件
- [ ] 实现代码是否已经合入
- [ ] 目标是否已经添加到interface/sdk_c仓ndk依赖目标(ndk_targets.gni)里
- [ ] 头文件library声明与SDK so库名称一致

### 兼容性影响评估,如有影响请写明(Y/N)
- [ ] 不兼容
  - [ ] 是否经过评审

### L0新增用例自检结果
- [ ] 是,有新增L0用例,且完成自检
- [ ] 否

### API参考文档影响评估(提供docs仓pr链接)
- [ ] 是,已刷新API参考文档
- [ ] 否,不涉及刷新API参考文档

See merge request: openharmony/interface_sdk_c!5125
2026-05-15 16:13:41 +08:00
zhenghui25 f3b2f304c2 API注释和API参考文档一致性整改
Signed-off-by: zhenghui25 <zhenghui25@h-partners.com>
2026-05-12 22:07:52 +08:00
wangyantian 35b9821825 fix link reference format in battery info
- Add full enum type prefix to link references
- Improve documentation consistency

Co-Authored-By: Agent
Signed-off-by: wangyantian <wangyantian@huawei.com>
2026-05-12 14:58:34 +08:00
wangyantian e75bdd94bf translate battery info comments to Chinese
- Update Chinese documentation in zh-cn/BasicServicesKit/ohbattery_info.h
- Replace English comments with official Chinese translations

Co-Authored-By: Agent
Signed-off-by: wangyantian <wangyantian@huawei.com>
2026-05-11 18:27:52 +08:00
wangyantian eaae8f35aa improve battery info documentation and add Chinese version
- Refine English documentation in ohbattery_info.h
- Improve code formatting and readability
- Add Chinese documentation version in zh-cn/BasicServicesKit/

Co-Authored-By: Agent
Signed-off-by: wangyantian <wangyantian@huawei.com>
2026-05-11 17:57:27 +08:00
CheerfulRicky 98eb0a4ef0 fix different issue
Signed-off-by: CheerfulRicky <yuegang7@h-partners.com>
Change-Id: I0fce053382ac28db7ed2158cbeb43cfed5a01c5f
2026-05-07 14:35:18 +08:00
CheerfulRicky 72fbc543c3 fix C api related issue
Signed-off-by: CheerfulRicky <yuegang7@h-partners.com>
Change-Id: Icb990c1fb70a88052523a8ea930d6fddd2ead568
2026-05-06 11:05:31 +08:00
cheerful_ricky 44dcf4b094 CAPI一致性回刷
Signed-off-by: cheerful_ricky <yuegang7@h-partners.com>
Change-Id: I0e9014506067b99bb2ac62a9e542a0aca56de76a
2026-04-28 14:21:21 +08:00