1# 分布式备忘录 2 3### 介绍 4 5本示例展示了在eTS中如何使用分布式数据对象实现一个简单的分布式备忘录。 6 7本示例用到了分布式设备管理能力接口(设备管理)，实现设备之间的distributedDataObject对象的数据传输交互[@ohos.distributedDeviceManager](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-distributedservice-kit/js-apis-distributedDeviceManager.md)。 8 9分布式数据管理接口[@ohos.data.distributedData](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-arkdata/js-apis-distributed-data.md)。 10 11用到了权限管理能力[@ohos.abilityAccessCtrl](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-ability-kit/js-apis-abilityAccessCtrl.md)。 12 13分布式数据对象接口[@ohos.data.distributedDataObject](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-arkdata/js-apis-data-distributedobject.md)。 14 15 16### 效果预览 17| 首页 | Note主页 | Canvas主页 | 18| --------------------------------------- | ------------------------------------- | ----------------------------------------- | 19|  |  |  | 20 21 22使用说明 23 241. 启动应用，选择允许授权后，选择不同的分布式对象进入，如选择distributiedNote，则进入笔记界面： 25 1. 点击右上角按钮可以连接组网设备，选择设备后进行连接，连接成功后两个设备上首页状态均显示绿色，每次连接其他设备，界面会清空备忘录内容。 26 2. 点击**添加**按钮进入添加界面，可以编辑标题、内容、标记颜色，点击**提交**按钮添加备忘录。 27 3. 点击**清除**按钮清除所有备忘录内容。 28 4. 点击已经添加的备忘录可以进入编辑界面更新备忘录内容，编辑完成后点击**提交**按钮更新备忘录。 29 5. 两台设备连接成功后步骤2、3、4的操作会同步到另一台设备上。 302. 如选择distributiedCanvas，则进入画布界面： 31 1. 点击右上角按钮可以连接组网设备，选择设备后进行连接，连接成功后两个设备上首页状态均显示绿色。 32 2. 点击ellipse或者rect按钮，则进行绘制对应的图形。 33 3. 点击delete，则删除所有绘制的图形。 34 4. 两台设备连接成功后步骤2、3的操作会同步到另一台设备上。 35 5. 点击back按钮，则回退到选择分布式对象的首页。 36 37 38 39#### 相关概念 40 41分布式数据对象：组网内的设备，通过创建相同sessionId的分布式数据对象，修改分布式对象时，对端设备可以监听到数据变化并获取到新的数据，从而实现不同设备间的数据交换。 42 43### 工程目录 44``` 45entry/src/main/ets/ 46|---pages 47| |---index.ets // 选择分布式对象首页 48| |---Edit.ets // 编写笔记页面 49| |---IndexCanvas.ets // 画布首页 50| |---IndexNote.ets // 笔记页面 51|---MainAbility 52| |---MainAbility.ts // 请求用户授权 53|---model 54| |---Const.ts // 静态资源模块（笔记标记颜色的图片资源） 55| |---DistributedObjectModel.ts // 分布式Note数据对象类 56| |---DistributedCanvasModel.ts // 分布式Canvas数据对象类 57| |---Note.ts // Note对象操作类 58| |---Canvas.ts // Canvas对象操作类 59| |---RemoteDeviceModel.ts // 远程设备操作类 60|---common 61| |---BasicDataSource.ets // 初始化数据模块 62| |---NoteItem.ets // 笔记列表模块 63| |---DeviceDialog.ets // 分布式设备列表弹窗 64| |---TitleBar.ets // 菜单栏模块 65``` 66 67### 具体实现 68在分布式笔记应用中，分布式设备管理包含了分布式设备搜索、分布式设备列表弹窗、远端设备拉起三部分。 69首先在分布式组网内搜索设备，然后把设备展示到分布式设备列表弹窗中，最后根据用户的选择拉起远端设备。 70#### 分布式设备搜索 71通过SUBSCRIBE_ID搜索分布式组网内的设备，详见startDeviceDiscovery(){}模块[源码参考](entry/src/main/ets/model/RemoteDeviceModel.ts )。 72#### 分布式设备列表弹窗 73使用@CustomDialog装饰器来装饰分布式设备列表弹窗，[源码参考](entry/src/main/ets/common/DeviceDialog.ets )。 74#### 远端设备拉起 75通过startAbility(deviceId)方法拉起远端设备的包，[源码参考](entry/src/main/ets/pages/Index.ets )。 76#### 分布式数据管理 77(1) 管理分布式数据库 78创建一个distributedObject分布式数据对象实例，用于管理分布式数据对象。详见distributedObject.createDistributedObject()，[源码参考](entry/src/main/ets/model/DistributedObjectModel.ts )。 79(2) 订阅分布式数据变化 80通过this.distributedObject.on('status', this.statusCallback)监听分布式数据对象的变更。 81 82#### 笔记 83(1)UIAbility拉起弹框请求用户授权:在onCreate()时通过abilityAccessCtrl.createAtManager.requestPermissionsFromUser(this.context, ['ohos.permission.DISTRIBUTED_DATASYNC']).then((data)=> {})获取不同设备间的数据交换权限，[源码参考](entry/src/main/ets/MainAbility/MainAbility.ts )。 84(2)将sessionID存在应用全局的UI状态存储AppStorage内：在onCreate(want, launchParam) {}时拿到sessionId并存储在AppStorage内，并把同时把sessionId绑定到@StorageLink上实现双向数据绑定。 85(3)对笔记内容进行存储在dataArray:note[]中：通过this.noteDataSource['dataArray'] = this.globalObject.distributedObject.documents。 86(4)笔记内容更新：通过绑定Button的onClick事件指定this.globalObject.update(index, this.note.title, this.note.content, this.note.mark)进行笔记内容和状态更新，[源码参考](entry/src/main/ets/pages/Edit.ets )。 87(5)实现分布式数据自动同步：通过this.globalObject.distributedObject.setSessionId(this.sessionId)，从而实现当可信组网中有多个设备时，多个设备间的对象如果设置为同一个sessionId的笔记数据自动同步，并将其封装在share()函数内，[源码参考](entry/src/main/ets/pages/Index.ets )。 88(6)在首页的onPageShow()钩子中，调用share()实现首页在分布式设备上同步渲染组件。 89### 相关权限 90 91允许不同设备间的数据交换：[ohos.permission.DISTRIBUTED_DATASYNC](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-all.md#ohospermissiondistributed_datasync)。 92 93允许系统应用获取分布式设备的认证组网能力：[ohos.permission.ACCESS_SERVICE_DM](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-system-apps.md#ohospermissionaccess_service_dm)。 94 95### 依赖 96 97不涉及 98 99### 约束与限制 100 1011.本示例仅支持标准系统上运行。 102 1032.本示例为Stage模型，已适配API version 10版本SDK，版本号：4.0.9.1，镜像版本号：OpenHarmony4.0.9.1。 104 1053.本示例需要使用DevEco Studio 3.1 Beta2 (Build Version: 3.1.0.400, built on April 7, 2023)及以上版本才可编译运行。 106 1074.本示例需要使用@ohos.distributedDeviceManager系统权限的系统接口。使用Full SDK时需要手动从镜像站点获取，并在DevEco Studio中替换，具体操作可参考[替换指南](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/faqs/full-sdk-switch-guide.md)。 108 1095.本示例所配置的权限均为system_basic或system_core级别(相关权限级别可通过[权限定义列表](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/AccessToken/permissions-for-system-apps.md)查看)，需要手动配置对应级别的权限签名(具体操作可查看[自动化签名方案](https://gitee.com/link?target=https%3A%2F%2Fdocs.openharmony.cn%2Fpages%2Fv4.1%2Fzh-cn%2Fapplication-dev%2Fsecurity%2Fhapsigntool-overview.md%2F))。 110 1116.本示例类型为系统应用，需要手动配置对应级别的应用类型("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对象内部结构)。 112 113### 下载 114 115如需单独下载本工程，执行如下命令： 116``` 117git init 118git config core.sparsecheckout true 119echo code/SuperFeature/DistributedAppDev/DistributedNote/ > .git/info/sparse-checkout 120git remote add origin https://gitee.com/openharmony/applications_app_samples.git 121git pull origin master 122```
