• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 使用UIExtension控件与ArkUI无障碍指南文档示例
2
3### 介绍
4
5本示例通过使用[ArkUI指南文档](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/ui)中各场景的开发示例,展示在工程中,帮助开发者更好地理解UIExtension控件与ArkUI无障碍属性并合理使用。该工程中展示的代码详细描述可查如下链接:
6
71. [跨进程应用能力扩展(UIExtension,仅对系统应用开放)](https://gitee.com/openharmony/docs/blob/OpenHarmony-5.1.0-Release/zh-cn/application-dev/ui/arkts-ui-extension-components.md)82. [同应用进程嵌入式组件 (EmbeddedComponent)](https://gitee.com/openharmony/docs/blob/OpenHarmony-5.1.0-Release/zh-cn/application-dev/ui/arkts-embedded-components.md)93. [全屏启动原子化服务组件(FullScreenLaunchComponent)](https://gitee.com/openharmony/docs/blob/OpenHarmony-5.1.0-Release/zh-cn/application-dev/ui/arkts-FullScreenComponent.md)104. [跨线程嵌入式组件 (IsolatedComponent,仅对系统应用开放)](https://gitee.com/openharmony/docs/blob/OpenHarmony-5.1.0-Release/zh-cn/application-dev/ui/arkts-isolated-components.md)115. [支持无障碍](https://gitee.com/openharmony/docs/blob/OpenHarmony-5.1.0-Release/zh-cn/application-dev/ui/arkts-universal-attributes-accessibility.md)12
13### 效果预览
14
15| 首页选项目录                                 | Isolated目录                            | Isolated示例                            |
16|------------------------------------|------------------------------------|------------------------------------|
17| ![](screenshots/device/image1.jpg) | ![](screenshots/device/image2.jpg) | ![](screenshots/device/image3.jpg) |
18
19### 使用说明
20
211. 在主界面,可以点击对应卡片,选择需要参考的组件示例。
22
232. 在组件目录选择详细的示例参考。
24
253. 进入示例界面,查看参考示例。
26
274. 通过自动测试框架可进行测试及维护。
28
29### 工程目录
30```
31entry/src/main/ets/
32|---entryability
33|---pages
34|   |---EmbeddedComponent                   // EmbeddedComponent 组件
35|   |       |---Embedded.ets
36|   |       |---Extension.ets
37|   |       |---Index.ets
38|   |---FullScreenLaunchComponent           // FullScreenLaunchComponent 组件
39|   |       |---FullScreenLaunch.ets
40|   |       |---Index.ets
41|   |---IsolatedComponent                   // IsolatedComponent 组件
42|   |       |---Extension.ets
43|   |       |---Index.ets
44|   |       |---Isolated.ets
45|   |---UIExtensionComponent                // UIExtensionComponent 组件
46|   |       |---Extension.ets
47|   |       |---Index.ets
48|   |       |---UIExtension.ets
49|   |---UniversalAttributesAccessibility    // ArkUI 无障碍能力
50|   |       |---AccessibilityFocusDrawLevel.ets
51|   |       |---AccessibilityGroup.ets
52|   |       |---AccessibilityText.ets
53|   |       |---Index.ets
54|---pages
55|   |---Index.ets                           // 应用主页面
56entry/src/ohosTest/
57|---ets
58|   |---index.test.ets                      // 示例代码测试代码
59```
60
61### 相关权限
62
63允许系统方舟运行时引擎在受限模式下执行动态下发的方舟字节码。
64
65[ohos.permission.RUN_DYN_CODE](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissionrun_dyn_code)
66
67### 依赖
68
69不涉及。
70
71### 约束与限制
72
731.本示例仅支持标准系统上运行, 支持设备:RK3568。
74
752.本示例为Stage模型,支持API20版本SDK,版本号:6.0.0.35,镜像版本号:OpenHarmony_6.0.0.35。
76
773.本示例需要使用DevEco Studio 5.0.3 Release (Build Version: 5.0.9.300, built on March 13, 2025)及以上版本才可编译运行。
78
794.本示例类型为系统应用,需要使用Full SDK,使用Full SDK时需要手动从镜像站点获取,并在DevEco Studio中替换,具体操作可参考[替换指南](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/faqs/full-sdk-switch-guide.md)80
815.本示例涉及相关权限为system_core级别(相关权限级别可通过[权限定义列表](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-all.md)查看),需要手动配置对应级别的权限签名(具体操作可查看[应用包签名工具概述](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/hapsigntool-overview.md#%E5%BA%94%E7%94%A8%E5%8C%85%E7%AD%BE%E5%90%8D%E5%B7%A5%E5%85%B7%E6%A6%82%E8%BF%B0))82
836.本示例类型为系统应用,需要手动配置对应级别的应用类型("app-feature": "hos_system_app")。具体可参考profile配置文件[bundle-info对象内部结构](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/app-provision-structure.md#bundle-info%E5%AF%B9%E8%B1%A1%E5%86%85%E9%83%A8%E7%BB%93%E6%9E%84)84
85### 下载
86
87如需单独下载本工程,执行如下命令:
88
89````
90git init
91git config core.sparsecheckout true
92echo code/DocsSample/ArkUISample/UIExtensionAndAccessibility > .git/info/sparse-checkout
93git remote add origin https://gitee.com/openharmony/applications_app_samples.git
94git pull origin master
95````