diff --git a/en/application-dev/application-dev-website.md b/en/application-dev/application-dev-website.md index 017da86056d485339aa1ae0fef864b71b4fc93eb..8abeeb5995818fe2c065238c7a67b26c1ef0424d 100644 --- a/en/application-dev/application-dev-website.md +++ b/en/application-dev/application-dev-website.md @@ -378,6 +378,7 @@ - [ImageAnimator](reference/arkui-ts/ts-basic-components-imageanimator.md) - [LoadingProgress](reference/arkui-ts/ts-basic-components-loadingprogress.md) - [Marquee](reference/arkui-ts/ts-basic-components-marquee.md) + - [Navigation](reference/arkui-ts/ts-basic-components-navigation.md) - [PatternLock](reference/arkui-ts/ts-basic-components-patternlock.md) - [PluginComponent](reference/arkui-ts/ts-basic-components-plugincomponent.md) - [Progress](reference/arkui-ts/ts-basic-components-progress.md) @@ -385,6 +386,7 @@ - [Radio](reference/arkui-ts/ts-basic-components-radio.md) - [Rating](reference/arkui-ts/ts-basic-components-rating.md) - [RichText](reference/arkui-ts/ts-basic-components-richtext.md) + - [ScrollBar](reference/arkui-ts/ts-basic-components-scrollbar.md) - [Search](reference/arkui-ts/ts-basic-components-search.md) - [Select](reference/arkui-ts/ts-basic-components-select.md) - [Slider](reference/arkui-ts/ts-basic-components-slider.md) @@ -413,14 +415,12 @@ - [GridItem](reference/arkui-ts/ts-container-griditem.md) - [List](reference/arkui-ts/ts-container-list.md) - [ListItem](reference/arkui-ts/ts-container-listitem.md) - - [Navigator](reference/arkui-ts/ts-container-navigator.md) - - [Navigation](reference/arkui-ts/ts-basic-components-navigation.md) + - [Navigator](reference/arkui-ts/ts-container-navigator.md) - [Panel](reference/arkui-ts/ts-container-panel.md) - [Refresh](reference/arkui-ts/ts-container-refresh.md) - [Row](reference/arkui-ts/ts-container-row.md) - [RowSplit](reference/arkui-ts/ts-container-rowsplit.md) - - [Scroll](reference/arkui-ts/ts-container-scroll.md) - - [ScrollBar](reference/arkui-ts/ts-basic-components-scrollbar.md) + - [Scroll](reference/arkui-ts/ts-container-scroll.md) - [SideBarContainer](reference/arkui-ts/ts-container-sidebarcontainer.md) - [Stack](reference/arkui-ts/ts-container-stack.md) - [Swiper](reference/arkui-ts/ts-container-swiper.md) diff --git a/en/application-dev/reference/arkui-ts/Readme-EN.md b/en/application-dev/reference/arkui-ts/Readme-EN.md index 0dabd2d791e50c968336d6abf7d336f7a9972740..7146aaa217157135d8d7bcaa427bf78da28df6fc 100644 --- a/en/application-dev/reference/arkui-ts/Readme-EN.md +++ b/en/application-dev/reference/arkui-ts/Readme-EN.md @@ -60,6 +60,7 @@ - [ImageAnimator](ts-basic-components-imageanimator.md) - [LoadingProgress](ts-basic-components-loadingprogress.md) - [Marquee](ts-basic-components-marquee.md) + - [Navigation](ts-basic-components-navigation.md) - [PatternLock](ts-basic-components-patternlock.md) - [PluginComponent](ts-basic-components-plugincomponent.md) - [Progress](ts-basic-components-progress.md) @@ -67,10 +68,13 @@ - [Radio](ts-basic-components-radio.md) - [Rating](ts-basic-components-rating.md) - [RichText](ts-basic-components-richtext.md) + - [ScrollBar](ts-basic-components-scrollbar.md) - [Search](ts-basic-components-search.md) - [Select](ts-basic-components-select.md) - [Slider](ts-basic-components-slider.md) - [Span](ts-basic-components-span.md) + - [Stepper](ts-basic-components-stepper.md) + - [StepperItem](ts-basic-components-stepperitem.md) - [Text](ts-basic-components-text.md) - [TextArea](ts-basic-components-textarea.md) - [TextClock](ts-basic-components-textclock.md) @@ -93,18 +97,14 @@ - [GridItem](ts-container-griditem.md) - [List](ts-container-list.md) - [ListItem](ts-container-listitem.md) - - [Navigator](ts-container-navigator.md) - - [Navigation](ts-basic-components-navigation.md) + - [Navigator](ts-container-navigator.md) - [Panel](ts-container-panel.md) - [Refresh](ts-container-refresh.md) - [Row](ts-container-row.md) - [RowSplit](ts-container-rowsplit.md) - - [Scroll](ts-container-scroll.md) - - [ScrollBar](ts-basic-components-scrollbar.md) + - [Scroll](ts-container-scroll.md) - [SideBarContainer](ts-container-sidebarcontainer.md) - [Stack](ts-container-stack.md) - - [Stepper](ts-basic-components-stepper.md) - - [StepperItem](ts-basic-components-stepperitem.md) - [Swiper](ts-container-swiper.md) - [Tabs](ts-container-tabs.md) - [TabContent](ts-container-tabcontent.md) diff --git a/en/application-dev/website.md b/en/application-dev/website.md index 1540b0dbc761f4da0b4ac8a93f891b89b57347f0..c1f5ecc92a8b2835e0b4684a4b48dbfb45511896 100644 --- a/en/application-dev/website.md +++ b/en/application-dev/website.md @@ -378,6 +378,7 @@ - [ImageAnimator](reference/arkui-ts/ts-basic-components-imageanimator.md) - [LoadingProgress](reference/arkui-ts/ts-basic-components-loadingprogress.md) - [Marquee](reference/arkui-ts/ts-basic-components-marquee.md) + - [Navigation](reference/arkui-ts/ts-basic-components-navigation.md) - [PatternLock](reference/arkui-ts/ts-basic-components-patternlock.md) - [PluginComponent](reference/arkui-ts/ts-basic-components-plugincomponent.md) - [Progress](reference/arkui-ts/ts-basic-components-progress.md) @@ -385,6 +386,7 @@ - [Radio](reference/arkui-ts/ts-basic-components-radio.md) - [Rating](reference/arkui-ts/ts-basic-components-rating.md) - [RichText](reference/arkui-ts/ts-basic-components-richtext.md) + - [ScrollBar](reference/arkui-ts/ts-basic-components-scrollbar.md) - [Search](reference/arkui-ts/ts-basic-components-search.md) - [Select](reference/arkui-ts/ts-basic-components-select.md) - [Slider](reference/arkui-ts/ts-basic-components-slider.md) @@ -413,14 +415,12 @@ - [GridItem](reference/arkui-ts/ts-container-griditem.md) - [List](reference/arkui-ts/ts-container-list.md) - [ListItem](reference/arkui-ts/ts-container-listitem.md) - - [Navigator](reference/arkui-ts/ts-container-navigator.md) - - [Navigation](reference/arkui-ts/ts-basic-components-navigation.md) + - [Navigator](reference/arkui-ts/ts-container-navigator.md) - [Panel](reference/arkui-ts/ts-container-panel.md) - [Refresh](reference/arkui-ts/ts-container-refresh.md) - [Row](reference/arkui-ts/ts-container-row.md) - [RowSplit](reference/arkui-ts/ts-container-rowsplit.md) - [Scroll](reference/arkui-ts/ts-container-scroll.md) - - [ScrollBar](reference/arkui-ts/ts-basic-components-scrollbar.md) - [SideBarContainer](reference/arkui-ts/ts-container-sidebarcontainer.md) - [Stack](reference/arkui-ts/ts-container-stack.md) - [Swiper](reference/arkui-ts/ts-container-swiper.md) diff --git a/zh-cn/application-dev/application-dev-website.md b/zh-cn/application-dev/application-dev-website.md index 07811de81d5b35f1360ab48dcfad6770897861c2..cc12d8f7f4d5999162d4d7bde1ccaf08d85ff536 100644 --- a/zh-cn/application-dev/application-dev-website.md +++ b/zh-cn/application-dev/application-dev-website.md @@ -424,6 +424,7 @@ - [ImageAnimator](reference/arkui-ts/ts-basic-components-imageanimator.md) - [LoadingProgress](reference/arkui-ts/ts-basic-components-loadingprogress.md) - [Marquee](reference/arkui-ts/ts-basic-components-marquee.md) + - [Navigation](reference/arkui-ts/ts-basic-components-navigation.md) - [PatternLock](reference/arkui-ts/ts-basic-components-patternlock.md) - [PluginComponent](reference/arkui-ts/ts-basic-components-pluginComponent.md) - [Progress](reference/arkui-ts/ts-basic-components-progress.md) @@ -431,12 +432,13 @@ - [Radio](reference/arkui-ts/ts-basic-components-radio.md) - [Rating](reference/arkui-ts/ts-basic-components-rating.md) - [RichText](reference/arkui-ts/ts-basic-components-richtext.md) + - [ScrollBar](reference/arkui-ts/ts-basic-components-scrollbar.md) - [Search](reference/arkui-ts/ts-basic-components-search.md) - [Select](reference/arkui-ts/ts-basic-components-select.md) - [Slider](reference/arkui-ts/ts-basic-components-slider.md) + - [Span](reference/arkui-ts/ts-basic-components-span.md) - [Stepper](reference/arkui-ts/ts-basic-components-stepper.md) - [StepperItem](reference/arkui-ts/ts-basic-components-stepperitem.md) - - [Span](reference/arkui-ts/ts-basic-components-span.md) - [Text](reference/arkui-ts/ts-basic-components-text.md) - [TextArea](reference/arkui-ts/ts-basic-components-textarea.md) - [TextInput](reference/arkui-ts/ts-basic-components-textinput.md) @@ -459,13 +461,13 @@ - [List](reference/arkui-ts/ts-container-list.md) - [ListItem](reference/arkui-ts/ts-container-listitem.md) - [Navigator](reference/arkui-ts/ts-container-navigator.md) - - [Navigation](reference/arkui-ts/ts-basic-components-navigation.md) + - [Panel](reference/arkui-ts/ts-container-panel.md) - [Refresh](reference/arkui-ts/ts-container-refresh.md) - [Row](reference/arkui-ts/ts-container-row.md) - [RowSplit](reference/arkui-ts/ts-container-rowsplit.md) - [Scroll](reference/arkui-ts/ts-container-scroll.md) - - [ScrollBar](reference/arkui-ts/ts-basic-components-scrollbar.md) + - [SideBarContainer](reference/arkui-ts/ts-container-sidebarcontainer.md) - [Stack](reference/arkui-ts/ts-container-stack.md) - [Swiper](reference/arkui-ts/ts-container-swiper.md) diff --git a/zh-cn/application-dev/quick-start/figures/20220329-103626.gif b/zh-cn/application-dev/quick-start/figures/20220329-103626.gif new file mode 100644 index 0000000000000000000000000000000000000000..1f3a67796fd41dce99b4256a115fd1d0733ebb79 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/20220329-103626.gif differ diff --git a/zh-cn/application-dev/quick-start/figures/SysCap_Overview.jpg b/zh-cn/application-dev/quick-start/figures/SysCap_Overview.jpg new file mode 100644 index 0000000000000000000000000000000000000000..8886b48158dff6792e55ece07158390b626cb8f1 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/SysCap_Overview.jpg differ diff --git a/zh-cn/application-dev/quick-start/figures/image-20220326064841782.png b/zh-cn/application-dev/quick-start/figures/image-20220326064841782.png new file mode 100644 index 0000000000000000000000000000000000000000..79bf756bc296a3f7129d6e646ab77248110abd06 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/image-20220326064841782.png differ diff --git a/zh-cn/application-dev/quick-start/figures/image-20220326064913834.png b/zh-cn/application-dev/quick-start/figures/image-20220326064913834.png new file mode 100644 index 0000000000000000000000000000000000000000..a48d603f708ad817997a7d89128ff392b515ccd2 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/image-20220326064913834.png differ diff --git a/zh-cn/application-dev/quick-start/figures/image-20220326064955505.png b/zh-cn/application-dev/quick-start/figures/image-20220326064955505.png new file mode 100644 index 0000000000000000000000000000000000000000..22a260f5c88a8baa9a8d41c9d64de6c462751e04 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/image-20220326064955505.png differ diff --git a/zh-cn/application-dev/quick-start/figures/image-20220326065043006.png b/zh-cn/application-dev/quick-start/figures/image-20220326065043006.png new file mode 100644 index 0000000000000000000000000000000000000000..77f386e35358d0a7af65d11e95fb690c9754e992 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/image-20220326065043006.png differ diff --git a/zh-cn/application-dev/quick-start/figures/image-20220326065124911.png b/zh-cn/application-dev/quick-start/figures/image-20220326065124911.png new file mode 100644 index 0000000000000000000000000000000000000000..ccb9ad8c7d95788d8734c6627ac12fd019ff7a4b Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/image-20220326065124911.png differ diff --git a/zh-cn/application-dev/quick-start/figures/image-20220326065201867.png b/zh-cn/application-dev/quick-start/figures/image-20220326065201867.png new file mode 100644 index 0000000000000000000000000000000000000000..a7119d0acff9135517db82072009a599e51f1b12 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/image-20220326065201867.png differ diff --git a/zh-cn/application-dev/quick-start/figures/image-20220326072448840.png b/zh-cn/application-dev/quick-start/figures/image-20220326072448840.png new file mode 100644 index 0000000000000000000000000000000000000000..93919d2bcd509a00337af36386898d025fd774b4 Binary files /dev/null and b/zh-cn/application-dev/quick-start/figures/image-20220326072448840.png differ diff --git a/zh-cn/application-dev/quick-start/syscap.md b/zh-cn/application-dev/quick-start/syscap.md new file mode 100644 index 0000000000000000000000000000000000000000..fc087039685ab1f03abe432b469c9e9c26c53511 --- /dev/null +++ b/zh-cn/application-dev/quick-start/syscap.md @@ -0,0 +1,180 @@ +# SysCap使用指南 + +## 概述 + +### 系统能力与 API + +SysCap，全称SystemCapability，即系统能力，指操作系统中每一个相对独立的特性，如蓝牙，WIFI，NFC，摄像头等，都是系统能力之一。每个系统能力对应多个 API，这些 API 绑定在一起，随着目标设备是否支持该系统能力共同存在或消失，也会随着 IDE 一起提供给开发者做联想。 + +![image-20220326064841782](figures/image-20220326064841782.png) + + + +### 支持能力集，联想能力集与要求能力集 + +支持能力集，联想能力集与要求能力集都是系统能力的集合。 +支持能力集描述的是设备能力，要求能力集描述的是应用能力。若应用A的要求能力集是设备N的支持能力集的子集，则应用A可分发到设备N上安装运行，否则不能分发。 +联想能力集是该应用开发时，IDE 可联想的 API 所在的系统能力集合。 + +![image-20220326064913834](figures/image-20220326064913834.png) + + + +### 设备与支持能力集 + +每个设备根据其硬件能力，对应不同的支持能力集。 +SDK 将设备分为两组，爆款设备和自定义设备，爆款设备的支持能力集由 OpenHarmony 来定义，自定义设备由设备厂商给出。 + +![image-20220326064955505](figures/image-20220326064955505.png) + + + +### 设备与SDK能力的对应 + +SDK 提供全量的 API 给 IDE，IDE 通过开发者的项目支持的设备，找到该设备的支持能力集，筛选支持能力集包含的 API 提供给开发者做联想。 + +![image-20220326065043006](figures/image-20220326065043006.png) + + + +## SysCap开发指导 + +### PCID导入 + +DevEco Studio 工程支持 PCID 的导入。导入的 PCID 文件解码后输出的 syscap 会被写入 syscap.json 文件中。 + +在工程目录右键后选择 Import Product Compatibility ID，即可上传 PCID 文件并导入至 syscap.json 中。 + +![20220329-103626](figures/20220329-103626.gif) + + + +### 配置联想能力集和要求能力集 + +IDE 会根据创建的工程所支持的设置自动配置联想能力集和要求能力集，开发者也可以自行修改。 +对于联想能力集，开发者通过添加更多的系统能力，在 IDE 中可以使用更多的 API，但要注意这些 API 可能在设备上不支持，使用前需要判断。 +对于要求能力集，开发者修改时要十分慎重，修改不当会导致应用无法分发到目标设备上。 + +``` +/* syscap.json */ +{ + devices: { + general: [ /*每一个爆款设备对应一个syscap支持能力集，可配置多个爆款设备*/ + “phone”, + "car, + "pc", + ... + ], + custom: [ /*厂家自定义设备*/ + { + "某自定义设备": [ + "SystemCapability.Communication.SoftBus.Core", + ... + ] + }, + ... + ] + }, + development: { /*addedSysCaps内的sycap集合与devices中配置的各设备支持的syscap集合的并集共同构成联想能力集*/ + addedSysCaps: [ + "SystemCapability.Location.Location.Lite", + ... + ] + }, + production: { /*用于生成rpcid，慎重添加，可能导致应用无法分发到目标设备上*/ + addedSysCaps: [], //devices中配置的各设备支持的syscap集合的交集，添加addedSysCaps集合再除去removedSysCaps集合，共同构成要求能力集 + removedSysCaps: [] //当该要求能力集为某设备的子集时，应用才可被分发到该设备上 + } +} +``` + + + +### 单设备应用开发 + +默认应用的联想能力集、要求系统能力集和设备的支持系统能力集相等，开发者修改要求能力集需要慎重。 + +![image-20220326065124911](figures/image-20220326065124911.png) + + + +### 跨设备应用开发 + +默认应用的联想能力集是多个设备支持能力集的并集，要求能力集则是交集。 + +![image-20220326065201867](figures/image-20220326065201867.png) + + + +### 判断 API 是否可以使用 + +首先我们定义了 API canIUse 帮助开发者来判断该工程是否支持某个特定的syscap。 + +``` +if (canIUse("SystemCapability.ArkUI.ArkUI.Full")) { + console.log("该应用支持SystemCapability.ArkUI.ArkUI.Full"); +} else { + console.log("该应用不支持SystemCapability.ArkUI.ArkUI.Full"); +} +``` + +开发者可通过 import 的方式将模块导入，若当前设备不支持该模块，import 的结果为 undefined，开发者在使用其 API 时，需要判断其是否存在。 + +``` +import geolocation from '@ohos.geolocation'; + +if (geolocation) { + geolocation.getCurrentLocation((location) => { + console.log(location.latitude, location.longitude); + }); +} else { + console.log('该设备不支持位置信息')； +} +``` + + + +### 不同设备相同能力的差异检查 + +即使是相同的系统能力，在不同的设备下，也会有能力的差异。比如同是摄像头的能力，手机比手表要强很多。 + +``` +import userAuth from '@ohos.userIAM.userAuth'; + +const authenticator = userAuth.getAuthenticator(); +const result = authenticator.checkAbility('FACE_ONLY', 'S1'); + +if (result == authenticator.CheckAvailabilityResult.AUTH_NOT_SUPPORT) { + console.log('该设备不支持人脸识别'); +} +//强行调用不支持的 API 会返回错误信息，但不会出现语法错误。 +authenticator.execute('FACE_ONLY', 'S1', (err, result) => { + if (err) { + console.log(err.message); + return; + } +}) +``` + + +### 设备间的SysCap差异如何产生的 + +设备的SysCap因产品解决方案厂商拼装的部件组合不同而不同，整体流程如下图： + +![image-20220326072448840](figures/image-20220326072448840.png) + +1、一套 OpenHarmony 源码由可选和必选部件集组成，不同的部件为对外体现的系统能力不同，即部件与 SysCap 之间映射关系。 + +2、发布归一化的 SDK，API 与 SysCap 之间存在映射关系。 + +3、产品解决方案厂商按硬件能力和产品诉求，可按需拼装部件。 + +4、产品配置的部件可以是 OpenHarmony 的部件，也可以是三方开发的私有部件，由于部件与SysCap间存在映射，所有拼装后即可得到该产品的SysCap集合。 + +5、SysCap集编码生成 PCID (Product Compatibility ID， 产品兼容性标识)，应用开发者可将 PCID 导入 IDE解码成SysCap ，开发时对设备的SysCap差异做兼容性处理。 + +6、部署到设备上的系统参数中包含了 SysCap 集，系统提供了native的接口和应用接口，可供系统内的部件和应用查询某个 SysCap 是否存在。 + +7、应用开发过程中，应用必要的 SysCap 将被编码成 RPCID（Required Product Compatibility ID），并写入应用安装包中。应用安装时，包管理器将解码 RPCID 得到应用需要的 SysCap，与设备当前具备的 SysCap 比较，若应用要求的 SysCap 都被满足，则安装成功。 + +8、应用运行时，可通过 canIUse 接口查询设备的 SysCap，保证在不同设备上的兼容性。 diff --git a/zh-cn/application-dev/reference/arkui-ts/Readme-CN.md b/zh-cn/application-dev/reference/arkui-ts/Readme-CN.md index 834c066c5e0b9b0d0dde4a9b63b029246e28d55a..daa7a83d5ac49488852dd7a67a62ae66f99ad443 100644 --- a/zh-cn/application-dev/reference/arkui-ts/Readme-CN.md +++ b/zh-cn/application-dev/reference/arkui-ts/Readme-CN.md @@ -60,6 +60,7 @@ - [ImageAnimator](ts-basic-components-imageanimator.md) - [LoadingProgress](ts-basic-components-loadingprogress.md) - [Marquee](ts-basic-components-marquee.md) + - [Navigation](ts-basic-components-navigation.md) - [PatternLock](ts-basic-components-patternlock.md) - [PluginComponent](ts-basic-components-plugincomponent.md) - [Progress](ts-basic-components-progress.md) @@ -67,10 +68,13 @@ - [Radio](ts-basic-components-radio.md) - [Rating](ts-basic-components-rating.md) - [RichText](ts-basic-components-richtext.md) + - [ScrollBar](ts-basic-components-scrollbar.md) - [Search](ts-basic-components-search.md) - [Select](ts-basic-components-select.md) - [Slider](ts-basic-components-slider.md) - [Span](ts-basic-components-span.md) + - [Stepper](ts-basic-components-stepper.md) + - [StepperItem](ts-basic-components-stepperitem.md) - [Text](ts-basic-components-text.md) - [TextArea](ts-basic-components-textarea.md) - [TextClock](ts-basic-components-textclock.md) @@ -93,18 +97,14 @@ - [GridItem](ts-container-griditem.md) - [List](ts-container-list.md) - [ListItem](ts-container-listitem.md) - - [Navigator](ts-container-navigator.md) - - [Navigation](ts-basic-components-navigation.md) + - [Navigator](ts-container-navigator.md) - [Panel](ts-container-panel.md) - [Refresh](ts-container-refresh.md) - [Row](ts-container-row.md) - [RowSplit](ts-container-rowsplit.md) - - [Scroll](ts-container-scroll.md) - - [ScrollBar](ts-basic-components-scrollbar.md) + - [Scroll](ts-container-scroll.md) - [SideBarContainer](ts-container-sidebarcontainer.md) - - [Stack](ts-container-stack.md) - - [Stepper](ts-basic-components-stepper.md) - - [StepperItem](ts-basic-components-stepperitem.md) + - [Stack](ts-container-stack.md) - [Swiper](ts-container-swiper.md) - [Tabs](ts-container-tabs.md) - [TabContent](ts-container-tabcontent.md) diff --git a/zh-cn/application-dev/security/Readme-CN.md b/zh-cn/application-dev/security/Readme-CN.md index 63e1eb9f36c78b1c8adba6b262e0299408f3ecd2..982a4503a1bbe3382a48fc607a53472d3ad4512d 100644 --- a/zh-cn/application-dev/security/Readme-CN.md +++ b/zh-cn/application-dev/security/Readme-CN.md @@ -1,16 +1,13 @@ # 安全 +- 访问控制 + - [访问控制开发概述](accesstoken-overview.md) + - [访问控制开发指导](accesstoken-guidelines.md) - 用户认证 - [用户认证开发概述](userauth-overview.md) - [用户认证开发指导](userauth-guidelines.md) - - 密钥管理 - [HUKS开发概述](huks-overview.md) - [HUKS开发指导](huks-guidelines.md) - - Hap包签名工具 - [Hap包签名工具指导](hapsigntool-guidelines.md) - -- 访问控制 - - [访问控制开发概述](accesstoken-overview.md) - - [访问控制开发指导](accesstoken-guidelines.md) diff --git a/zh-cn/application-dev/security/userauth-guidelines-api6.md b/zh-cn/application-dev/security/userauth-guidelines-api6.md deleted file mode 100644 index e10c9df90a98a5afb31585f06813fb43e4a5e05b..0000000000000000000000000000000000000000 --- a/zh-cn/application-dev/security/userauth-guidelines-api6.md +++ /dev/null @@ -1,46 +0,0 @@ -# 用户认证开发指导 - -> **说明：** -> 该开发指导匹配@ohos.userIAM.userAuth API Version 6开始支持的接口。对应接口已在API Version 8废弃，建议使用[新接口](userauth-guidelines-api8.md)。 - -## 场景介绍 - -当前用户认证支持2D人脸识别、3D人脸识别，可应用于设备解锁、应用登录、支付等身份认证场景。 - -## 接口说明 - -userIAM_userAuth模块提供了用户认证的相关方法，包括获取认证对象、认证，用户可以使用人脸等生物特征信息进行认证操作。具体接口说明可以查阅[API参考](../reference/apis/js-apis-useriam-userauth.md)。 - -**表1** 用户认证开放能力列表 - -| 接口名 | 功能描述 | -| ------------------------------------------------------------ | --------------------------------------------- | -| getAuthenticator(): Authenticator | 获取Authenticator对象，用于执行用户身份认证。 | -| execute(type: AuthType, level: SecureLevel, callback: AsyncCallback\): void | 执行用户认证，使用callback方式作为异步方法。 | -| execute(type: AuthType, level: SecureLevel): Promise\ | 执行用户认证，使用Promise方式作为异步方法。 | - -## 开发步骤 - -开发前请完成以下准备工作： - -1. 在应用配置权限文件中，增加ohos.permission.ACCESS_BIOMETRIC的权限声明。 -2. 在使用用户认证能力的代码文件中增加import userIAM_userAuth from '@ohos.userIAM.userAuth'。 - -开发过程： - -1. 获取Authenticator的单例对象，代码示例如下： - - ```js - let auth = userIAM_userAuth.getAuthenticator(); - ``` - -2. 执行认证操作，代码示例如下： - - ```js - let authenticator = userIAM_userAuth.getAuthenticator(); - authenticator.execute("FACE_ONLY", "S2").then((code) => { - console.info("auth success"); - }).catch((code) => { - console.error("auth fail, code = " + code); - }); - ``` diff --git a/zh-cn/application-dev/security/userauth-guidelines-api8.md b/zh-cn/application-dev/security/userauth-guidelines.md similarity index 100% rename from zh-cn/application-dev/security/userauth-guidelines-api8.md rename to zh-cn/application-dev/security/userauth-guidelines.md diff --git a/zh-cn/application-dev/website.md b/zh-cn/application-dev/website.md index ac723dac4eeb9eaadf15f7c5f522d3ebfbb9aadb..d2273e36d534fe48ce61f3e4d6a3315f3c85c164 100644 --- a/zh-cn/application-dev/website.md +++ b/zh-cn/application-dev/website.md @@ -440,6 +440,7 @@ - [ImageAnimator](reference/arkui-ts/ts-basic-components-imageanimator.md) - [LoadingProgress](reference/arkui-ts/ts-basic-components-loadingprogress.md) - [Marquee](reference/arkui-ts/ts-basic-components-marquee.md) + - [Navigation](reference/arkui-ts/ts-basic-components-navigation.md) - [PatternLock](reference/arkui-ts/ts-basic-components-patternlock.md) - [PluginComponent](reference/arkui-ts/ts-basic-components-plugincomponent.md) - [Progress](reference/arkui-ts/ts-basic-components-progress.md) @@ -447,12 +448,13 @@ - [Radio](reference/arkui-ts/ts-basic-components-radio.md) - [Rating](reference/arkui-ts/ts-basic-components-rating.md) - [RichText](reference/arkui-ts/ts-basic-components-richtext.md) + - [ScrollBar](reference/arkui-ts/ts-basic-components-scrollbar.md) - [Search](reference/arkui-ts/ts-basic-components-search.md) - [Select](reference/arkui-ts/ts-basic-components-select.md) - [Slider](reference/arkui-ts/ts-basic-components-slider.md) - - [Stepper](reference/arkui-ts/ts-basic-components-stepper.md) - - [StepperItem](reference/arkui-ts/ts-basic-components-stepperitem.md) - [Span](reference/arkui-ts/ts-basic-components-span.md) + - [Stepper](reference/arkui-ts/ts-basic-components-stepper.md) + - [StepperItem](reference/arkui-ts/ts-basic-components-stepperitem.md) - [Text](reference/arkui-ts/ts-basic-components-text.md) - [TextArea](reference/arkui-ts/ts-basic-components-textarea.md) - [TextClock](reference/arkui-ts/ts-basic-components-textclock.md) @@ -475,14 +477,12 @@ - [GridItem](reference/arkui-ts/ts-container-griditem.md) - [List](reference/arkui-ts/ts-container-list.md) - [ListItem](reference/arkui-ts/ts-container-listitem.md) - - [Navigator](reference/arkui-ts/ts-container-navigator.md) - - [Navigation](reference/arkui-ts/ts-basic-components-navigation.md) + - [Navigator](reference/arkui-ts/ts-container-navigator.md) - [Panel](reference/arkui-ts/ts-container-panel.md) - [Refresh](reference/arkui-ts/ts-container-refresh.md) - [Row](reference/arkui-ts/ts-container-row.md) - [RowSplit](reference/arkui-ts/ts-container-rowsplit.md) - - [Scroll](reference/arkui-ts/ts-container-scroll.md) - - [ScrollBar](reference/arkui-ts/ts-basic-components-scrollbar.md) + - [Scroll](reference/arkui-ts/ts-container-scroll.md) - [SideBarContainer](reference/arkui-ts/ts-container-sidebarcontainer.md) - [Stack](reference/arkui-ts/ts-container-stack.md) - [Swiper](reference/arkui-ts/ts-container-swiper.md)