# Distributed Calculator

### Introduction

This sample implements a simple calculator app using JS distributed features. The calculator can perform simple numerical calculations and start a remote calculator Feature Ability \(FA\) to perform collaborative calculation.

-   Remote startup:  **StartAbility**  is used to start a remote app.
-   Collaborative calculation: The  **DistributedDataKit**  distributed data framework is used to implement data synchronization between remote applications.

### Usage

-   Touch the icon on the desktop to start the calculator.
-   Touch the button in the upper right corner of the app, or swipe up, down, left, or right on the screen to display the device selection box.
-   In the device selection box, touch the name of a peer device to start the remote app.
-   After the remote app is started, perform operations on the app at either end. Data can be synchronized between the two apps in real time.
-   In the device selection box, touch the local device to close the remote app.

### Constraints

-   This calculator implements only simple addition, subtraction, multiplication, and division operations. You can implement more complex arithmetic operations on the  **calc**  page based on the current framework.
-   Distributed computing can be implemented only with distributed networking.

# 分布式计算器

### 简介

本示例使用JS分布式能力实现了一个简单的计算器应用，可以进行简单的数值计算，支持远程拉起另一个计算器FA，两个FA进行协同计算。

远程拉起：通过StartAbility实现远端应用的拉起。

协同计算：通过DistributedDataKit分布式数据框架实现异端应用的数据同步。实现效果如下：

![](./screenshots/devices/main.png)

### 相关概念

数据管理实例： 用于获取KVStore的相关信息。

单版本分布式数据库：继承自KVStore，不对数据所属设备进行区分，提供查询数据和同步数据的方法。

### 相关权限

允许不同设备间的数据交换：ohos.permission.DISTRIBUTED_DATASYNC

### 使用说明

1.点击桌面应用图标，启动应用。

2.点击应用右上角按钮，即可弹出设备选择框。

3.在设备选择框中点击对端设备名称，拉起对端应用。

4.对端应用启动后，可在任意一端中操作应用，两端应用可实现数据实时同步。

5.在设备选择框中选中本机即可关闭对端应用。

### 约束与限制

1.本示例只实现简单的加减乘除功能，后续开发者可基于当前框架考虑在calc页面中实现更多的功能，如开方、立方、三角函数等科学计算功能。

2.本示例在编译前需安装三方mathjs库，具体安装步骤见[npm](https://gitee.com/openharmony/app_samples/blob/master/EngineeringCapability/Npm/README_zh.md)。

3.分布式计算功能使用的前提是分布式组网。

4.本示例需要使用DevEco Studio 3.0 Beta4 (Build Version: 3.0.0.992, built on July 14, 2022)才可编译运行。

5.本示例需要使用@ohos.distributedHardware.deviceManager系统权限的系统接口。使用Full SDK时需要手动从镜像站点获取，并在DevEco Studio中替换，具体操作可参考[替换指南](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/quick-start/full-sdk-switch-guide.md/)。

6.如果安装本示例报错为error：install sign info inconsistent，则有可能本应用被设置为系统预置应用，已安装在系统中，此时需使用命令进行替换安装，并在替换安装后对设备进行重启操作，具体命令如下：

hdc shell mount -o rw,remount /

hdc file send ./entry-default-signed.hap /system/app/com.example.distributedcalc/Calc_Demo.hap

hdc shell  reboot

等设备重启后即可完成应用的替换安装，无需其他操作。