diff --git a/README.md b/README.md index 3eb5d41b..ad12ae21 100755 --- a/README.md +++ b/README.md @@ -1,105 +1,32 @@ -# Distributed Scheduler - -- [Introduction](#section11660541593) -- [System Architecture](#section13587185873516) -- [Directory Structure](#section161941989596) -- [Constraints](#section119744591305) -- [Usage](#section10729231131110) -- [Repositories Involved](#section1371113476307) +# Distributed Scheduler ## Introduction Distributed Scheduler is used for cross-device component management. It allows the local device to access or control remote components, and enables app collaboration in distributed scenarios. Its main functions are as follows: -- Remote FA startup: Starts a Feature Ability (FA) on a remote device. -- Remote FA migration: Migrates an FA to a remote device. -- Remote AA binding: Binds an AA on a remote device. - +- Remote ability startup: Starts an ability on a remote device. +- Remote ability migration: Migrates an ability to a remote device. +- Remote ability binding: Binds an ability on a remote device. ## System Architecture -![](figures/dms-architecture.png) +**Figure 1** Distributed Scheduler architecture -**Figure 1** Distributed Scheduler architecture + +![](figures/dms-architecture.png) ## Directory Structure -The main code directory structure of Distributed Scheduler is as follows: - ``` -/foundation/distributedschedule/dmsfwk -├── interfaces # API definition -├── services # Core functions -│ └── dtbschedmgr -│ ├── include -│ │ ├── ability_connection_wrapper_stub.h # Connection callback wrapper class -│ │ ├── adapter -│ │ │ └── dnetwork_adapter.h # DSoftBus adaptation layer -│ │ ├── bundle -│ │ │ └── bundle_manager_internal.h # BMS function wrapper class -│ │ ├── caller_info.h # Basic information about the caller -│ │ ├── connect_death_recipient.h # APIs that listen for connection callback death events -│ │ ├── continuation_callback_death_recipient.h # APIs that listen for continuation callback death events -│ │ ├── deviceManager -│ │ │ └── dms_device_info.h # APIs for defining and obtaining device information -│ │ ├── distributed_device_node_listener.h # APIs for listening for device online/offline events -│ │ ├── distributed_sched_ability_shell.h # Continuation callback management APIs -│ │ ├── distributed_sched_adapter.h # DMS adaptation layer -│ │ ├── distributed_sched_continuation.h # Continuation token management APIs -│ │ ├── distributed_sched_dumper.h # Dump APIs -│ │ ├── distributed_sched_interface.h # External APIs -│ │ ├── distributed_sched_permission.h # Permission verification APIs -│ │ ├── distributed_sched_proxy.h # Proxy APIs -│ │ ├── distributed_sched_service.h # Service APIs -│ │ ├── distributed_sched_stub.h # Stub APIs -│ │ ├── dtbschedmgr_device_info_storage.h # Device information storage management -│ │ ├── dtbschedmgr_log.h # Log module -│ │ ├── parcel_helper.h # Definition of auxiliary macros for serialization/deserialization -│ │ └── uri.h -│ ├── src -│ │ ├── ability_connection_wrapper_stub.cpp # Implementation of the connection callback wrapper class -│ │ ├── adapter -│ │ │ └── dnetwork_adapter.cpp # DSoftBus adaptation layer -│ │ ├── bundle -│ │ │ └── bundle_manager_internal.cpp # Implementation of the BMS function wrapper class -│ │ ├── connect_death_recipient.cpp # Implementation of the listening for connection callback death events -│ │ ├── continuation_callback_death_recipient.cpp # Implementation of the continuation callback death events -│ │ ├── deviceManager -│ │ │ └── dms_device_info.cpp # Implementation of the APIs for obtaining device information -│ │ ├── distributed_device_node_listener.cpp # Implementation of the APIs for device online/offline event listening -│ │ ├── distributed_sched_ability_shell.cpp # Implementation of continuation callback management -│ │ ├── distributed_sched_adapter.cpp # Implementation of the DMS adaptation layer -│ │ ├── distributed_sched_continuation.cpp # Implementation of continuation token management -│ │ ├── distributed_sched_dumper.cpp # Dump Implementation -│ │ ├── distributed_sched_permission.cpp # Permission verification implementation -│ │ ├── distributed_sched_proxy.cpp # Proxy implementation -│ │ ├── distributed_sched_service.cpp # Server implementation -│ │ ├── distributed_sched_stub.cpp # Stub implementation -│ │ └── dtbschedmgr_device_info_storage.cpp # Implementation of device information storage management -│ └──── BUILD.gn -├── sa_profile -├── utils -├── LICENSE +/foundation/distributedschedule +├── dmsfwk # DMS framework (DMS is short for Distributed Manager Service, also called the Distributed Scheduler Service) +├── dms_fwk_lite # Lightweight DMS framework ``` -## Constraints - -- The devices between which you want to set up a connection must be in the same LAN. -- Before setting up a connection between two devices, you must bind the devices. For details about the binding process, see relevant descriptions in the Security subsystem readme file. - -## Usage - -- **Compiling and Building Distributed Scheduler** - -The code of Distributed Scheduler is stored in the following directory: - -``` -foundation/distributedschedule/dmsfwk -``` - - ## Repositories Involved -Distributed Scheduler +**Distributed Scheduler** -[distributedschedule\_dms\_fwk](https://https://gitee.com/openharmony/distributedschedule_dms_fwk) +distributedschedule\_dms\_fwk + +distributedschedule\_dms\_fwk\_lite \ No newline at end of file diff --git a/README_zh.md b/README_zh.md index 858ca9a2..206a8d95 100755 --- a/README_zh.md +++ b/README_zh.md @@ -1,105 +1,37 @@ -# 分布式调度组件 +# 分布式组件管理部件 - [简介](#section11660541593) - [系统架构](#section13587185873516) - [目录](#section161941989596) -- [约束](#section119744591305) -- [使用](#section10729231131110) - [相关仓](#section1371113476307) ## 简介 -分布式任务调度模块负责跨设备组件管理，提供访问和控制远程组件的能力，支持分布式场景下的应用协同。主要功能如下： +分布式组件管理部件模块负责跨设备组件管理，提供访问和控制远程组件的能力，支持分布式场景下的应用协同。主要功能如下： -- 远程启动FA：跨设备拉起远端设备上指定FA。 -- 远程迁移FA：将FA跨设备迁移到远端。 -- 远程绑定AA：跨设备绑定远端设备上指定AA。 +- 远程启动元能力：跨设备拉起远端设备上的指定元能力。 +- 远程迁移元能力：将元能力跨设备迁移到远端设备。 +- 远程绑定元能力：跨设备绑定远端设备上的指定元能力。 + +## 分布式组件管理部件架构 + +**图 1** 分布式组件管理部件架构图 -## 系统架构 - -![](figures/dms-architecture_zh.png) - -**图 1** 分布式调度组件架构图 +![](figures/dms-architecture-zh.png) ## 目录 -分布式调度组件主要代码目录结构如下： - ``` -/foundation/distributedschedule/dmsfwk -├── interfaces # 接口定义 -├── services # 核心功能 -│   └── dtbschedmgr -│   ├── include -│   │   ├── ability_connection_wrapper_stub.h # 绑定回调封装类 -│   │   ├── adapter -│   │   │   └── dnetwork_adapter.h # 软总线适配层 -│   │   ├── bundle -│   │   │   └── bundle_manager_internal.h # bms功能封装接口 -│   │   ├── caller_info.h # 调用方基本信息 -│   │   ├── connect_death_recipient.h # 绑定回调死亡监听接口 -│   │   ├── continuation_callback_death_recipient.h # 迁移回调死亡监听接口 -│   │   ├── deviceManager -│   │   │   └── dms_device_info.h # 设备信息定义和获取接口 -│   │   ├── distributed_device_node_listener.h # 设备上下线监听接口 -│   │   ├── distributed_sched_ability_shell.h # 迁移回调管理接口 -│   │   ├── distributed_sched_adapter.h # dms适配层 -│   │   ├── distributed_sched_continuation.h # 迁移token管理接口 -│   │   ├── distributed_sched_dumper.h # dump接口 -│   │   ├── distributed_sched_interface.h # 对外接口 -│   │   ├── distributed_sched_permission.h # 权限校验接口 -│   │   ├── distributed_sched_proxy.h # proxy端接口 -│   │   ├── distributed_sched_service.h # 服务端接口 -│   │   ├── distributed_sched_stub.h # stub端接口 -│   │   ├── dtbschedmgr_device_info_storage.h # 设备信息存储管理 -│   │   ├── dtbschedmgr_log.h # 日志模块 -│   │   ├── parcel_helper.h # 序列化/反序列化辅助宏定义 -│   │   └── uri.h -│   ├── src -│   │   ├── ability_connection_wrapper_stub.cpp # 绑定回调封装类实现 -│   │   ├── adapter -│   │   │   └── dnetwork_adapter.cpp # 软总线适配层 -│   │   ├── bundle -│   │   │   └── bundle_manager_internal.cpp # bms功能封装实现 -│   │   ├── connect_death_recipient.cpp # 绑定回调死亡监听实现 -│   │   ├── continuation_callback_death_recipient.cpp # 迁移回调死亡监听实现 -│   │   ├── deviceManager -│   │   │   └── dms_device_info.cpp # 设备信息获取接口实现 -│   │   ├── distributed_device_node_listener.cpp # 设备上下线监听实现 -│   │   ├── distributed_sched_ability_shell.cpp # 迁移回调管理实现 -│   │   ├── distributed_sched_adapter.cpp # dms适配层实现 -│   │   ├── distributed_sched_continuation.cpp # 迁移token管理实现 -│   │   ├── distributed_sched_dumper.cpp # dump实现 -│   │   ├── distributed_sched_permission.cpp # 权限校验实现 -│   │   ├── distributed_sched_proxy.cpp # proxy端实现 -│   │   ├── distributed_sched_service.cpp # 服务端实现 -│   │   ├── distributed_sched_stub.cpp # stub端实现 -│   │   └── dtbschedmgr_device_info_storage.cpp # 设备信息存储管理实现 -│   └──── BUILD.gn -├── sa_profile -├── utils -├── LICENSE +/foundation/distributedschedule +├── dmsfwk # 分布式组件管理部件模块 +├── dms_fwk_lite # 轻量分布式组件管理部件模块 ``` -## 约束 - -- 组网设备需在同一局域网中。 -- 组网之前，需先完成设备绑定，绑定流程参见安全子系统中说明。 - -## 使用 - -- **分布式任务调度模块编译** - -分布式任务调度模块，其代码所在目录如下： - -``` -foundation/distributedschedule/dmsfwk -``` - - ## 相关仓 -分布式任务调度子系统 +**分布式组件管理部件** -[distributedschedule\_dms\_fwk](https://https://gitee.com/openharmony/distributedschedule_dms_fwk) \ No newline at end of file +distributedschedule\_dms\_fwk + +distributedschedule\_dms\_fwk\_lite \ No newline at end of file diff --git a/figures/dms-architecture-zh.png b/figures/dms-architecture-zh.png new file mode 100644 index 00000000..f1280858 Binary files /dev/null and b/figures/dms-architecture-zh.png differ diff --git a/figures/dms-architecture.png b/figures/dms-architecture.png index 1b7001cc..e16d44ad 100644 Binary files a/figures/dms-architecture.png and b/figures/dms-architecture.png differ diff --git a/figures/dms-architecture_zh.png b/figures/dms-architecture_zh.png deleted file mode 100755 index 588c3375..00000000 Binary files a/figures/dms-architecture_zh.png and /dev/null differ