# Window Extension Ability

### Introduction

This sample simulates the **Setting** app, where you can touch the menu bar to go to the details page.

In this sample, the [Window Extension Ability](https://gitee.com/openharmony/docs/blob/master/en/application-dev/reference/apis-arkui/js-apis-application-windowExtensionAbility-sys.md) is used to set abilities, and [AbilityComponent](https://gitee.com/openharmony/docs/blob/master/en/application-dev/reference/apis-arkui/arkui-ts/ts-container-ability-component-sys.md) is used to load abilities.

### Usage

1. In portrait mode, touch the **Setting** menu bar on the left. The details page is displayed.

2. In landscape mode, touch the **Setting** menu bar on the left. The details page is displayed on the right.

### Preview

![](screenshots/device/en/index.png) ![](screenshots/device/en/wlan.png)
![](screenshots/device/en/bluetooth.png) ![](screenshots/device/en/mobileData.png)

### Required Permissions

N/A

### Dependency

N/A

### Constraints

1. This sample can only be run on standard-system devices that use the Rockchip RK3568 chip.

2. This sample demonstrates the stage model, which supports only the SDK of API version 9 (SDK version: 3.2.6.3 Beta2).

3. DevEco Studio 3.1 Canary1 (Build Version: 3.1.0.100) must be used.

4. **WindowExtensionAbility** and **AbilityComponent** are system APIs and require the use of the Full SDK. To use the Full SDK, you must manually obtain it from the mirror and switch to it in DevEco Studio. For details, see [Guide to Switching to Full SDK](https://docs.openharmony.cn/pages/v3.2/en/application-dev/quick-start/full-sdk-switch-guide.md/).

# 窗口扩展应用（仅对系统应用开放）

### 介绍

本示例仿设置应用，实现点击设置菜单栏，跳转或加载详情页面。

本示例通过 [UIExtensionAbility](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiExtensionAbility.md) 设置不同Ability，使用 [UIExtensionComponent](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-ui-extension-component-sys.md) 组件加载各个Ability。

### 效果预览

|主页| WLAN页面                              | 蓝牙页面                                     | 移动数据页面                                    |
|--------------------------------|-------------------------------------|------------------------------------------|-------------------------------------------|
|![](screenshots/device/zh/index.png) | ![](screenshots/device/zh/wlan.png) | ![](screenshots/device/zh/bluetooth.png) | ![](screenshots/device/zh/mobileData.png) |

使用说明：

1.竖屏模式下点击左侧设置菜单栏，跳转详情页面。

2.横屏模式下（只支持带有重力感应设备）点击左侧设置菜单栏，右侧显示详情页面。

### 工程目录
```
entry/src/main/ets/
|---Application
|   |---MyAbilityStage.ts
|---feature
|   |---Logger.ts                           // 日志工具
|---MainAbility
|   |---BluetoothExtAbility.ts
|   |---MainAbility.ts
|   |---MobileDataExtAbility.ts
|   |---WlanExtAbility.ts
|---mock
|   |---InfoData.ts                         // 数据类型
|---pages
|   |---common
|   |   |---Common.ets                      // 全局通用组件
|   |---Index.ets                           // 首页
|   |---Bluetooth.ets                       // 蓝牙
|   |---MobileData.ets                      // 移动数据
|   |---Wlan.ets                            // Wlan
```
### 具体实现

* 本示例通过窗口扩展能力设置不同Ability，使用AbilityComponent组件加载各个Ability，matchMediaSync方法设置媒体查询的查询条件，RemoteObject方法实现远程对象。
* 源码链接：[WlanExtAbility.ts](entry/src/main/ets/MainAbility/WlanExtAbility.ts)，[BluetoothExtAbility.ts](entry/src/main/ets/MainAbility/BluetoothExtAbility.ts)，[MobileDataExtAbility.ts](entry/src/main/ets/MainAbility/MobileDataExtAbility.ts)
* 接口参考：[@ohos.app.ability.UIExtensionAbility](https://gitee.com/openharmony/docs/tree/master/zh-cn/application-dev/reference/apis-ability-kit/js-apis-app-ability-uiExtensionAbility.md)，[UIExtensionComponent](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-container-ui-extension-component-sys.md)

### 相关权限

不涉及。

### 依赖

不涉及。

### 约束与限制

1.本示例仅支持标准系统上运行，支持设备：支持RK3568。

2.本示例已适配API version 14版本SDK，版本号：5.0.2。

3.本示例需要使用DevEco Studio 5.0.2 Release (Build Version: 5.0.7.210, built on February 11, 2025)及以上版本才可编译运行。

4.本示例使用的UIExtensionAbility、UIExtensionComponent均为系统接口，需要使用Full SDK手动从镜像站点获取，并在DevEco Studio中替换，具体操作可参考[替换指南](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/faqs/full-sdk-switch-guide.md)。

### 下载

如需单独下载本工程，执行如下命令：
```
git init
git config core.sparsecheckout true
echo code/SystemFeature/WindowManageMent/WindowExtAbility/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master

```