提交 5b331512 编写于 作者: Z zengyawen

LTS3.0 update docs

Signed-off-by: Nzengyawen <zengyawen1@huawei.com>
上级 16677384
# 应用开发导读<a name="ZH-CN_TOPIC_0000001123678714"></a>
# 应用开发导读<a name="ZH-CN_TOPIC_0000001162242674"></a>
应用开发文档用于指导开发者通过OpenHarmony提供的接口完成应用开发。当前应用开发文档提供了在标准系统上开发应用的JS接口。
在这部分中,开发者可以通过“[入门](quick-start/Readme-CN.md)”来了解应用开发的基本方法。完整的接口清单和参考使用指导可参见“[JS参考规范](js-reference/Readme-CN.md)”。
在这部分中,开发者可以通过“[入门](https://gitee.com/openharmony/docs/blob/5b6b26c33680dd1162a4df35c896e5ddefcb55b3/zh-cn/application-dev/quick-start/Readme-CN.md)”来了解应用开发的基本方法。完整的接口清单和参考使用指导可参见“[JS开发参考](https://gitee.com/openharmony/docs/blob/5b6b26c33680dd1162a4df35c896e5ddefcb55b3/zh-cn/application-dev/js-reference/Readme-CN.md)”。
除此之外,为方便开发者对常用功能进行深入理解,还提供了[UI](ui/Readme-CN.md)[媒体](media/Readme-CN.md)[网络与连接](connectivity/Readme-CN.md)三个模块的开发指南。
除此之外,为方便开发者对常用功能进行深入理解,还提供了[UI](https://gitee.com/openharmony/docs/blob/5b6b26c33680dd1162a4df35c896e5ddefcb55b3/zh-cn/application-dev/ui/Readme-CN.md)[媒体](https://gitee.com/openharmony/docs/blob/5b6b26c33680dd1162a4df35c896e5ddefcb55b3/zh-cn/application-dev/media/Readme-CN.md)[网络与连接](https://gitee.com/openharmony/docs/blob/5b6b26c33680dd1162a4df35c896e5ddefcb55b3/zh-cn/application-dev/connectivity/Readme-CN.md)三个模块的开发指南。
如果需要了解各子系统的原理和基本信息,可以参考“docs/zh-cn/readme”目录中各子系统readme的介绍。
# IPC与RPC通信<a name="ZH-CN_TOPIC_0000001157385969"></a>
- **[IPC与RPC通信概述](IPC与RPC通信概述.md)**
- **[IPC与RPC通信开发指导](IPC与RPC通信开发指导.md)**
- **[远端状态订阅开发实例](远端状态订阅开发实例.md)**
# 网络与连接
- [IPC与RPC通信](IPC与RPC通信.md)
- [IPC与RPC通信概述](IPC与RPC通信概述.md)
- [IPC与RPC通信开发指导](IPC与RPC通信开发指导.md)
- [远端状态订阅开发实例](远端状态订阅开发实例.md)
- [IPC与RPC通信](ipc-rpc.md)
- [IPC与RPC通信概述](ipc-rpc-overview.md)
- [IPC与RPC通信开发指导](ipc-rpc-development-guideline.md)
- [远端状态订阅开发实例](subscribe-remote-state.md)
# IPC与RPC通信<a name="ZH-CN_TOPIC_0000001157385969"></a>
- **[IPC与RPC通信概述](ipc-rpc-overview.md)**
- **[IPC与RPC通信开发指导](ipc-rpc-development-guideline.md)**
- **[远端状态订阅开发实例](subscribe-remote-state.md)**
此差异已折叠。
# Image对象<a name="ZH-CN_TOPIC_0000001115974752"></a>
- [属性](#zh-cn_topic_0000001058948927_section1968021961113)
- [示例](#zh-cn_topic_0000001058948927_section13457717134912)
图片对象。
## 属性<a name="zh-cn_topic_0000001058948927_section1968021961113"></a>
<a name="zh-cn_topic_0000001058948927_table1025010619328"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001058948927_row163667603219"><th class="cellrowborder" valign="top" width="21.8%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001058948927_p536646193210"><a name="zh-cn_topic_0000001058948927_p536646193210"></a><a name="zh-cn_topic_0000001058948927_p536646193210"></a>属性</p>
</th>
<th class="cellrowborder" valign="top" width="22.34%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001058948927_p7366166163213"><a name="zh-cn_topic_0000001058948927_p7366166163213"></a><a name="zh-cn_topic_0000001058948927_p7366166163213"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="7.9799999999999995%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001058948927_p143661564327"><a name="zh-cn_topic_0000001058948927_p143661564327"></a><a name="zh-cn_topic_0000001058948927_p143661564327"></a>默认值</p>
</th>
<th class="cellrowborder" valign="top" width="11.73%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001058948927_p11366264324"><a name="zh-cn_topic_0000001058948927_p11366264324"></a><a name="zh-cn_topic_0000001058948927_p11366264324"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="36.15%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001058948927_p636619618325"><a name="zh-cn_topic_0000001058948927_p636619618325"></a><a name="zh-cn_topic_0000001058948927_p636619618325"></a>描述</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001058948927_row936656193210"><td class="cellrowborder" valign="top" width="21.8%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001058948927_p1436610643211"><a name="zh-cn_topic_0000001058948927_p1436610643211"></a><a name="zh-cn_topic_0000001058948927_p1436610643211"></a>src</p>
</td>
<td class="cellrowborder" valign="top" width="22.34%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001058948927_p4366156183210"><a name="zh-cn_topic_0000001058948927_p4366156183210"></a><a name="zh-cn_topic_0000001058948927_p4366156183210"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="7.9799999999999995%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001058948927_p193667616322"><a name="zh-cn_topic_0000001058948927_p193667616322"></a><a name="zh-cn_topic_0000001058948927_p193667616322"></a>-</p>
</td>
<td class="cellrowborder" valign="top" width="11.73%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001058948927_p636611610320"><a name="zh-cn_topic_0000001058948927_p636611610320"></a><a name="zh-cn_topic_0000001058948927_p636611610320"></a></p>
</td>
<td class="cellrowborder" valign="top" width="36.15%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001058948927_p13366106173215"><a name="zh-cn_topic_0000001058948927_p13366106173215"></a><a name="zh-cn_topic_0000001058948927_p13366106173215"></a>图片资源的路径。。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001058948927_row13366969325"><td class="cellrowborder" valign="top" width="21.8%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001058948927_p13366136183210"><a name="zh-cn_topic_0000001058948927_p13366136183210"></a><a name="zh-cn_topic_0000001058948927_p13366136183210"></a>width</p>
</td>
<td class="cellrowborder" valign="top" width="22.34%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001058948927_p73668623216"><a name="zh-cn_topic_0000001058948927_p73668623216"></a><a name="zh-cn_topic_0000001058948927_p73668623216"></a>&lt;length&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="7.9799999999999995%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001058948927_p8366206123215"><a name="zh-cn_topic_0000001058948927_p8366206123215"></a><a name="zh-cn_topic_0000001058948927_p8366206123215"></a>0px</p>
</td>
<td class="cellrowborder" valign="top" width="11.73%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001058948927_p636617633210"><a name="zh-cn_topic_0000001058948927_p636617633210"></a><a name="zh-cn_topic_0000001058948927_p636617633210"></a></p>
</td>
<td class="cellrowborder" valign="top" width="36.15%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001058948927_p123661613324"><a name="zh-cn_topic_0000001058948927_p123661613324"></a><a name="zh-cn_topic_0000001058948927_p123661613324"></a>图片的宽度。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001058948927_row103661365321"><td class="cellrowborder" valign="top" width="21.8%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001058948927_p163663610321"><a name="zh-cn_topic_0000001058948927_p163663610321"></a><a name="zh-cn_topic_0000001058948927_p163663610321"></a>height</p>
</td>
<td class="cellrowborder" valign="top" width="22.34%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001058948927_p03673613324"><a name="zh-cn_topic_0000001058948927_p03673613324"></a><a name="zh-cn_topic_0000001058948927_p03673613324"></a>&lt;length&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="7.9799999999999995%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001058948927_p113674614326"><a name="zh-cn_topic_0000001058948927_p113674614326"></a><a name="zh-cn_topic_0000001058948927_p113674614326"></a>0px</p>
</td>
<td class="cellrowborder" valign="top" width="11.73%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001058948927_p3367566327"><a name="zh-cn_topic_0000001058948927_p3367566327"></a><a name="zh-cn_topic_0000001058948927_p3367566327"></a></p>
</td>
<td class="cellrowborder" valign="top" width="36.15%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001058948927_p43671663322"><a name="zh-cn_topic_0000001058948927_p43671663322"></a><a name="zh-cn_topic_0000001058948927_p43671663322"></a>图片的高度。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001058948927_row18346152013215"><td class="cellrowborder" valign="top" width="21.8%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001058948927_p1033772416322"><a name="zh-cn_topic_0000001058948927_p1033772416322"></a><a name="zh-cn_topic_0000001058948927_p1033772416322"></a>onload</p>
</td>
<td class="cellrowborder" valign="top" width="22.34%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001058948927_p1337202419320"><a name="zh-cn_topic_0000001058948927_p1337202419320"></a><a name="zh-cn_topic_0000001058948927_p1337202419320"></a>Function</p>
</td>
<td class="cellrowborder" valign="top" width="7.9799999999999995%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001058948927_p137953293211"><a name="zh-cn_topic_0000001058948927_p137953293211"></a><a name="zh-cn_topic_0000001058948927_p137953293211"></a>-</p>
</td>
<td class="cellrowborder" valign="top" width="11.73%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001058948927_p153471320113217"><a name="zh-cn_topic_0000001058948927_p153471320113217"></a><a name="zh-cn_topic_0000001058948927_p153471320113217"></a></p>
</td>
<td class="cellrowborder" valign="top" width="36.15%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001058948927_p7337142443214"><a name="zh-cn_topic_0000001058948927_p7337142443214"></a><a name="zh-cn_topic_0000001058948927_p7337142443214"></a>图片加载成功后触发该事件,无参数。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001058948927_row455917203329"><td class="cellrowborder" valign="top" width="21.8%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001058948927_p107821651123213"><a name="zh-cn_topic_0000001058948927_p107821651123213"></a><a name="zh-cn_topic_0000001058948927_p107821651123213"></a>onerror</p>
</td>
<td class="cellrowborder" valign="top" width="22.34%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001058948927_p147828514328"><a name="zh-cn_topic_0000001058948927_p147828514328"></a><a name="zh-cn_topic_0000001058948927_p147828514328"></a>Function</p>
</td>
<td class="cellrowborder" valign="top" width="7.9799999999999995%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001058948927_p19161175419328"><a name="zh-cn_topic_0000001058948927_p19161175419328"></a><a name="zh-cn_topic_0000001058948927_p19161175419328"></a>-</p>
</td>
<td class="cellrowborder" valign="top" width="11.73%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001058948927_p0559142083215"><a name="zh-cn_topic_0000001058948927_p0559142083215"></a><a name="zh-cn_topic_0000001058948927_p0559142083215"></a></p>
</td>
<td class="cellrowborder" valign="top" width="36.15%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001058948927_p1778212512329"><a name="zh-cn_topic_0000001058948927_p1778212512329"></a><a name="zh-cn_topic_0000001058948927_p1778212512329"></a>图片加载失败后触发该事件,无参数。</p>
</td>
</tr>
</tbody>
</table>
## 示例<a name="zh-cn_topic_0000001058948927_section13457717134912"></a>
```
var ctx = this.$element('drawImage').getContext('2d');
var img = new Image();
img.src = 'common/image/huawei.jpg';
img.onload = function() {
console.log('Image load success');
ctx.drawImage(img, 200, 200);
};
img.onerror = function() {
console.log('Image load fail');
};
```
# JS参考规范
- [框架说明](框架说明.md)
- [文件组织](文件组织.md)
- [js标签配置](js标签配置.md)
- [app.js](app-js.md)
- [语法](语法.md)
- [HML语法参考](HML语法参考.md)
- [CSS语法参考](CSS语法参考.md)
- [JS语法参考](JS语法参考.md)
- [组件](组件.md)
- [通用](通用.md)
- [组件方法](组件方法.md)
- [动画样式](动画样式.md)
- [渐变样式](渐变样式.md)
- [转场样式](转场样式.md)
- [自定义字体样式](自定义字体样式.md)
- [原子布局](原子布局.md)
- [容器组件](容器组件.md)
- [badge](badge.md)
- [dialog](dialog.md)
- [div](div.md)
- [list](list.md)
- [list-item](list-item.md)
- [list-item-group](list-item-group.md)
- [panel](panel.md)
- [popup](popup.md)
- [refresh](refresh.md)
- [stack](stack.md)
- [stepper](stepper.md)
- [stepper-item](stepper-item.md)
- [swiper](swiper.md)
- [tabs](tabs.md)
- [tab-bar](tab-bar.md)
- [tab-content](tab-content.md)
- [基础组件](基础组件.md)
- [button](button.md)
- [chart](chart.md)
- [divider](divider.md)
- [image](image.md)
- [image-animator](image-animator.md)
- [input](input.md)
- [label](label.md)
- [marquee](marquee.md)
- [menu](menu.md)
- [option](option.md)
- [picker](picker.md)
- [picker-view](picker-view.md)
- [piece](piece.md)
- [progress](progress.md)
- [qrcode](qrcode.md)
- [rating](rating.md)
- [select](select.md)
- [slider](slider.md)
- [span](span.md)
- [switch](switch.md)
- [text](text.md)
- [toolbar](toolbar.md)
- [toolbar-item](toolbar-item.md)
- [toggle](toggle.md)
- [媒体组件](媒体组件.md)
- [Camera](Camera.md)
- [画布组件](画布组件.md)
- [canvas组件](canvas组件.md)
- [CanvasRenderingContext2D对象](CanvasRenderingContext2D对象.md)
- [Image对象](Image对象.md)
- [CanvasGradient对象](CanvasGradient对象.md)
- [ImageData对象](ImageData对象.md)
- [栅格组件](栅格组件.md)
- [基本概念](基本概念.md)
- [grid-container](grid-container.md)
- [grid-row](grid-row.md)
- [grid-col](grid-col.md)
- [自定义组件](自定义组件.md)
- [基本用法](基本用法.md)
- [自定义事件](自定义事件.md)
- [Props](Props.md)
- [事件参数](事件参数.md)
- [组件通用说明](组件通用说明.md)
- [通用事件](通用事件.md)
- [通用属性](通用属性.md)
- [通用样式](通用样式.md)
- [接口](接口.md)
- [日志打印](日志打印.md)
- [应用打点](应用打点.md)
- [页面路由](页面路由.md)
- [弹窗](弹窗.md)
- [定时器](定时器.md)
- [时间设置](时间设置.md)
- [音频管理](音频管理.md)
- [音频播放](音频播放.md)
- [设备信息](设备信息.md)
- [系统属性](系统属性.md)
- [电池和充电属性](电池和充电属性.md)
- [设置系统屏幕亮度](设置系统屏幕亮度.md)
- [国际化](国际化.md)
- [资源管理](资源管理.md)
- [升级](升级.md)
- [文件管理](文件管理.md)
- [文件存储](文件存储.md)
\ No newline at end of file
# JS开发参考
- [框架说明](js-framework.md)
- [文件组织](js-framework-file.md)
- [js标签配置](js-framework-js-tag.md)
- [app.js](js-framework-js-file.md)
- [语法](js-framework-syntax.md)
- [HML语法参考](js-framework-syntax-hml.md)
- [CSS语法参考](js-framework-syntax-css.md)
- [JS语法参考](js-framework-syntax-js.md)
- [生命周期](js-framework-lifecycle.md)
- [资源限定与访问](js-framework-resource-restriction.md)
- [多语言支持](js-framework-multiple-languages.md)
- [组件](component/Readme-CN.md)
- [通用](component/js-components-common.md)
- [通用属性](component/js-components-common-attributes.md)
- [通用样式](component/js-components-common-styles.md)
- [通用事件](component/js-components-common-events.md)
- [通用方法](component/js-components-common-methods.md)
- [动画样式](component/js-components-common-animation.md)
- [渐变样式](component/js-components-common-gradient.md)
- [转场样式](component/js-components-common-transition.md)
- [媒体查询](component/js-components-common-mediaquery.md)
- [自定义字体样式](component/js-components-common-customizing-font.md)
- [原子布局](component/js-components-common-atomic-layout.md)
- [容器组件](component/js-components-container.md)
- [badge](component/js-components-container-badge.md)
- [dialog](component/js-components-container-dialog.md)
- [div](component/js-components-container-div.md)
- [form](component/js-components-container-form.md)
- [list](component/js-components-container-list.md)
- [list-item](component/js-components-container-list-item.md)
- [list-item-group](component/js-components-container-list-item-group.md)
- [panel](component/js-components-container-panel.md)
- [popup](component/js-components-container-popup.md)
- [refresh](component/js-components-container-refresh.md)
- [stack](component/js-components-container-stack.md)
- [stepper](component/js-components-container-stepper.md)
- [stepper-item](component/js-components-container-stepper-item.md)
- [swiper](component/js-components-container-swiper.md)
- [tabs](component/js-components-container-tabs.md)
- [tab-bar](component/js-components-container-tab-bar.md)
- [tab-content](component/js-components-container-tab-content.md)
- [基础组件](component/js-components-basic.md)
- [button](component/js-components-basic-button.md)
- [chart](component/js-components-basic-chart.md)
- [divider](component/js-components-basic-divider.md)
- [image](component/js-components-basic-image.md)
- [image-animator](component/js-components-basic-image-animator.md)
- [input](component/js-components-basic-input.md)
- [label](component/js-components-basic-label.md)
- [marquee](component/js-components-basic-marquee.md)
- [menu](component/js-components-basic-menu.md)
- [option](component/js-components-basic-option.md)
- [picker](component/js-components-basic-picker.md)
- [picker-view](component/js-components-basic-picker-view.md)
- [piece](component/js-components-basic-piece.md)
- [progress](component/js-components-basic-progress.md)
- [qrcode](component/js-components-basic-qrcode.md)
- [rating](component/js-components-basic-rating.md)
- [richtext](component/js-components-basic-richtext.md)
- [search](component/js-components-basic-search.md)
- [select](component/js-components-basic-select.md)
- [slider](component/js-components-basic-slider.md)
- [span](component/js-components-basic-span.md)
- [switch](component/js-components-basic-switch.md)
- [text](component/js-components-basic-text.md)
- [textarea](component/js-components-basic-textarea.md)
- [toolbar](component/js-components-basic-toolbar.md)
- [toolbar-item](component/js-components-basic-toolbar-item.md)
- [toggle](component/js-components-basic-toggle.md)
- [媒体组件](component/js-components-media.md)
- [video](component/js-components-media-video.md)
- [画布组件](component/js-components-canvas.md)
- [canvas组件](component/js-components-canvas-canvas.md)
- [CanvasRenderingContext2D对象](component/js-components-canvas-canvasrenderingcontext2d.md)
- [Image对象](component/js-components-canvas-image.md)
- [CanvasGradient对象](component/js-components-canvas-canvasgradient.md)
- [ImageData对象](component/js-components-canvas-imagedata.md)
- [Path2D对象](component/js-components-canvas-path2d.md)
- [ImageBitmap对象](component/js-components-canvas-imagebitmap.md)
- [OffscreenCanvas对象](component/js-components-canvas-offscreencanvas.md)
- [OffscreenCanvasRenderingContext2D对象](component/js-components-canvas-offscreencanvasrenderingcontext2d.md)
- [栅格组件](component/js-components-grid.md)
- [基本概念](component/js-components-grid-basic-concepts.md)
- [grid-container](component/js-components-grid-container.md)
- [grid-row](component/js-components-grid-row.md)
- [grid-col](component/js-components-grid-col.md)
- [svg组件](component/js-components-svg.md)
- [通用属性](component/js-components-svg-common-attributes.md)
- [svg](component/js-components-svg-0.md)
- [rect](component/js-components-svg-rect.md)
- [circle](component/js-components-svg-circle.md)
- [ellipse](component/js-components-svg-ellipse.md)
- [path](component/js-components-svg-path.md)
- [line](component/js-components-svg-line.md)
- [polyline](component/js-components-svg-polyline.md)
- [polygon](component/js-components-svg-polygon.md)
- [text](component/js-components-svg-text.md)
- [tspan](component/js-components-svg-tspan.md)
- [textPath](component/js-components-svg-textpath.md)
- [animate](component/js-components-svg-animate.md)
- [animateMotion](component/js-components-svg-animate-motion.md)
- [animateTransform](component/js-components-svg-animate-transform.md)
- [自定义组件](component/js-components-custom.md)
- [基本用法](component/js-components-custom-basic-usage.md)
- [自定义事件](component/js-components-custom-events.md)
- [Props](component/js-components-custom-props.md)
- [事件参数](component/js-components-custom-event-parameter.md)
- [slot插槽](component/js-components-custom-slot.md)
- [生命周期定义](component/js-components-custom-lifecycle.md)
- [接口](apis/Readme-CN.md)
- Ability框架
- [FeatureAbility模块](apis/js-apis-featureAbility.md)
- [ParticleAbility模块](apis/js-apis-particleAbility.md)
- [DataAbilityHelper模块](apis/js-apis-dataAbilityHelper.md)
- [DataUriUtils模块](apis/js-apis-DataUriUtils.md)
- [Bundle模块](apis/js-apis-Bundle.md)
- [CommonEvent模块](apis/js-apis-commonEvent.md)
- [Notification模块](apis/js-apis-notification.md)
- [Context模块](apis/js-apis-Context.md)
- [基本功能](apis/js-apis-basic-features.md)
- [应用上下文](apis/js-apis-system-app.md)
- [日志打印](apis/js-apis-basic-features-logs.md)
- [页面路由](apis/js-apis-system-router.md)
- [弹窗](apis/js-apis-system-prompt.md)
- [应用配置](apis/js-apis-system-configuration.md)
- [定时器](apis/js-apis-system-timer.md)
- [动画](apis/js-apis-animator.md)
- [应用打点](apis/js-apis-hiappevent.md)
- [性能打点](apis/js-apis-bytrace.md)
- [分布式帐号管理](apis/js-apis-distributedaccount.md)
- [媒体](apis/js-apis-multmedia.md)
- [音频管理](apis/js-apis-audio.md)
- [音频播放](apis/js-apis-media.md)
- 网络与连接
- [拨打电话](apis/js-apis-call.md)
- [短信服务](apis/js-apis-sms.md)
- [SIM卡管理](apis/js-apis-sim.md)
- [网络搜索](apis/js-apis-radio.md)
- [数据管理](apis/js-apis-data.md)
- [文件管理](apis/js-apis-fileio.md)
- [单版本分布式数据库](apis/js-apis-data-singlekvstore.md)
- [创建和获取分布式数据库](apis/js-apis-data-kvmanager.md)
- [KVManager配置信息](apis/js-apis-data-kvmanager-config.md)
- [分布式数据库操作描述](apis/js-apis-data-kvstore.md)
- [数据类型描述](apis/js-apis-data-type.md)
- [轻量级存储](apis/js-apis-data-storage.md)
- [设备管理](apis/js-apis-device-mgmt.md)
- [设备信息](apis/js-apis-deviceinfo.md)
- [系统属性](apis/js-apis-systemparameter.md)
- [系统恢复](apis/js-apis-update.md)
- [显示设备属性](apis/js-apis-display.md)
- [电池和充电属性](apis/js-apis-batteryinfo.md)
- [设置系统屏幕亮度](apis/js-apis-brightness.md)
- [系统电源管理](apis/js-apis-power.md)
- [Runninglock锁](apis/js-apis-runninglock.md)
- [传感器](apis/js-apis-sensor.md)
- [振动](apis/js-apis-vibrate.md)
- [国际化(I18n)](apis/js-apis-i18n.md)
- [国际化(Intl)](apis/js-apis-intl.md)
- [资源管理](apis/js-apis-resourcemanage.md)
- [时间设置](apis/js-apis-systemtime.md)
- [升级](apis/js-apis-libupdateclient.md)
- [获取进程相关的信息](apis/js-apis-process.md)
- [字符串编解码](apis/js-apis-util.md)
- [启动一个worker](apis/js-apis-worker.md)
- [URL字符串解析](apis/js-apis-url.md)
# 接口<a name="ZH-CN_TOPIC_0000001164290698"></a>
- Ability框架
- [FeatureAbility模块](js-apis-featureAbility.md)
- [ParticleAbility模块](js-apis-particleAbility.md)
- [DataAbilityHelper模块](js-apis-dataAbilityHelper.md)
- [DataUriUtils模块](js-apis-DataUriUtils.md)
- [Bundle模块](js-apis-Bundle.md)
- [CommonEvent模块](js-apis-commonEvent.md)
- [Notification模块](js-apis-notification.md)
- [Context模块](js-apis-Context.md)
- [基本功能](js-apis-basic-features.md)
- [应用上下文](js-apis-system-app.md)
- [日志打印](js-apis-basic-features-logs.md)
- [页面路由](js-apis-system-router.md)
- [弹窗](js-apis-system-prompt.md)
- [应用配置](js-apis-system-configuration.md)
- [定时器](js-apis-system-timer.md)
- [动画](js-apis-animator.md)
- [应用打点](js-apis-hiappevent.md)
- [性能打点](js-apis-bytrace.md)
- [分布式帐号管理](js-apis-distributedaccount.md)
- [媒体](js-apis-multmedia.md)
- [音频管理](js-apis-audio.md)
- [音频播放](js-apis-media.md)
- 网络与连接
- [拨打电话](js-apis-call.md)
- [短信服务](js-apis-sms.md)
- [SIM卡管理](js-apis-sim.md)
- [网络搜索](js-apis-radio.md)
- [数据管理](js-apis-data.md)
- [文件管理](js-apis-fileio.md)
- [单版本分布式数据库](js-apis-data-singlekvstore.md)
- [创建和获取分布式数据库](js-apis-data-kvmanager.md)
- [KVManager配置信息](js-apis-data-kvmanager-config.md)
- [分布式数据库操作描述](js-apis-data-kvstore.md)
- [数据类型描述](js-apis-data-type.md)
- [轻量级存储](js-apis-data-storage.md)
- [设备管理](js-apis-device-mgmt.md)
- [设备信息](js-apis-deviceinfo.md)
- [系统属性](js-apis-systemparameter.md)
- [系统恢复](js-apis-update.md)
- [显示设备属性](js-apis-display.md)
- [电池和充电属性](js-apis-batteryinfo.md)
- [设置系统屏幕亮度](js-apis-brightness.md)
- [系统电源管理](js-apis-power.md)
- [Runninglock锁](js-apis-runninglock.md)
- [传感器](js-apis-sensor.md)
- [振动](js-apis-vibrate.md)
- [国际化(I18n)](js-apis-i18n.md)
- [国际化(Intl)](js-apis-intl.md)
- [资源管理](js-apis-resourcemanage.md)
- [时间设置](js-apis-systemtime.md)
- [升级](js-apis-libupdateclient.md)
- [获取进程相关的信息](js-apis-process.md)
- [字符串编解码](js-apis-util.md)
- [启动一个worker](js-apis-worker.md)
- [URL字符串解析](js-apis-url.md)
# 日志打印<a name="ZH-CN_TOPIC_0000001163932220"></a>
- [导入模块](#zh-cn_topic_0000001127284842_s56d19203690d4782bfc74069abb6bd71)
- [权限列表](#zh-cn_topic_0000001127284842_section11257113618419)
- [console.debug](#zh-cn_topic_0000001127284842_s298a3cf59a3b470dbb0742706102ced7)
- [console.log](#zh-cn_topic_0000001127284842_section146351482051)
- [console.info](#zh-cn_topic_0000001127284842_section93434457711)
- [console.warn](#zh-cn_topic_0000001127284842_section1363520541678)
- [console.error](#zh-cn_topic_0000001127284842_section326012551578)
- [示例](#zh-cn_topic_0000001127284842_section738673813104)
## 导入模块<a name="zh-cn_topic_0000001127284842_s56d19203690d4782bfc74069abb6bd71"></a>
无需导入。
## 权限列表<a name="zh-cn_topic_0000001127284842_section11257113618419"></a>
## console.debug<a name="zh-cn_topic_0000001127284842_s298a3cf59a3b470dbb0742706102ced7"></a>
debug\(message: string\): void
打印debug级别的日志信息。
- 参数
<a name="zh-cn_topic_0000001127284842_t87748b0ba4e648079d53f9deccf4bfb2"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001127284842_rc5033ad045c14c2e806d59041aab002c"><th class="cellrowborder" valign="top" width="12%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001127284842_acf783ab6043e4ee1a7bb73b73a091e0b"><a name="zh-cn_topic_0000001127284842_acf783ab6043e4ee1a7bb73b73a091e0b"></a><a name="zh-cn_topic_0000001127284842_acf783ab6043e4ee1a7bb73b73a091e0b"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001127284842_a6736505551534b819d5a6376065a25f6"><a name="zh-cn_topic_0000001127284842_a6736505551534b819d5a6376065a25f6"></a><a name="zh-cn_topic_0000001127284842_a6736505551534b819d5a6376065a25f6"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001127284842_ac15c2a3de0e046af917cf09b48b3b46d"><a name="zh-cn_topic_0000001127284842_ac15c2a3de0e046af917cf09b48b3b46d"></a><a name="zh-cn_topic_0000001127284842_ac15c2a3de0e046af917cf09b48b3b46d"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="70%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001127284842_aeb94b88e78974288bab1b4940b50c840"><a name="zh-cn_topic_0000001127284842_aeb94b88e78974288bab1b4940b50c840"></a><a name="zh-cn_topic_0000001127284842_aeb94b88e78974288bab1b4940b50c840"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001127284842_r95c56d5cd62d4b518c3e7a3f158ed7fe"><td class="cellrowborder" valign="top" width="12%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001127284842_a7af41aec9a404f418202d90c61774825"><a name="zh-cn_topic_0000001127284842_a7af41aec9a404f418202d90c61774825"></a><a name="zh-cn_topic_0000001127284842_a7af41aec9a404f418202d90c61774825"></a>message</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001127284842_aed6ae868d61349afa8f0e250108f8e47"><a name="zh-cn_topic_0000001127284842_aed6ae868d61349afa8f0e250108f8e47"></a><a name="zh-cn_topic_0000001127284842_aed6ae868d61349afa8f0e250108f8e47"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001127284842_ab72ac8cc02e34da4b717ca144fc521c1"><a name="zh-cn_topic_0000001127284842_ab72ac8cc02e34da4b717ca144fc521c1"></a><a name="zh-cn_topic_0000001127284842_ab72ac8cc02e34da4b717ca144fc521c1"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001127284842_ac53e6549d32f413e9c51cd8a53f4650a"><a name="zh-cn_topic_0000001127284842_ac53e6549d32f413e9c51cd8a53f4650a"></a><a name="zh-cn_topic_0000001127284842_ac53e6549d32f413e9c51cd8a53f4650a"></a>表示要打印的文本信息。</p>
</td>
</tr>
</tbody>
</table>
## console.log<a name="zh-cn_topic_0000001127284842_section146351482051"></a>
log\(message: string\): void
打印log级别的日志信息。
- 参数
<a name="zh-cn_topic_0000001127284842_table1852992312613"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001127284842_row953019231468"><th class="cellrowborder" valign="top" width="12%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001127284842_p353020231164"><a name="zh-cn_topic_0000001127284842_p353020231164"></a><a name="zh-cn_topic_0000001127284842_p353020231164"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001127284842_p15301423361"><a name="zh-cn_topic_0000001127284842_p15301423361"></a><a name="zh-cn_topic_0000001127284842_p15301423361"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001127284842_p853022316618"><a name="zh-cn_topic_0000001127284842_p853022316618"></a><a name="zh-cn_topic_0000001127284842_p853022316618"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="70%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001127284842_p1953072310614"><a name="zh-cn_topic_0000001127284842_p1953072310614"></a><a name="zh-cn_topic_0000001127284842_p1953072310614"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001127284842_row6530823560"><td class="cellrowborder" valign="top" width="12%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001127284842_p135301231364"><a name="zh-cn_topic_0000001127284842_p135301231364"></a><a name="zh-cn_topic_0000001127284842_p135301231364"></a>message</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001127284842_p15530523265"><a name="zh-cn_topic_0000001127284842_p15530523265"></a><a name="zh-cn_topic_0000001127284842_p15530523265"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001127284842_p165301323567"><a name="zh-cn_topic_0000001127284842_p165301323567"></a><a name="zh-cn_topic_0000001127284842_p165301323567"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001127284842_p853019231265"><a name="zh-cn_topic_0000001127284842_p853019231265"></a><a name="zh-cn_topic_0000001127284842_p853019231265"></a>表示要打印的文本信息。</p>
</td>
</tr>
</tbody>
</table>
>![](../../public_sys-resources/icon-note.gif) **说明:**
>console.log\(\)打印的是debug级别日志信息。
## console.info<a name="zh-cn_topic_0000001127284842_section93434457711"></a>
info\(message: string\): void
打印info级别的日志信息。
- 参数
<a name="zh-cn_topic_0000001127284842_table611782915816"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001127284842_row1211714291989"><th class="cellrowborder" valign="top" width="12%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001127284842_p41174291587"><a name="zh-cn_topic_0000001127284842_p41174291587"></a><a name="zh-cn_topic_0000001127284842_p41174291587"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001127284842_p711715295817"><a name="zh-cn_topic_0000001127284842_p711715295817"></a><a name="zh-cn_topic_0000001127284842_p711715295817"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001127284842_p101171729289"><a name="zh-cn_topic_0000001127284842_p101171729289"></a><a name="zh-cn_topic_0000001127284842_p101171729289"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="70%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001127284842_p17117162911815"><a name="zh-cn_topic_0000001127284842_p17117162911815"></a><a name="zh-cn_topic_0000001127284842_p17117162911815"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001127284842_row411762913814"><td class="cellrowborder" valign="top" width="12%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001127284842_p111178291284"><a name="zh-cn_topic_0000001127284842_p111178291284"></a><a name="zh-cn_topic_0000001127284842_p111178291284"></a>message</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001127284842_p91181929284"><a name="zh-cn_topic_0000001127284842_p91181929284"></a><a name="zh-cn_topic_0000001127284842_p91181929284"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001127284842_p12118152919810"><a name="zh-cn_topic_0000001127284842_p12118152919810"></a><a name="zh-cn_topic_0000001127284842_p12118152919810"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001127284842_p18118112910811"><a name="zh-cn_topic_0000001127284842_p18118112910811"></a><a name="zh-cn_topic_0000001127284842_p18118112910811"></a>表示要打印的文本信息。</p>
</td>
</tr>
</tbody>
</table>
## console.warn<a name="zh-cn_topic_0000001127284842_section1363520541678"></a>
warn\(message: string\): void
打印warn级别的日志信息。
- 参数
<a name="zh-cn_topic_0000001127284842_table2396103815819"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001127284842_row13396183810811"><th class="cellrowborder" valign="top" width="12%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001127284842_p3396153815820"><a name="zh-cn_topic_0000001127284842_p3396153815820"></a><a name="zh-cn_topic_0000001127284842_p3396153815820"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001127284842_p13964389819"><a name="zh-cn_topic_0000001127284842_p13964389819"></a><a name="zh-cn_topic_0000001127284842_p13964389819"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001127284842_p53961138987"><a name="zh-cn_topic_0000001127284842_p53961138987"></a><a name="zh-cn_topic_0000001127284842_p53961138987"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="70%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001127284842_p0396238787"><a name="zh-cn_topic_0000001127284842_p0396238787"></a><a name="zh-cn_topic_0000001127284842_p0396238787"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001127284842_row9396163811811"><td class="cellrowborder" valign="top" width="12%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001127284842_p33966385817"><a name="zh-cn_topic_0000001127284842_p33966385817"></a><a name="zh-cn_topic_0000001127284842_p33966385817"></a>message</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001127284842_p639610381280"><a name="zh-cn_topic_0000001127284842_p639610381280"></a><a name="zh-cn_topic_0000001127284842_p639610381280"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001127284842_p0396183816816"><a name="zh-cn_topic_0000001127284842_p0396183816816"></a><a name="zh-cn_topic_0000001127284842_p0396183816816"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001127284842_p039613818815"><a name="zh-cn_topic_0000001127284842_p039613818815"></a><a name="zh-cn_topic_0000001127284842_p039613818815"></a>表示要打印的文本信息。</p>
</td>
</tr>
</tbody>
</table>
## console.error<a name="zh-cn_topic_0000001127284842_section326012551578"></a>
error\(message: string\): void
打印error级别的日志信息。
- 参数
<a name="zh-cn_topic_0000001127284842_table79914568813"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001127284842_row899656288"><th class="cellrowborder" valign="top" width="12%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001127284842_p39911567816"><a name="zh-cn_topic_0000001127284842_p39911567816"></a><a name="zh-cn_topic_0000001127284842_p39911567816"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001127284842_p099156388"><a name="zh-cn_topic_0000001127284842_p099156388"></a><a name="zh-cn_topic_0000001127284842_p099156388"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="9%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001127284842_p3992564819"><a name="zh-cn_topic_0000001127284842_p3992564819"></a><a name="zh-cn_topic_0000001127284842_p3992564819"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="70%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001127284842_p89920561088"><a name="zh-cn_topic_0000001127284842_p89920561088"></a><a name="zh-cn_topic_0000001127284842_p89920561088"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001127284842_row799956389"><td class="cellrowborder" valign="top" width="12%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001127284842_p699105614811"><a name="zh-cn_topic_0000001127284842_p699105614811"></a><a name="zh-cn_topic_0000001127284842_p699105614811"></a>message</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001127284842_p99925618816"><a name="zh-cn_topic_0000001127284842_p99925618816"></a><a name="zh-cn_topic_0000001127284842_p99925618816"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="9%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001127284842_p189916561082"><a name="zh-cn_topic_0000001127284842_p189916561082"></a><a name="zh-cn_topic_0000001127284842_p189916561082"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="70%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001127284842_p799195610812"><a name="zh-cn_topic_0000001127284842_p799195610812"></a><a name="zh-cn_topic_0000001127284842_p799195610812"></a>表示要打印的文本信息。</p>
</td>
</tr>
</tbody>
</table>
## 示例<a name="zh-cn_topic_0000001127284842_section738673813104"></a>
```
var versionCode = 1;
console.info('Hello World. The current version code is ' + versionCode);
console.log(`versionCode: ${versionCode}`)
console.log('versionCode:%d.', versionCode);6+
```
在DevEco Studio的底部,切换到“HiLog”窗口。选择当前的设备及进程,日志级别选择Info,搜索内容设置为“Hello World”。此时窗口仅显示符合条件的日志,效果如图所示:
![](figures/打印日志.png)
# 基本功能<a name="ZH-CN_TOPIC_0000001209210689"></a>
- **[应用上下文](js-apis-system-app.md)**
- **[日志打印](js-apis-basic-features-logs.md)**
- **[页面路由](js-apis-system-router.md)**
- **[弹窗](js-apis-system-prompt.md)**
- **[应用配置](js-apis-system-configuration.md)**
- **[定时器](js-apis-system-timer.md)**
- **[动画](js-apis-animator.md)**
- **[应用打点](js-apis-hiappevent.md)**
- **[性能打点](js-apis-bytrace.md)**
- **[分布式帐号管理](js-apis-distributedaccount.md)**
# 设置系统屏幕亮度<a name="ZH-CN_TOPIC_0000001209252189"></a>
- [导入模块](#zh-cn_topic_0000001163808920_s56d19203690d4782bfc74069abb6bd71)
- [brightness.setValue](#zh-cn_topic_0000001163808920_section1853612361618)
>![](../../public_sys-resources/icon-note.gif) **说明:**
>从 API Version 7 开始支持。
## 导入模块<a name="zh-cn_topic_0000001163808920_s56d19203690d4782bfc74069abb6bd71"></a>
```
import brightness from '@ohos.brightness.d.ts'.
```
## brightness.setValue<a name="zh-cn_topic_0000001163808920_section1853612361618"></a>
setValue\(value: number\)
设置系统的屏幕亮度。
- 参数:
<a name="zh-cn_topic_0000001163808920_table888613685714"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001163808920_row1988683685713"><th class="cellrowborder" valign="top" width="11.03%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001163808920_p1488693625712"><a name="zh-cn_topic_0000001163808920_p1488693625712"></a><a name="zh-cn_topic_0000001163808920_p1488693625712"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="11.64%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001163808920_p1886173613571"><a name="zh-cn_topic_0000001163808920_p1886173613571"></a><a name="zh-cn_topic_0000001163808920_p1886173613571"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="7.1499999999999995%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001163808920_p128861336155714"><a name="zh-cn_topic_0000001163808920_p128861336155714"></a><a name="zh-cn_topic_0000001163808920_p128861336155714"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="70.17999999999999%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001163808920_p3886143617571"><a name="zh-cn_topic_0000001163808920_p3886143617571"></a><a name="zh-cn_topic_0000001163808920_p3886143617571"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001163808920_row9886133613577"><td class="cellrowborder" valign="top" width="11.03%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001163808920_p14886163695720"><a name="zh-cn_topic_0000001163808920_p14886163695720"></a><a name="zh-cn_topic_0000001163808920_p14886163695720"></a>value</p>
</td>
<td class="cellrowborder" valign="top" width="11.64%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001163808920_p9886123605716"><a name="zh-cn_topic_0000001163808920_p9886123605716"></a><a name="zh-cn_topic_0000001163808920_p9886123605716"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="7.1499999999999995%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001163808920_p988723618577"><a name="zh-cn_topic_0000001163808920_p988723618577"></a><a name="zh-cn_topic_0000001163808920_p988723618577"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="70.17999999999999%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001163808920_p2512184017289"><a name="zh-cn_topic_0000001163808920_p2512184017289"></a><a name="zh-cn_topic_0000001163808920_p2512184017289"></a><span>亮度的值</span>(0~255)</p>
</td>
</tr>
</tbody>
</table>
- 示例:
```
import brightness from '@ohos.brightness.d.ts'
brightness.setValue(128);
```
# 性能打点<a name="ZH-CN_TOPIC_0000001209509395"></a>
- [导入模块](#zh-cn_topic_0000001209019195_s56d19203690d4782bfc74069abb6bd71)
- [权限](#zh-cn_topic_0000001209019195_section11257113618419)
- [bytrace.startTrace](#zh-cn_topic_0000001209019195_section785191510485)
- [bytrace.finishTrace](#zh-cn_topic_0000001209019195_section7895134841213)
- [bytrace.traceByValue](#zh-cn_topic_0000001209019195_section1388414179173)
>![](../../public_sys-resources/icon-note.gif) **说明:**
>从 API Version 7 开始支持。
## 导入模块<a name="zh-cn_topic_0000001209019195_s56d19203690d4782bfc74069abb6bd71"></a>
```
import bytrace from '@ohos.bytrace';
```
## 权限<a name="zh-cn_topic_0000001209019195_section11257113618419"></a>
## bytrace.startTrace<a name="zh-cn_topic_0000001209019195_section785191510485"></a>
startTrace\(name: string, taskId: number, expectedTime?: number\): void
标记一个预追踪耗时任务的开始,expectedTime是可选参数,标识该任务的期望耗时。
- 参数:
<a name="zh-cn_topic_0000001209019195_table69661135912"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001209019195_row149668318915"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001209019195_p7966738914"><a name="zh-cn_topic_0000001209019195_p7966738914"></a><a name="zh-cn_topic_0000001209019195_p7966738914"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="13.22%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001209019195_p296713699"><a name="zh-cn_topic_0000001209019195_p296713699"></a><a name="zh-cn_topic_0000001209019195_p296713699"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.67%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001209019195_p196718315911"><a name="zh-cn_topic_0000001209019195_p196718315911"></a><a name="zh-cn_topic_0000001209019195_p196718315911"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001209019195_p9967231197"><a name="zh-cn_topic_0000001209019195_p9967231197"></a><a name="zh-cn_topic_0000001209019195_p9967231197"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001209019195_row99671533914"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001209019195_p79671633910"><a name="zh-cn_topic_0000001209019195_p79671633910"></a><a name="zh-cn_topic_0000001209019195_p79671633910"></a>name</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001209019195_p11967433914"><a name="zh-cn_topic_0000001209019195_p11967433914"></a><a name="zh-cn_topic_0000001209019195_p11967433914"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001209019195_p19671336916"><a name="zh-cn_topic_0000001209019195_p19671336916"></a><a name="zh-cn_topic_0000001209019195_p19671336916"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001209019195_p2084833211463"><a name="zh-cn_topic_0000001209019195_p2084833211463"></a><a name="zh-cn_topic_0000001209019195_p2084833211463"></a>要追踪的任务名称</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001209019195_row18967831393"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001209019195_p16813106387"><a name="zh-cn_topic_0000001209019195_p16813106387"></a><a name="zh-cn_topic_0000001209019195_p16813106387"></a>taskId</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001209019195_p976115416386"><a name="zh-cn_topic_0000001209019195_p976115416386"></a><a name="zh-cn_topic_0000001209019195_p976115416386"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001209019195_p149671932919"><a name="zh-cn_topic_0000001209019195_p149671932919"></a><a name="zh-cn_topic_0000001209019195_p149671932919"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001209019195_p19675312911"><a name="zh-cn_topic_0000001209019195_p19675312911"></a><a name="zh-cn_topic_0000001209019195_p19675312911"></a>任务id</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001209019195_row1225911163813"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001209019195_p132250110380"><a name="zh-cn_topic_0000001209019195_p132250110380"></a><a name="zh-cn_topic_0000001209019195_p132250110380"></a>expectedTime</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001209019195_p1622551113381"><a name="zh-cn_topic_0000001209019195_p1622551113381"></a><a name="zh-cn_topic_0000001209019195_p1622551113381"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001209019195_p5226151110383"><a name="zh-cn_topic_0000001209019195_p5226151110383"></a><a name="zh-cn_topic_0000001209019195_p5226151110383"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001209019195_p22262111381"><a name="zh-cn_topic_0000001209019195_p22262111381"></a><a name="zh-cn_topic_0000001209019195_p22262111381"></a>期望的耗时时间,单位:ms</p>
</td>
</tr>
</tbody>
</table>
>![](../../public_sys-resources/icon-note.gif) **说明:**
>如果多个要追踪任务的name相同,taskId必须不一致。通过name和taskId来唯一标识一个任务。
- 示例:
```
bytrace.startTrace("myTestFunc", 1);
bytrace.startTrace("myTestFunc", 1, 5); //从startTrace到finishTrace流程的耗时期望为5ms
```
## bytrace.finishTrace<a name="zh-cn_topic_0000001209019195_section7895134841213"></a>
finishTrace\(name: string, taskId: number\): void
标记一个预追踪耗时任务的结束。
- 参数:
<a name="zh-cn_topic_0000001209019195_table1589613488127"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001209019195_row208961448131215"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001209019195_p1089674831216"><a name="zh-cn_topic_0000001209019195_p1089674831216"></a><a name="zh-cn_topic_0000001209019195_p1089674831216"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="13.22%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001209019195_p1689613481128"><a name="zh-cn_topic_0000001209019195_p1689613481128"></a><a name="zh-cn_topic_0000001209019195_p1689613481128"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.67%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001209019195_p989613483125"><a name="zh-cn_topic_0000001209019195_p989613483125"></a><a name="zh-cn_topic_0000001209019195_p989613483125"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001209019195_p13896148111215"><a name="zh-cn_topic_0000001209019195_p13896148111215"></a><a name="zh-cn_topic_0000001209019195_p13896148111215"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001209019195_row14896204817125"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001209019195_p10896174817128"><a name="zh-cn_topic_0000001209019195_p10896174817128"></a><a name="zh-cn_topic_0000001209019195_p10896174817128"></a>name</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001209019195_p189618483125"><a name="zh-cn_topic_0000001209019195_p189618483125"></a><a name="zh-cn_topic_0000001209019195_p189618483125"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001209019195_p118961548101215"><a name="zh-cn_topic_0000001209019195_p118961548101215"></a><a name="zh-cn_topic_0000001209019195_p118961548101215"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001209019195_p1989674810124"><a name="zh-cn_topic_0000001209019195_p1989674810124"></a><a name="zh-cn_topic_0000001209019195_p1989674810124"></a>要追踪的任务名称</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001209019195_row5896548101211"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001209019195_p10896164811121"><a name="zh-cn_topic_0000001209019195_p10896164811121"></a><a name="zh-cn_topic_0000001209019195_p10896164811121"></a>taskId</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001209019195_p1789694821215"><a name="zh-cn_topic_0000001209019195_p1789694821215"></a><a name="zh-cn_topic_0000001209019195_p1789694821215"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001209019195_p08962488128"><a name="zh-cn_topic_0000001209019195_p08962488128"></a><a name="zh-cn_topic_0000001209019195_p08962488128"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001209019195_p8896194831214"><a name="zh-cn_topic_0000001209019195_p8896194831214"></a><a name="zh-cn_topic_0000001209019195_p8896194831214"></a>任务id</p>
</td>
</tr>
</tbody>
</table>
>![](../../public_sys-resources/icon-note.gif) **说明:**
>finishTrace的name和taskId必须与流程开始的startTrace对应参数值一致。
- 示例:
```
bytrace.finishTrace("myTestFunc", 1);
```
## bytrace.traceByValue<a name="zh-cn_topic_0000001209019195_section1388414179173"></a>
traceByValue\(name: string, count: number\): void
用来标记一个预追踪的数值变量,该变量的数值会不断变化。
- 参数:
<a name="zh-cn_topic_0000001209019195_table0884617171718"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001209019195_row1188481771714"><th class="cellrowborder" valign="top" width="14.82%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001209019195_p488419174178"><a name="zh-cn_topic_0000001209019195_p488419174178"></a><a name="zh-cn_topic_0000001209019195_p488419174178"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="13.22%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001209019195_p12884131721718"><a name="zh-cn_topic_0000001209019195_p12884131721718"></a><a name="zh-cn_topic_0000001209019195_p12884131721718"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="10.67%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001209019195_p188481714178"><a name="zh-cn_topic_0000001209019195_p188481714178"></a><a name="zh-cn_topic_0000001209019195_p188481714178"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="61.29%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001209019195_p188411174177"><a name="zh-cn_topic_0000001209019195_p188411174177"></a><a name="zh-cn_topic_0000001209019195_p188411174177"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001209019195_row38849172174"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001209019195_p7884121719172"><a name="zh-cn_topic_0000001209019195_p7884121719172"></a><a name="zh-cn_topic_0000001209019195_p7884121719172"></a>name</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001209019195_p1488415174171"><a name="zh-cn_topic_0000001209019195_p1488415174171"></a><a name="zh-cn_topic_0000001209019195_p1488415174171"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001209019195_p7884171711717"><a name="zh-cn_topic_0000001209019195_p7884171711717"></a><a name="zh-cn_topic_0000001209019195_p7884171711717"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001209019195_p17884517161715"><a name="zh-cn_topic_0000001209019195_p17884517161715"></a><a name="zh-cn_topic_0000001209019195_p17884517161715"></a>要追踪的数值变量名称</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001209019195_row188419179172"><td class="cellrowborder" valign="top" width="14.82%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001209019195_p206756457267"><a name="zh-cn_topic_0000001209019195_p206756457267"></a><a name="zh-cn_topic_0000001209019195_p206756457267"></a>count</p>
</td>
<td class="cellrowborder" valign="top" width="13.22%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001209019195_p9884917111710"><a name="zh-cn_topic_0000001209019195_p9884917111710"></a><a name="zh-cn_topic_0000001209019195_p9884917111710"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="10.67%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001209019195_p18841217141719"><a name="zh-cn_topic_0000001209019195_p18841217141719"></a><a name="zh-cn_topic_0000001209019195_p18841217141719"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="61.29%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001209019195_p178842174174"><a name="zh-cn_topic_0000001209019195_p178842174174"></a><a name="zh-cn_topic_0000001209019195_p178842174174"></a>变量的值</p>
</td>
</tr>
</tbody>
</table>
- 示例:
```
let traceCount = 3;
bytrace.traceByValue("myTestCount", traceCount);
......
traceCount = 5;
bytrace.traceByValue("myTestCount", traceCount);
```
# KVManager配置信息<a name="ZH-CN_TOPIC_0000001164290734"></a>
- [导入模块](#zh-cn_topic_0000001175852127_s56d19203690d4782bfc74069abb6bd71)
- [权限](#zh-cn_topic_0000001175852127_section11257113618419)
- [UserType](#zh-cn_topic_0000001175852127_section099619567453)
- [KVManagerConfig](#zh-cn_topic_0000001175852127_section4346145712159)
- [UserInfo](#zh-cn_topic_0000001175852127_section12882825611)
>![](../../public_sys-resources/icon-note.gif) **说明:**
>从 API Version 7 开始支持。
## 导入模块<a name="zh-cn_topic_0000001175852127_s56d19203690d4782bfc74069abb6bd71"></a>
```
import factory from '@ohos.data.distributeddata';
```
## 权限<a name="zh-cn_topic_0000001175852127_section11257113618419"></a>
## UserType<a name="zh-cn_topic_0000001175852127_section099619567453"></a>
描述用户类型。
<a name="zh-cn_topic_0000001175852127_table20633101642315"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001175852127_row663331618238"><th class="cellrowborder" valign="top" width="27.900000000000002%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001175852127_a3d0fc780cc904c1cbab7991251622f65"><a name="zh-cn_topic_0000001175852127_a3d0fc780cc904c1cbab7991251622f65"></a><a name="zh-cn_topic_0000001175852127_a3d0fc780cc904c1cbab7991251622f65"></a>名称</p>
</th>
<th class="cellrowborder" valign="top" width="12.43%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001175852127_aace9cae4ba0d4939bfa048460f61c3c7"><a name="zh-cn_topic_0000001175852127_aace9cae4ba0d4939bfa048460f61c3c7"></a><a name="zh-cn_topic_0000001175852127_aace9cae4ba0d4939bfa048460f61c3c7"></a>默认值</p>
</th>
<th class="cellrowborder" valign="top" width="59.67%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001175852127_afec895de33f94e3c87ee7acc20190a17"><a name="zh-cn_topic_0000001175852127_afec895de33f94e3c87ee7acc20190a17"></a><a name="zh-cn_topic_0000001175852127_afec895de33f94e3c87ee7acc20190a17"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001175852127_row188481425182510"><td class="cellrowborder" valign="top" width="27.900000000000002%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175852127_p52851329122117"><a name="zh-cn_topic_0000001175852127_p52851329122117"></a><a name="zh-cn_topic_0000001175852127_p52851329122117"></a>SAME_USER_ID</p>
</td>
<td class="cellrowborder" valign="top" width="12.43%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175852127_p127372258515"><a name="zh-cn_topic_0000001175852127_p127372258515"></a><a name="zh-cn_topic_0000001175852127_p127372258515"></a>0</p>
</td>
<td class="cellrowborder" valign="top" width="59.67%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175852127_p328012293211"><a name="zh-cn_topic_0000001175852127_p328012293211"></a><a name="zh-cn_topic_0000001175852127_p328012293211"></a>表示使用同一帐户登录不同设备的用户。</p>
</td>
</tr>
</tbody>
</table>
## KVManagerConfig<a name="zh-cn_topic_0000001175852127_section4346145712159"></a>
提供KVManager实例的配置信息。
包括调用者的包名称和分布式网络类型。
<a name="zh-cn_topic_0000001175852127_table1346155718156"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001175852127_row3346135713159"><th class="cellrowborder" valign="top" width="15.870000000000001%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001175852127_p193461057151516"><a name="zh-cn_topic_0000001175852127_p193461057151516"></a><a name="zh-cn_topic_0000001175852127_p193461057151516"></a>名称</p>
</th>
<th class="cellrowborder" valign="top" width="10.86%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001175852127_p034685781510"><a name="zh-cn_topic_0000001175852127_p034685781510"></a><a name="zh-cn_topic_0000001175852127_p034685781510"></a>参数类型</p>
</th>
<th class="cellrowborder" valign="top" width="9.34%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001175852127_p9346135719158"><a name="zh-cn_topic_0000001175852127_p9346135719158"></a><a name="zh-cn_topic_0000001175852127_p9346135719158"></a>可读</p>
</th>
<th class="cellrowborder" valign="top" width="11.51%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001175852127_p11347175791511"><a name="zh-cn_topic_0000001175852127_p11347175791511"></a><a name="zh-cn_topic_0000001175852127_p11347175791511"></a>可写</p>
</th>
<th class="cellrowborder" valign="top" width="52.42%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001175852127_p143471757191518"><a name="zh-cn_topic_0000001175852127_p143471757191518"></a><a name="zh-cn_topic_0000001175852127_p143471757191518"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001175852127_row1734745719159"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001175852127_p14347115721510"><a name="zh-cn_topic_0000001175852127_p14347115721510"></a><a name="zh-cn_topic_0000001175852127_p14347115721510"></a>userInfo</p>
</td>
<td class="cellrowborder" valign="top" width="10.86%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001175852127_p1347125715158"><a name="zh-cn_topic_0000001175852127_p1347125715158"></a><a name="zh-cn_topic_0000001175852127_p1347125715158"></a><a href="#zh-cn_topic_0000001175852127_section12882825611">UserInfo</a></p>
</td>
<td class="cellrowborder" valign="top" width="9.34%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001175852127_p3347175741518"><a name="zh-cn_topic_0000001175852127_p3347175741518"></a><a name="zh-cn_topic_0000001175852127_p3347175741518"></a></p>
</td>
<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001175852127_p11347257131512"><a name="zh-cn_topic_0000001175852127_p11347257131512"></a><a name="zh-cn_topic_0000001175852127_p11347257131512"></a></p>
</td>
<td class="cellrowborder" valign="top" width="52.42%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001175852127_p1234735715159"><a name="zh-cn_topic_0000001175852127_p1234735715159"></a><a name="zh-cn_topic_0000001175852127_p1234735715159"></a>用户信息。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001175852127_row53477574154"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001175852127_p123472579150"><a name="zh-cn_topic_0000001175852127_p123472579150"></a><a name="zh-cn_topic_0000001175852127_p123472579150"></a>bundleName</p>
</td>
<td class="cellrowborder" valign="top" width="10.86%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001175852127_p334745751511"><a name="zh-cn_topic_0000001175852127_p334745751511"></a><a name="zh-cn_topic_0000001175852127_p334745751511"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="9.34%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001175852127_p11347145771516"><a name="zh-cn_topic_0000001175852127_p11347145771516"></a><a name="zh-cn_topic_0000001175852127_p11347145771516"></a></p>
</td>
<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001175852127_p20347135712155"><a name="zh-cn_topic_0000001175852127_p20347135712155"></a><a name="zh-cn_topic_0000001175852127_p20347135712155"></a></p>
</td>
<td class="cellrowborder" valign="top" width="52.42%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001175852127_p10347175720159"><a name="zh-cn_topic_0000001175852127_p10347175720159"></a><a name="zh-cn_topic_0000001175852127_p10347175720159"></a>应用包名。长度应小于1KB。</p>
</td>
</tr>
</tbody>
</table>
## UserInfo<a name="zh-cn_topic_0000001175852127_section12882825611"></a>
用户信息管理类。
<a name="zh-cn_topic_0000001175852127_table1459620431636"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001175852127_row25971143435"><th class="cellrowborder" valign="top" width="15.870000000000001%" id="mcps1.1.6.1.1"><p id="zh-cn_topic_0000001175852127_p1559716434320"><a name="zh-cn_topic_0000001175852127_p1559716434320"></a><a name="zh-cn_topic_0000001175852127_p1559716434320"></a>名称</p>
</th>
<th class="cellrowborder" valign="top" width="10.86%" id="mcps1.1.6.1.2"><p id="zh-cn_topic_0000001175852127_p3597743539"><a name="zh-cn_topic_0000001175852127_p3597743539"></a><a name="zh-cn_topic_0000001175852127_p3597743539"></a>参数类型</p>
</th>
<th class="cellrowborder" valign="top" width="9.34%" id="mcps1.1.6.1.3"><p id="zh-cn_topic_0000001175852127_p15971343131"><a name="zh-cn_topic_0000001175852127_p15971343131"></a><a name="zh-cn_topic_0000001175852127_p15971343131"></a>可读</p>
</th>
<th class="cellrowborder" valign="top" width="11.51%" id="mcps1.1.6.1.4"><p id="zh-cn_topic_0000001175852127_p1459715436311"><a name="zh-cn_topic_0000001175852127_p1459715436311"></a><a name="zh-cn_topic_0000001175852127_p1459715436311"></a>可写</p>
</th>
<th class="cellrowborder" valign="top" width="52.42%" id="mcps1.1.6.1.5"><p id="zh-cn_topic_0000001175852127_p75975439316"><a name="zh-cn_topic_0000001175852127_p75975439316"></a><a name="zh-cn_topic_0000001175852127_p75975439316"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001175852127_row95971943839"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001175852127_p10946136141716"><a name="zh-cn_topic_0000001175852127_p10946136141716"></a><a name="zh-cn_topic_0000001175852127_p10946136141716"></a>userId</p>
</td>
<td class="cellrowborder" valign="top" width="10.86%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001175852127_p2059710431030"><a name="zh-cn_topic_0000001175852127_p2059710431030"></a><a name="zh-cn_topic_0000001175852127_p2059710431030"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="9.34%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001175852127_p1059711439317"><a name="zh-cn_topic_0000001175852127_p1059711439317"></a><a name="zh-cn_topic_0000001175852127_p1059711439317"></a></p>
</td>
<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001175852127_p659715430317"><a name="zh-cn_topic_0000001175852127_p659715430317"></a><a name="zh-cn_topic_0000001175852127_p659715430317"></a></p>
</td>
<td class="cellrowborder" valign="top" width="52.42%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001175852127_p2059719436313"><a name="zh-cn_topic_0000001175852127_p2059719436313"></a><a name="zh-cn_topic_0000001175852127_p2059719436313"></a>表示需要设置的用户ID。长度应小于1KB。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001175852127_row185973435316"><td class="cellrowborder" valign="top" width="15.870000000000001%" headers="mcps1.1.6.1.1 "><p id="zh-cn_topic_0000001175852127_p1559710432310"><a name="zh-cn_topic_0000001175852127_p1559710432310"></a><a name="zh-cn_topic_0000001175852127_p1559710432310"></a>userType</p>
</td>
<td class="cellrowborder" valign="top" width="10.86%" headers="mcps1.1.6.1.2 "><p id="zh-cn_topic_0000001175852127_p16597144318312"><a name="zh-cn_topic_0000001175852127_p16597144318312"></a><a name="zh-cn_topic_0000001175852127_p16597144318312"></a><a href="#zh-cn_topic_0000001175852127_section099619567453">UserType</a></p>
</td>
<td class="cellrowborder" valign="top" width="9.34%" headers="mcps1.1.6.1.3 "><p id="zh-cn_topic_0000001175852127_p12597194313317"><a name="zh-cn_topic_0000001175852127_p12597194313317"></a><a name="zh-cn_topic_0000001175852127_p12597194313317"></a></p>
</td>
<td class="cellrowborder" valign="top" width="11.51%" headers="mcps1.1.6.1.4 "><p id="zh-cn_topic_0000001175852127_p1259710431236"><a name="zh-cn_topic_0000001175852127_p1259710431236"></a><a name="zh-cn_topic_0000001175852127_p1259710431236"></a></p>
</td>
<td class="cellrowborder" valign="top" width="52.42%" headers="mcps1.1.6.1.5 "><p id="zh-cn_topic_0000001175852127_p10597843034"><a name="zh-cn_topic_0000001175852127_p10597843034"></a><a name="zh-cn_topic_0000001175852127_p10597843034"></a>表示需要设置的用户类型。</p>
</td>
</tr>
</tbody>
</table>
# 创建和获取分布式数据库<a name="ZH-CN_TOPIC_0000001164130784"></a>
- [导入模块](#zh-cn_topic_0000001179090937_s56d19203690d4782bfc74069abb6bd71)
- [权限](#zh-cn_topic_0000001179090937_section11257113618419)
- [createKVManager\(config: KVManagerConfig, callback: AsyncCallback<KVManager\>\): void](#zh-cn_topic_0000001179090937_section192192415554)
- [createKVManager\(config: KVManagerConfig\): Promise<KVManager\>](#zh-cn_topic_0000001179090937_section19618143402218)
- [KVManager](#zh-cn_topic_0000001179090937_section12882825611)
- [getKVStore<T extends KVStore\>\(storeId: string, options: Options\): Promise<T\>](#zh-cn_topic_0000001179090937_section51960467216)
- [getKVStore<T extends KVStore\>\(storeId: string, options: Options, callback: AsyncCallback<T\>\): void](#zh-cn_topic_0000001179090937_section06419235582)
>![](../../public_sys-resources/icon-note.gif) **说明:**
>从 API Version 7 开始支持。
## 导入模块<a name="zh-cn_topic_0000001179090937_s56d19203690d4782bfc74069abb6bd71"></a>
```
import factory from '@ohos.data.distributeddata';
```
## 权限<a name="zh-cn_topic_0000001179090937_section11257113618419"></a>
## createKVManager\(config: KVManagerConfig, callback: AsyncCallback<KVManager\>\): void<a name="zh-cn_topic_0000001179090937_section192192415554"></a>
创建分布式数据库管理对象。
此方法为异步callback方法。
- 参数:
<a name="zh-cn_topic_0000001179090937_table69661135912"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001179090937_row149668318915"><th class="cellrowborder" valign="top" width="18.13%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001179090937_p7966738914"><a name="zh-cn_topic_0000001179090937_p7966738914"></a><a name="zh-cn_topic_0000001179090937_p7966738914"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="27.029999999999998%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001179090937_p296713699"><a name="zh-cn_topic_0000001179090937_p296713699"></a><a name="zh-cn_topic_0000001179090937_p296713699"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="54.84%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001179090937_p9967231197"><a name="zh-cn_topic_0000001179090937_p9967231197"></a><a name="zh-cn_topic_0000001179090937_p9967231197"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001179090937_row99671533914"><td class="cellrowborder" valign="top" width="18.13%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001179090937_p79671633910"><a name="zh-cn_topic_0000001179090937_p79671633910"></a><a name="zh-cn_topic_0000001179090937_p79671633910"></a>config</p>
</td>
<td class="cellrowborder" valign="top" width="27.029999999999998%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001179090937_p11967433914"><a name="zh-cn_topic_0000001179090937_p11967433914"></a><a name="zh-cn_topic_0000001179090937_p11967433914"></a><a href="js-apis-data-kvmanager-config.md#zh-cn_topic_0000001175852127_section4346145712159">KVManagerConfig</a></p>
</td>
<td class="cellrowborder" valign="top" width="54.84%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001179090937_p69671631796"><a name="zh-cn_topic_0000001179090937_p69671631796"></a><a name="zh-cn_topic_0000001179090937_p69671631796"></a>用于配置管理对象,包括用户信息和应用包名。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001179090937_row5826185610187"><td class="cellrowborder" valign="top" width="18.13%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001179090937_p1482895641811"><a name="zh-cn_topic_0000001179090937_p1482895641811"></a><a name="zh-cn_topic_0000001179090937_p1482895641811"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="27.029999999999998%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001179090937_p1482845617187"><a name="zh-cn_topic_0000001179090937_p1482845617187"></a><a name="zh-cn_topic_0000001179090937_p1482845617187"></a>AsyncCallback&lt;<a href="#zh-cn_topic_0000001179090937_section12882825611">KVManager</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="54.84%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001179090937_p118284566187"><a name="zh-cn_topic_0000001179090937_p118284566187"></a><a name="zh-cn_topic_0000001179090937_p118284566187"></a>回调函数,获取数据库管理对象实例。</p>
</td>
</tr>
</tbody>
</table>
- 返回值:
- 示例:
```
factory.createKVManager(config, function (err, manager) {
kvManager = manager;
});
```
## createKVManager\(config: KVManagerConfig\): Promise<KVManager\><a name="zh-cn_topic_0000001179090937_section19618143402218"></a>
创建分布式数据库管理对象。
此方法为异步promise方法。
- 参数:
<a name="zh-cn_topic_0000001179090937_table1861873492218"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001179090937_row11619163419226"><th class="cellrowborder" valign="top" width="18.13%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001179090937_p1361953472215"><a name="zh-cn_topic_0000001179090937_p1361953472215"></a><a name="zh-cn_topic_0000001179090937_p1361953472215"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="27.029999999999998%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001179090937_p116191334162215"><a name="zh-cn_topic_0000001179090937_p116191334162215"></a><a name="zh-cn_topic_0000001179090937_p116191334162215"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="54.84%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001179090937_p15619734192217"><a name="zh-cn_topic_0000001179090937_p15619734192217"></a><a name="zh-cn_topic_0000001179090937_p15619734192217"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001179090937_row361903412218"><td class="cellrowborder" valign="top" width="18.13%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001179090937_p126191134162215"><a name="zh-cn_topic_0000001179090937_p126191134162215"></a><a name="zh-cn_topic_0000001179090937_p126191134162215"></a>config</p>
</td>
<td class="cellrowborder" valign="top" width="27.029999999999998%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001179090937_p68611843483"><a name="zh-cn_topic_0000001179090937_p68611843483"></a><a name="zh-cn_topic_0000001179090937_p68611843483"></a><a href="js-apis-data-kvmanager-config.md#zh-cn_topic_0000001175852127_section4346145712159">KVManagerConfig</a></p>
</td>
<td class="cellrowborder" valign="top" width="54.84%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001179090937_p9619183422211"><a name="zh-cn_topic_0000001179090937_p9619183422211"></a><a name="zh-cn_topic_0000001179090937_p9619183422211"></a>用于配置管理对象,包括用户信息和应用包名。</p>
</td>
</tr>
</tbody>
</table>
- 返回值:
<a name="zh-cn_topic_0000001179090937_table4620834182216"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001179090937_row362014348227"><th class="cellrowborder" valign="top" width="25.1%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001179090937_p186203346224"><a name="zh-cn_topic_0000001179090937_p186203346224"></a><a name="zh-cn_topic_0000001179090937_p186203346224"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="74.9%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001179090937_p11620113414229"><a name="zh-cn_topic_0000001179090937_p11620113414229"></a><a name="zh-cn_topic_0000001179090937_p11620113414229"></a>类型</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001179090937_row186201834102218"><td class="cellrowborder" valign="top" width="25.1%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001179090937_p4620203417221"><a name="zh-cn_topic_0000001179090937_p4620203417221"></a><a name="zh-cn_topic_0000001179090937_p4620203417221"></a>Promise&lt;<a href="#zh-cn_topic_0000001179090937_section12882825611">KVManager</a>&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="74.9%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001179090937_p9621234172213"><a name="zh-cn_topic_0000001179090937_p9621234172213"></a><a name="zh-cn_topic_0000001179090937_p9621234172213"></a>promise实例,用于获取异步返回结果。</p>
</td>
</tr>
</tbody>
</table>
- 示例:
```
const promise = factory.createKVManager(config);
promise.then((manager) => {
kvManager = manager;
}).catch((err) => {
});
```
## KVManager<a name="zh-cn_topic_0000001179090937_section12882825611"></a>
提供管理分布式数据库的接口。
### getKVStore<T extends KVStore\>\(storeId: string, options: Options\): Promise<T\><a name="zh-cn_topic_0000001179090937_section51960467216"></a>
创建或获取数据库实例。需要先通过[createKVManager](#zh-cn_topic_0000001179090937_section192192415554)创建或获取KVStore实例。
此方法为异步promise方法。
- 参数:
<a name="zh-cn_topic_0000001179090937_table1819714611216"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001179090937_row151971464215"><th class="cellrowborder" valign="top" width="16.31%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001179090937_p1719718463214"><a name="zh-cn_topic_0000001179090937_p1719718463214"></a><a name="zh-cn_topic_0000001179090937_p1719718463214"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="16.220000000000002%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001179090937_p01972461429"><a name="zh-cn_topic_0000001179090937_p01972461429"></a><a name="zh-cn_topic_0000001179090937_p01972461429"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="67.47%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001179090937_p171977461523"><a name="zh-cn_topic_0000001179090937_p171977461523"></a><a name="zh-cn_topic_0000001179090937_p171977461523"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001179090937_row1219818462214"><td class="cellrowborder" valign="top" width="16.31%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001179090937_p191984461828"><a name="zh-cn_topic_0000001179090937_p191984461828"></a><a name="zh-cn_topic_0000001179090937_p191984461828"></a>storeId</p>
</td>
<td class="cellrowborder" valign="top" width="16.220000000000002%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001179090937_p191988464218"><a name="zh-cn_topic_0000001179090937_p191988464218"></a><a name="zh-cn_topic_0000001179090937_p191988464218"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="67.47%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001179090937_p1419834615216"><a name="zh-cn_topic_0000001179090937_p1419834615216"></a><a name="zh-cn_topic_0000001179090937_p1419834615216"></a>用于标识数据库。同一应用下该参数值必须唯一且长度应小于1KB。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001179090937_row1198746820"><td class="cellrowborder" valign="top" width="16.31%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001179090937_p51981467220"><a name="zh-cn_topic_0000001179090937_p51981467220"></a><a name="zh-cn_topic_0000001179090937_p51981467220"></a>options</p>
</td>
<td class="cellrowborder" valign="top" width="16.220000000000002%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001179090937_p1719819464212"><a name="zh-cn_topic_0000001179090937_p1719819464212"></a><a name="zh-cn_topic_0000001179090937_p1719819464212"></a><a href="js-apis-data-type.md#zh-cn_topic_0000001129943828_section16417114202216">Options</a></p>
</td>
<td class="cellrowborder" valign="top" width="67.47%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001179090937_p8198746421"><a name="zh-cn_topic_0000001179090937_p8198746421"></a><a name="zh-cn_topic_0000001179090937_p8198746421"></a>数据库实例的配置信息。</p>
</td>
</tr>
</tbody>
</table>
- 返回值:
<a name="zh-cn_topic_0000001179090937_table0198144610210"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001179090937_row2199134611213"><th class="cellrowborder" valign="top" width="20.66%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001179090937_p1919916467217"><a name="zh-cn_topic_0000001179090937_p1919916467217"></a><a name="zh-cn_topic_0000001179090937_p1919916467217"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="79.34%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001179090937_p1119964610216"><a name="zh-cn_topic_0000001179090937_p1119964610216"></a><a name="zh-cn_topic_0000001179090937_p1119964610216"></a>类型</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001179090937_row2019914467216"><td class="cellrowborder" valign="top" width="20.66%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001179090937_p191994461026"><a name="zh-cn_topic_0000001179090937_p191994461026"></a><a name="zh-cn_topic_0000001179090937_p191994461026"></a>Promise&lt;T&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="79.34%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001179090937_p131998462029"><a name="zh-cn_topic_0000001179090937_p131998462029"></a><a name="zh-cn_topic_0000001179090937_p131998462029"></a>promise实例,用于获取异步返回结果。</p>
</td>
</tr>
</tbody>
</table>
- 示例:
```
const promise = kvManager.getKVStore(options);
promise.then((store) => {
kvStore = store;
}).catch((err) => {
});
```
### getKVStore<T extends KVStore\>\(storeId: string, options: Options, callback: AsyncCallback<T\>\): void<a name="zh-cn_topic_0000001179090937_section06419235582"></a>
创建并获取数据库实例。
此方法为异步callback方法。
- 参数:
<a name="zh-cn_topic_0000001179090937_table16642172313584"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001179090937_row1064292310587"><th class="cellrowborder" valign="top" width="16.29%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001179090937_p9642172345810"><a name="zh-cn_topic_0000001179090937_p9642172345810"></a><a name="zh-cn_topic_0000001179090937_p9642172345810"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="18.42%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001179090937_p1264242365813"><a name="zh-cn_topic_0000001179090937_p1264242365813"></a><a name="zh-cn_topic_0000001179090937_p1264242365813"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="65.29%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001179090937_p16426231582"><a name="zh-cn_topic_0000001179090937_p16426231582"></a><a name="zh-cn_topic_0000001179090937_p16426231582"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001179090937_row196421223165820"><td class="cellrowborder" valign="top" width="16.29%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001179090937_p176426239586"><a name="zh-cn_topic_0000001179090937_p176426239586"></a><a name="zh-cn_topic_0000001179090937_p176426239586"></a>storeId</p>
</td>
<td class="cellrowborder" valign="top" width="18.42%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001179090937_p11642192345813"><a name="zh-cn_topic_0000001179090937_p11642192345813"></a><a name="zh-cn_topic_0000001179090937_p11642192345813"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="65.29%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001179090937_p22701218122217"><a name="zh-cn_topic_0000001179090937_p22701218122217"></a><a name="zh-cn_topic_0000001179090937_p22701218122217"></a>用于标识数据库。同一应用下该参数值必须唯一且长度应小于1KB。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001179090937_row1864252325813"><td class="cellrowborder" valign="top" width="16.29%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001179090937_p1664342385817"><a name="zh-cn_topic_0000001179090937_p1664342385817"></a><a name="zh-cn_topic_0000001179090937_p1664342385817"></a>options</p>
</td>
<td class="cellrowborder" valign="top" width="18.42%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001179090937_p46635302565"><a name="zh-cn_topic_0000001179090937_p46635302565"></a><a name="zh-cn_topic_0000001179090937_p46635302565"></a><a href="js-apis-data-type.md#zh-cn_topic_0000001129943828_section16417114202216">Options</a></p>
</td>
<td class="cellrowborder" valign="top" width="65.29%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001179090937_p86431923185818"><a name="zh-cn_topic_0000001179090937_p86431923185818"></a><a name="zh-cn_topic_0000001179090937_p86431923185818"></a>数据库实例的配置信息。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001179090937_row91703271930"><td class="cellrowborder" valign="top" width="16.29%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001179090937_p9805195012318"><a name="zh-cn_topic_0000001179090937_p9805195012318"></a><a name="zh-cn_topic_0000001179090937_p9805195012318"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="18.42%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001179090937_p1180517508312"><a name="zh-cn_topic_0000001179090937_p1180517508312"></a><a name="zh-cn_topic_0000001179090937_p1180517508312"></a>AsyncCallback&lt;T&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="65.29%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001179090937_p580516505314"><a name="zh-cn_topic_0000001179090937_p580516505314"></a><a name="zh-cn_topic_0000001179090937_p580516505314"></a>回调函数,获取数据库实例。</p>
</td>
</tr>
</tbody>
</table>
- 返回值:
- 示例:
```
kvManager.getKVStore('storeId', options, function(err, store){
kvStore = store;
});
```
# 单版本分布式数据库<a name="ZH-CN_TOPIC_0000001209252187"></a>
- [导入模块](#zh-cn_topic_0000001129947446_s56d19203690d4782bfc74069abb6bd71)
- [权限](#zh-cn_topic_0000001129947446_section11257113618419)
- [SingleKVStore](#zh-cn_topic_0000001129947446_section12882825611)
- [get\(key: string, callback: AsyncCallback<Uint8Array | string | boolean | number\>\): void](#zh-cn_topic_0000001129947446_section2013623011386)
- [get\(key: string\): Promise<Uint8Array | string | boolean | number\>](#zh-cn_topic_0000001129947446_section5647141894316)
- [sync\(deviceIdList: string\[\], mode: SyncMode, allowedDelayMs?: number\): void](#zh-cn_topic_0000001129947446_section06419235582)
>![](../../public_sys-resources/icon-note.gif) **说明:**
>从 API Version 7 开始支持。
## 导入模块<a name="zh-cn_topic_0000001129947446_s56d19203690d4782bfc74069abb6bd71"></a>
```
import factory from '@ohos.data.distributeddata';
```
## 权限<a name="zh-cn_topic_0000001129947446_section11257113618419"></a>
## SingleKVStore<a name="zh-cn_topic_0000001129947446_section12882825611"></a>
单版本分布式数据库,继承自分布式数据库,支持查询、同步数据,也具备分布式数据库的所有的接口能力。需要先通过[getKVStore](js-apis-data-kvmanager.md#zh-cn_topic_0000001179090937_section51960467216)获取实例。
### get\(key: string, callback: AsyncCallback<Uint8Array | string | boolean | number\>\): void<a name="zh-cn_topic_0000001129947446_section2013623011386"></a>
获取指定键的值。
此方法为异步callback方法。
- 参数:
<a name="zh-cn_topic_0000001129947446_table1913714301387"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001129947446_row20137730143813"><th class="cellrowborder" valign="top" width="19.541954195419542%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001129947446_p14137153017383"><a name="zh-cn_topic_0000001129947446_p14137153017383"></a><a name="zh-cn_topic_0000001129947446_p14137153017383"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="29.14291429142914%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001129947446_p11137113011389"><a name="zh-cn_topic_0000001129947446_p11137113011389"></a><a name="zh-cn_topic_0000001129947446_p11137113011389"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="51.315131513151314%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001129947446_p9137143011385"><a name="zh-cn_topic_0000001129947446_p9137143011385"></a><a name="zh-cn_topic_0000001129947446_p9137143011385"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001129947446_row15137173014380"><td class="cellrowborder" valign="top" width="19.541954195419542%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001129947446_p15137330173815"><a name="zh-cn_topic_0000001129947446_p15137330173815"></a><a name="zh-cn_topic_0000001129947446_p15137330173815"></a>key</p>
</td>
<td class="cellrowborder" valign="top" width="29.14291429142914%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001129947446_p1713863017383"><a name="zh-cn_topic_0000001129947446_p1713863017383"></a><a name="zh-cn_topic_0000001129947446_p1713863017383"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="51.315131513151314%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001129947446_p513843019386"><a name="zh-cn_topic_0000001129947446_p513843019386"></a><a name="zh-cn_topic_0000001129947446_p513843019386"></a>要查询数据的key。不能为空且长度不大于1KB</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001129947446_row111381630143817"><td class="cellrowborder" valign="top" width="19.541954195419542%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001129947446_p51381130173814"><a name="zh-cn_topic_0000001129947446_p51381130173814"></a><a name="zh-cn_topic_0000001129947446_p51381130173814"></a>callback</p>
</td>
<td class="cellrowborder" valign="top" width="29.14291429142914%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001129947446_p1013823015387"><a name="zh-cn_topic_0000001129947446_p1013823015387"></a><a name="zh-cn_topic_0000001129947446_p1013823015387"></a>AsyncCallback&lt;Uint8Array | string | boolean | number&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="51.315131513151314%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001129947446_p813819305384"><a name="zh-cn_topic_0000001129947446_p813819305384"></a><a name="zh-cn_topic_0000001129947446_p813819305384"></a>回调函数,获取查询的值。</p>
</td>
</tr>
</tbody>
</table>
- 返回值:
- 示例:
```
kvStore.get('key-001', function(err, value){
console.info(value);
});
```
### get\(key: string\): Promise<Uint8Array | string | boolean | number\><a name="zh-cn_topic_0000001129947446_section5647141894316"></a>
获取指定键的值。
此方法为异步promise方法。
- 参数:
<a name="zh-cn_topic_0000001129947446_table4647818164315"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001129947446_row16481918184315"><th class="cellrowborder" valign="top" width="19.541954195419542%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001129947446_p186481918104313"><a name="zh-cn_topic_0000001129947446_p186481918104313"></a><a name="zh-cn_topic_0000001129947446_p186481918104313"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="29.14291429142914%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001129947446_p264851804315"><a name="zh-cn_topic_0000001129947446_p264851804315"></a><a name="zh-cn_topic_0000001129947446_p264851804315"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="51.315131513151314%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001129947446_p206486189432"><a name="zh-cn_topic_0000001129947446_p206486189432"></a><a name="zh-cn_topic_0000001129947446_p206486189432"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001129947446_row136493184436"><td class="cellrowborder" valign="top" width="19.541954195419542%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001129947446_p164931854319"><a name="zh-cn_topic_0000001129947446_p164931854319"></a><a name="zh-cn_topic_0000001129947446_p164931854319"></a>key</p>
</td>
<td class="cellrowborder" valign="top" width="29.14291429142914%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001129947446_p1064991854311"><a name="zh-cn_topic_0000001129947446_p1064991854311"></a><a name="zh-cn_topic_0000001129947446_p1064991854311"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="51.315131513151314%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001129947446_p15650141834319"><a name="zh-cn_topic_0000001129947446_p15650141834319"></a><a name="zh-cn_topic_0000001129947446_p15650141834319"></a>要查询数据的key。不能为空且长度不大于1KB</p>
</td>
</tr>
</tbody>
</table>
- 返回值:
<a name="zh-cn_topic_0000001129947446_table20650161884312"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001129947446_row11650121820433"><th class="cellrowborder" valign="top" width="39.94%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001129947446_p4650181884318"><a name="zh-cn_topic_0000001129947446_p4650181884318"></a><a name="zh-cn_topic_0000001129947446_p4650181884318"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="60.06%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001129947446_p96501118194314"><a name="zh-cn_topic_0000001129947446_p96501118194314"></a><a name="zh-cn_topic_0000001129947446_p96501118194314"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001129947446_row2065071884319"><td class="cellrowborder" valign="top" width="39.94%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001129947446_p1065131812433"><a name="zh-cn_topic_0000001129947446_p1065131812433"></a><a name="zh-cn_topic_0000001129947446_p1065131812433"></a>Promise&lt;Uint8Array | string | boolean | number&gt;</p>
</td>
<td class="cellrowborder" valign="top" width="60.06%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001129947446_p2065191813435"><a name="zh-cn_topic_0000001129947446_p2065191813435"></a><a name="zh-cn_topic_0000001129947446_p2065191813435"></a>promise实例,用于获取异步返回结果。</p>
</td>
</tr>
</tbody>
</table>
- 示例:
```
const promise = kvStore.get('key-001');
promise.then((data) => {
console.info(value);
}).catch((err) => {
});
```
### sync\(deviceIdList: string\[\], mode: SyncMode, allowedDelayMs?: number\): void<a name="zh-cn_topic_0000001129947446_section06419235582"></a>
在手动模式下,触发数据库同步。
此方法为同步方法。
- 参数:
<a name="zh-cn_topic_0000001129947446_table16642172313584"></a>
<table><thead align="left"><tr id="zh-cn_topic_0000001129947446_row1064292310587"><th class="cellrowborder" valign="top" width="17.91%" id="mcps1.1.5.1.1"><p id="zh-cn_topic_0000001129947446_p9642172345810"><a name="zh-cn_topic_0000001129947446_p9642172345810"></a><a name="zh-cn_topic_0000001129947446_p9642172345810"></a>参数名</p>
</th>
<th class="cellrowborder" valign="top" width="19.009999999999998%" id="mcps1.1.5.1.2"><p id="zh-cn_topic_0000001129947446_p1264242365813"><a name="zh-cn_topic_0000001129947446_p1264242365813"></a><a name="zh-cn_topic_0000001129947446_p1264242365813"></a>类型</p>
</th>
<th class="cellrowborder" valign="top" width="24.169999999999998%" id="mcps1.1.5.1.3"><p id="zh-cn_topic_0000001129947446_p46421923185813"><a name="zh-cn_topic_0000001129947446_p46421923185813"></a><a name="zh-cn_topic_0000001129947446_p46421923185813"></a>必填</p>
</th>
<th class="cellrowborder" valign="top" width="38.91%" id="mcps1.1.5.1.4"><p id="zh-cn_topic_0000001129947446_p16426231582"><a name="zh-cn_topic_0000001129947446_p16426231582"></a><a name="zh-cn_topic_0000001129947446_p16426231582"></a>说明</p>
</th>
</tr>
</thead>
<tbody><tr id="zh-cn_topic_0000001129947446_row196421223165820"><td class="cellrowborder" valign="top" width="17.91%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001129947446_p176426239586"><a name="zh-cn_topic_0000001129947446_p176426239586"></a><a name="zh-cn_topic_0000001129947446_p176426239586"></a>deviceIdList</p>
</td>
<td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001129947446_p11642192345813"><a name="zh-cn_topic_0000001129947446_p11642192345813"></a><a name="zh-cn_topic_0000001129947446_p11642192345813"></a>string[]</p>
</td>
<td class="cellrowborder" valign="top" width="24.169999999999998%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001129947446_p196428238584"><a name="zh-cn_topic_0000001129947446_p196428238584"></a><a name="zh-cn_topic_0000001129947446_p196428238584"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="38.91%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001129947446_p564282316586"><a name="zh-cn_topic_0000001129947446_p564282316586"></a><a name="zh-cn_topic_0000001129947446_p564282316586"></a>同一组网环境下,需要同步的设备networkid列表。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001129947446_row15290171774817"><td class="cellrowborder" valign="top" width="17.91%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001129947446_p52919178483"><a name="zh-cn_topic_0000001129947446_p52919178483"></a><a name="zh-cn_topic_0000001129947446_p52919178483"></a>mode</p>
</td>
<td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001129947446_p0291617134819"><a name="zh-cn_topic_0000001129947446_p0291617134819"></a><a name="zh-cn_topic_0000001129947446_p0291617134819"></a><a href="js-apis-data-type.md#zh-cn_topic_0000001129943828_section53541759205119">SyncMode</a></p>
</td>
<td class="cellrowborder" valign="top" width="24.169999999999998%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001129947446_p1829171719482"><a name="zh-cn_topic_0000001129947446_p1829171719482"></a><a name="zh-cn_topic_0000001129947446_p1829171719482"></a>是</p>
</td>
<td class="cellrowborder" valign="top" width="38.91%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001129947446_p219412514334"><a name="zh-cn_topic_0000001129947446_p219412514334"></a><a name="zh-cn_topic_0000001129947446_p219412514334"></a>同步类型。</p>
<p id="zh-cn_topic_0000001129947446_p72914177486"><a name="zh-cn_topic_0000001129947446_p72914177486"></a><a name="zh-cn_topic_0000001129947446_p72914177486"></a>0:PUSH_ONLY, 1: PULL_ONLY, 2: PUSH_PULL</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001129947446_row7797191217527"><td class="cellrowborder" valign="top" width="17.91%" headers="mcps1.1.5.1.1 "><p id="zh-cn_topic_0000001129947446_p11797512195211"><a name="zh-cn_topic_0000001129947446_p11797512195211"></a><a name="zh-cn_topic_0000001129947446_p11797512195211"></a>allowedDelayMs</p>
</td>
<td class="cellrowborder" valign="top" width="19.009999999999998%" headers="mcps1.1.5.1.2 "><p id="zh-cn_topic_0000001129947446_p15797181210529"><a name="zh-cn_topic_0000001129947446_p15797181210529"></a><a name="zh-cn_topic_0000001129947446_p15797181210529"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="24.169999999999998%" headers="mcps1.1.5.1.3 "><p id="zh-cn_topic_0000001129947446_p10797712145215"><a name="zh-cn_topic_0000001129947446_p10797712145215"></a><a name="zh-cn_topic_0000001129947446_p10797712145215"></a>否</p>
</td>
<td class="cellrowborder" valign="top" width="38.91%" headers="mcps1.1.5.1.4 "><p id="zh-cn_topic_0000001129947446_p20797912145218"><a name="zh-cn_topic_0000001129947446_p20797912145218"></a><a name="zh-cn_topic_0000001129947446_p20797912145218"></a>可选参数。允许延时时间,单位毫秒。</p>
</td>
</tr>
</tbody>
</table>
- 返回值:
- 示例:
```
kvStore.sync(deviceIds, 1, 1000);
```
# 数据管理<a name="ZH-CN_TOPIC_0000001163812204"></a>
- **[文件管理](js-apis-fileio.md)**
- **[单版本分布式数据库](js-apis-data-singlekvstore.md)**
- **[创建和获取分布式数据库](js-apis-data-kvmanager.md)**
- **[KVManager配置信息](js-apis-data-kvmanager-config.md)**
- **[分布式数据库操作描述](js-apis-data-kvstore.md)**
- **[数据类型描述](js-apis-data-type.md)**
- **[轻量级存储](js-apis-data-storage.md)**
# 设备管理<a name="ZH-CN_TOPIC_0000001163932186"></a>
- **[设备信息](js-apis-deviceinfo.md)**
- **[系统属性](js-apis-systemparameter.md)**
- **[系统恢复](js-apis-update.md)**
- **[显示设备属性](js-apis-display.md)**
- **[电池和充电属性](js-apis-batteryinfo.md)**
- **[设置系统屏幕亮度](js-apis-brightness.md)**
- **[系统电源管理](js-apis-power.md)**
- **[Runninglock锁](js-apis-runninglock.md)**
- **[传感器](js-apis-sensor.md)**
- **[振动](js-apis-vibrate.md)**
- **[国际化(I18n)](js-apis-i18n.md)**
- **[国际化(Intl)](js-apis-intl.md)**
- **[资源管理](js-apis-resourcemanage.md)**
- **[时间设置](js-apis-systemtime.md)**
- **[升级](js-apis-libupdateclient.md)**
- **[获取进程相关的信息](js-apis-process.md)**
- **[字符串编解码](js-apis-util.md)**
- **[启动一个worker](js-apis-worker.md)**
- **[URL字符串解析](js-apis-url.md)**
# 设备信息<a name="ZH-CN_TOPIC_0000001115814850"></a>
# 设备信息<a name="ZH-CN_TOPIC_0000001163932224"></a>
- [导入模块](#zh-cn_topic_0000001139910745_section370mcpsimp)
- [权限列表](#zh-cn_topic_0000001139910745_section373mcpsimp)
......@@ -7,7 +7,7 @@
## 导入模块<a name="zh-cn_topic_0000001139910745_section370mcpsimp"></a>
```
import deviceinfo from '@ohos.deviceinfo'
import deviceInfo from '@ohos.deviceInfo'
```
## 权限列表<a name="zh-cn_topic_0000001139910745_section373mcpsimp"></a>
......
此差异已折叠。
此差异已折叠。
# 媒体<a name="ZH-CN_TOPIC_0000001209412115"></a>
- **[音频管理](js-apis-audio.md)**
- **[音频播放](js-apis-media.md)**
Notification模块(JS端SDK接口)
### Notification模块(JS端SDK接口)
#### 支持设备
......
# Radio<a name="ZH-CN_TOPIC_0000001145113322"></a>
# 网络搜索<a name="ZH-CN_TOPIC_0000001145113322"></a>
- [导入模块](#s56d19203690d4782bfc74069abb6bd71)
- [radio.getRadioTech](#section18401172810207)
......
# 应用上下文<a name="ZH-CN_TOPIC_0000001163812234"></a>
- [导入模块](#zh-cn_topic_0000001173324607_s1959b1529f574b74861e62008289bb21)
- [权限列表](#zh-cn_topic_0000001173324607_section11257113618419)
- [app.getInfo](#zh-cn_topic_0000001173324607_s0e8ff40704e442bc87a848afa47bdfbb)
- [app.terminate](#zh-cn_topic_0000001173324607_section974325124119)
## 导入模块<a name="zh-cn_topic_0000001173324607_s1959b1529f574b74861e62008289bb21"></a>
```
import app from '@system.app';
```
## 权限列表<a name="zh-cn_topic_0000001173324607_section11257113618419"></a>
## app.getInfo<a name="zh-cn_topic_0000001173324607_s0e8ff40704e442bc87a848afa47bdfbb"></a>
getInfo\(\): <[AppResponse](#zh-cn_topic_0000001173324607_t3e93239d9b134b80957bcdd4acb05291)\>
获取当前应用配置文件中声明的信息。
- 返回值
**表 1** AppResponse
<a name="zh-cn_topic_0000001173324607_t3e93239d9b134b80957bcdd4acb05291"></a>
<table><tbody><tr id="zh-cn_topic_0000001173324607_recc81d9f995d44aa87ba9d714b756569"><td class="cellrowborder" valign="top" width="19%"><p id="zh-cn_topic_0000001173324607_aa3137ce511d140fba6cc93513a7a91e3"><a name="zh-cn_topic_0000001173324607_aa3137ce511d140fba6cc93513a7a91e3"></a><a name="zh-cn_topic_0000001173324607_aa3137ce511d140fba6cc93513a7a91e3"></a>参数名</p>
</td>
<td class="cellrowborder" valign="top" width="13%"><p id="zh-cn_topic_0000001173324607_a6b166163db284e5ca8dc0190b36ae40a"><a name="zh-cn_topic_0000001173324607_a6b166163db284e5ca8dc0190b36ae40a"></a><a name="zh-cn_topic_0000001173324607_a6b166163db284e5ca8dc0190b36ae40a"></a>类型</p>
</td>
<td class="cellrowborder" valign="top" width="68%"><p id="zh-cn_topic_0000001173324607_a4ba8ead9ee7b48298d9a6ed10659f13b"><a name="zh-cn_topic_0000001173324607_a4ba8ead9ee7b48298d9a6ed10659f13b"></a><a name="zh-cn_topic_0000001173324607_a4ba8ead9ee7b48298d9a6ed10659f13b"></a>说明</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001173324607_row2557173813243"><td class="cellrowborder" valign="top" width="19%"><p id="zh-cn_topic_0000001173324607_p898462584011"><a name="zh-cn_topic_0000001173324607_p898462584011"></a><a name="zh-cn_topic_0000001173324607_p898462584011"></a>appID<sup id="zh-cn_topic_0000001173324607_sup193948321350"><a name="zh-cn_topic_0000001173324607_sup193948321350"></a><a name="zh-cn_topic_0000001173324607_sup193948321350"></a>6+</sup></p>
</td>
<td class="cellrowborder" valign="top" width="13%"><p id="zh-cn_topic_0000001173324607_p698492564013"><a name="zh-cn_topic_0000001173324607_p698492564013"></a><a name="zh-cn_topic_0000001173324607_p698492564013"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="68%"><p id="zh-cn_topic_0000001173324607_p1998432514020"><a name="zh-cn_topic_0000001173324607_p1998432514020"></a><a name="zh-cn_topic_0000001173324607_p1998432514020"></a>表示应用的包名,用于标识应用的唯一性。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001173324607_r64430cb15b54497f88ea6330b9a7454c"><td class="cellrowborder" valign="top" width="19%"><p id="zh-cn_topic_0000001173324607_a7cccea39636b47cd83188d400eed51e3"><a name="zh-cn_topic_0000001173324607_a7cccea39636b47cd83188d400eed51e3"></a><a name="zh-cn_topic_0000001173324607_a7cccea39636b47cd83188d400eed51e3"></a>appName</p>
</td>
<td class="cellrowborder" valign="top" width="13%"><p id="zh-cn_topic_0000001173324607_a2f72300143c441ef9a3fb5dc2f8e4aac"><a name="zh-cn_topic_0000001173324607_a2f72300143c441ef9a3fb5dc2f8e4aac"></a><a name="zh-cn_topic_0000001173324607_a2f72300143c441ef9a3fb5dc2f8e4aac"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="68%"><p id="zh-cn_topic_0000001173324607_a1c9b8d1829ef489e9e0fd1863190d228"><a name="zh-cn_topic_0000001173324607_a1c9b8d1829ef489e9e0fd1863190d228"></a><a name="zh-cn_topic_0000001173324607_a1c9b8d1829ef489e9e0fd1863190d228"></a>表示应用的名称。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001173324607_r4f8f612a65b24ae9b75ae53893aeb3b9"><td class="cellrowborder" valign="top" width="19%"><p id="zh-cn_topic_0000001173324607_ae036f88e139e4379abdaf4969f0720ea"><a name="zh-cn_topic_0000001173324607_ae036f88e139e4379abdaf4969f0720ea"></a><a name="zh-cn_topic_0000001173324607_ae036f88e139e4379abdaf4969f0720ea"></a>versionName</p>
</td>
<td class="cellrowborder" valign="top" width="13%"><p id="zh-cn_topic_0000001173324607_a1d379931a20144f0b6d98f5396202cd9"><a name="zh-cn_topic_0000001173324607_a1d379931a20144f0b6d98f5396202cd9"></a><a name="zh-cn_topic_0000001173324607_a1d379931a20144f0b6d98f5396202cd9"></a>string</p>
</td>
<td class="cellrowborder" valign="top" width="68%"><p id="zh-cn_topic_0000001173324607_a70c91c442f7c41439a90ceb9041252e8"><a name="zh-cn_topic_0000001173324607_a70c91c442f7c41439a90ceb9041252e8"></a><a name="zh-cn_topic_0000001173324607_a70c91c442f7c41439a90ceb9041252e8"></a>表示应用的版本名称。</p>
</td>
</tr>
<tr id="zh-cn_topic_0000001173324607_r89cf0afd5f444bd1b66ace0c31a25cda"><td class="cellrowborder" valign="top" width="19%"><p id="zh-cn_topic_0000001173324607_a3a86c086e40e475b8fb26cf43fe9a8d6"><a name="zh-cn_topic_0000001173324607_a3a86c086e40e475b8fb26cf43fe9a8d6"></a><a name="zh-cn_topic_0000001173324607_a3a86c086e40e475b8fb26cf43fe9a8d6"></a>versionCode</p>
</td>
<td class="cellrowborder" valign="top" width="13%"><p id="zh-cn_topic_0000001173324607_abcfd352ff3d84552938de0e2daf0703e"><a name="zh-cn_topic_0000001173324607_abcfd352ff3d84552938de0e2daf0703e"></a><a name="zh-cn_topic_0000001173324607_abcfd352ff3d84552938de0e2daf0703e"></a>number</p>
</td>
<td class="cellrowborder" valign="top" width="68%"><p id="zh-cn_topic_0000001173324607_af943e2ec7622407387d25d9331a01245"><a name="zh-cn_topic_0000001173324607_af943e2ec7622407387d25d9331a01245"></a><a name="zh-cn_topic_0000001173324607_af943e2ec7622407387d25d9331a01245"></a>表示应用的版本号。</p>
</td>
</tr>
</tbody>
</table>
- 示例
```
var info = app.getInfo();
console.log(JSON.stringify(info));
```
## app.terminate<a name="zh-cn_topic_0000001173324607_section974325124119"></a>
terminate\(\): void
退出当前Ability
- 示例
```
app.terminate();
```
# 系统属性<a name="ZH-CN_TOPIC_0000001162414651"></a>
# 系统属性<a name="ZH-CN_TOPIC_0000001210295633"></a>
- [导入模块](#zh-cn_topic_0000001094819718_section370mcpsimp)
- [权限列表](#zh-cn_topic_0000001094819718_section373mcpsimp)
......@@ -14,7 +14,7 @@
## 导入模块<a name="zh-cn_topic_0000001094819718_section370mcpsimp"></a>
```
import parameter from '@ohos.systemparameter'
import parameter from '@ohos.systemParameter'
```
## 权限列表<a name="zh-cn_topic_0000001094819718_section373mcpsimp"></a>
......
# 时间设置<a name="ZH-CN_TOPIC_0000001162528099"></a>
# 时间设置<a name="ZH-CN_TOPIC_0000001209417001"></a>
- [导入模块](#zh-cn_topic_0000001162403059_s56d19203690d4782bfc74069abb6bd71)
- [权限列表](#zh-cn_topic_0000001162403059_section11257113618419)
......
此差异已折叠。
此差异已折叠。
# app.js<a name="ZH-CN_TOPIC_0000001115814806"></a>
每个应用可以在app.js自定义应用级生命周期的实现逻辑,包括:
- onCreate:在应用生成时被调用的生命周期函数。
- onDestory:在应用销毁时被调用的生命周期函数。
以下示例仅在生命周期函数中打印对应日志:
```
// app.js
export default {
onCreate() {
console.info('Application onCreate');
},
onDestroy() {
console.info('Application onDestroy');
},
}
```
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
此差异已折叠。
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册