extension示例

介绍

本示例实现了一个inputMethod独立extension，并验证独立extension与UIExtension之间的文件共享，实现了以下几点功能：

1.实现一个inputMethod独立extension：InputMethodService.ets。

2.UIExtension与inputMethod独立extension实现文件共享。

效果预览

首页	访问模块级别独立沙箱文件	访问应用级别独立沙箱文件

使用说明

1. 启动一个主应用 "hdc shell aa start -a EntryAbility -b com.example.contexttest"。点击前两个按钮，uiAbility分别以dataGroupId为" test1"、"test2"产生的共享目录下创建共享文件,创建成功后会有创建成功弹框提示，创建失败会有创建失败弹框提示，预期结果为创建成功；

2. 启动一个inputMethod独立extension应用： "hdc shell aa start -a inputMethod -b com.example.contexttest"，inputMethod可在dataGroupId为"test1" 产生的共享目录下修改共享文件，修改成功查看打印相关日志：1:the content of file:1:inputMethod Try to write str.，修改失败查看相关打印日志：1：fs.openSync err: {"code":13900002},预期结果为修改成功;在dataGroupId为" test2"产生的共享目录下修改共享文件,修改成功查看打印相关日志：2:the content of file:2:inputMethod Try to write str.，修改失败查看相关打印日志：2：fs.openSync err: {"code":13900002}，预期结果为修改失败；

3. 点击第三个按钮，UIAbility访问inputMethod module级别的独立extension的沙箱文件，访问成功会有访问成功弹框提示;访问失败会有访问失败弹框提示且页面的message更新为moduleFailed；预期结果访问失败，证明inputMethod是独立沙箱；

4. 点击第四个按钮，UIAbility访问inputMethod应用级别的独立extension的沙箱文件，访问成功会有访问成功弹框提示;访问失败会有访问失败弹框提示且页面的message更新为appFailed；预期结果访问失败，证明inputMethod是独立沙箱；

5. 以上预期结果设备皆为Phone，RK3568内配置文件未将inputMethod设置为独立沙箱，因此所有操作皆可成功。

工程目录

entry/src/main/ets/
|---entryability
|---inputMethodextability
    |---pages
        |---inputMethodService.ets            // input独立extension
|---pages
|   |---Index.ets                            // 首页
entry/src/ohosTest/ets/
|---test
|   |---Ability.test.ets                     // xts用例    

具体实现

• 示例分为两个方面

• inputMethod独立extension与UIExtension实现共享目录下文件共享：

  • 使用getGroupDir接口，创建共享目录下的共享文件，dataGroupId相同的共享目录下的共享文件可以实现文件共享，反之不能实现共享。
  • 源码参考：Index.ets，InputMethodService.ets
  • 接口参考：context.d

• inputMethod独立extension访问其独立沙箱文件且能正常操作文件，另外的应用不能访问其沙箱文件：

  • 使用openSync、writeSync、closeSync等接口实现对沙箱文件的创建、读、写等操作。
  • 源码参考：Index.ets，InputMethodService.ets
  • 接口参考：@ohos.file.fs.d

相关权限

不涉及。

依赖

不涉及。

约束与限制

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

2.本示例为Stage模型，支持API12版本SDK，SDK版本号(API Version 12 Release),镜像版本号(5.0.0.20)。

3.本示例需要使用DevEco Studio 版本号(4.1.0.400)及以上版本才可编译运行。

4.本示例需要使用Full SDK编译。使用Full SDK时需要手动从镜像站点获取，并在DevEco Studio中替换，具体操作可参考替换指南。

5.本实例需要用到相同dataGroupId实现共享文件，所以需要在签名证书UnsgnedReleasedProfileTemplate.json中的"bundle-info"配置项中添加配置如：" data-group-ids":["test1","test2","test3"]，同时需要在module.json5中的extensionAbilities中添加配置如：" dataGroupIds": ["test1"] ，只有当前extension和应用配置相同dataGroupId，才可以和应用共享这一个dataGroupId生成的目录。具体操作指南可参考HarmonyAppProvision配置文件说明。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo code/BasicFeature/Extension/Contexttest/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master