Name Date Size

..25-Oct-20244 KiB

.gitignoreH A D25-Oct-202477

AppScope/H25-Oct-20244 KiB

build-profile.json5H A D25-Oct-20241 KiB

entry/H25-Oct-20244 KiB

hvigor/H25-Oct-20244 KiB

hvigorfile.jsH A D25-Oct-2024168

hvigorwH A D25-Oct-20242 KiB

hvigorw.batH A D25-Oct-20242 KiB

oh-package.json5H A D25-Oct-2024838

ohosTest.mdH A D25-Oct-2024437

README_zh.mdH A D25-Oct-20244.5 KiB

screenshots/device/H25-Oct-20244 KiB

README_zh.md

1# Ability与ServiceExtensionAbility通信
2
3### 介绍
4
5本示例展示通过[IDL的方式](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/IDL/idl-guidelines.md#ts%E5%BC%80%E5%8F%91%E6%AD%A5%E9%AA%A4) 和 [@ohos.rpc](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-ipc-kit/js-apis-rpc.md) 等接口实现了Ability与ServiceExtensionAbility之间的通信。
6
7### 效果预览
8
9|初始温度|刷新后的温度|
10|--------------------------------|--------------------------------|
11|![](screenshots/device/before.png)|![](screenshots/device/after.png)
12
13使用说明
14
151.启动应用后，首页展示城市的天气信息，当前温度每隔5S会刷新一次。
16
17### 工程目录
18```
19entry/src/main/ets/
20|---Application
21|---feature
22|   |---HomeFeature.ets                  // 任务信息组件
23|---MainAbility
24|---Mock
25|   |---RequestData.ts                   // 远程请求的数据
26|   |---WeatherData.ts                   // 天气页面数据
27|---model
28|   |---FormDate.ts                      // 日期函数方法
29|   |---Main.ts                          // 数据类
30|---pages
31|   |---home
32|   |   |---BasicDataSource.ets          // 懒加载封装类
33|   |   |---HomeContent.ets              // 内容组件
34|   |   |---HoursWeather.ets             // 天气组件(小时)
35|   |   |---IndexHeader.ets              // 首页头部组件
36|   |   |---MultiDayWeather.ets          // 天气组件(天)
37|   |---Home.ets                         // 首页
38|---util
39|   |---Logger.ts                        // 日志工具
40|   |---Style.ts                         // 静态样式变量
41```
42### 具体实现
43
44* Ability与ServiceExtensionAbility通信的方法主要封装在idl_weather_service_proxy、idl_weather_service_stub、HomeFeature、ServiceExtAbility中，源码参考:[idl_weather_service_proxy.ts](entry/src/main/ets/MainAbility/data/IIdlWeatherServiceTS/idl_weather_service_proxy.ts) ，[idl_weather_service_stub.ts](entry/src/main/ets/MainAbility/data/IIdlWeatherServiceTS/idl_weather_service_stub.ts) ，[HomeFeature](entry/src/main/ets/feature/HomeFeature.ts) ，[ServiceExtAbility](entry/src/main/ets/serviceExtensionAbility/ServiceExtAbility.ts) 。
45    * 建立服务器连接：通过HomeFeature中的this.context.connectAbility(want, this.options)方法来建立服务器连接；
46    * 接收服务端实例并发送请求：连接成功时new IdlWeatherServiceProxy(proxy)来接收服务端实例，通过[@ohos.rpc](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-ipc-kit/js-apis-rpc.md) 接口来执行new rpc.MessageOption(0)、 new rpc.MessageParcel()、 new rpc.MessageParcel()获取 MessageParcel对象和请求的模式，调用idl_weather_service_proxy中的this.proxy.sendRequest()来发送请求；
47    * 接收远程请求处理数据：在idl_weather_service_stub中接收远程请求并通过ServiceExtAbility中的updateWeather()函数来处理数据进行返回；
48    * 获取数据：最后将获得的数据渲染到页面中去；
49    * 断开连接：可以通过HomeFeature中的this.context.disconnectAbility(this.connection)方法来断开服务器连接，这里的this.connection是建立连接之后的返回值。
50
51### 相关权限
52
53不涉及。
54
55### 依赖
56
57不涉及。
58
59###  约束与限制
60
611.本示例仅支持标准系统上运行。
62
632.本示例为stage模型，已适配API version 9版本SDK，版本号：3.2.11.9。
64
653.本示例需要使用DevEco Studio 3.1 Beta2 (Build Version: 3.1.0.400, built on April 7, 2023)及以上版本才可编译运行。
66
674.本示例使用了ServiceExtensionAbility相关系统接口，需要替换Full SDK，使用Full SDK时需要手动从镜像站点获取，并在DevEco Studio中替换，具体操作可参考[替换指南](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/faqs/full-sdk-switch-guide.md)。
68
695.本示例使用了ServiceExtensionAbility，需要在签名证书UnsgnedReleasedProfileTemplate.json中配置"app-privilege-capabilities": ["AllowAppUsePrivilegeExtension"]，否则安装失败。具体操作指南可参考[应用特权配置指南](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-system-apps.md)。
70
71### 下载
72
73如需单独下载本工程，执行如下命令：
74```
75git init
76git config core.sparsecheckout true
77echo code/SystemFeature/IDL/AbilityConnectServiceExtension/ > .git/info/sparse-checkout
78git remote add origin https://gitee.com/openharmony/applications_app_samples.git
79git pull origin master
80
81```