1. Overview
2. Features
3. Requirements
4. Installation
5. Quick Start Guide
6. Project Structure
7. Configuration
8. Usage
9. Documentation
10. Contributing
11. Changelog
12. License
13. Contact

This demo showcases a simple implementation of cross-device data synchronization using the distributedKVStore module in OpenHarmony. After pairing devices on the same network and verifying a PIN code, the sender device can push messages to the receiver device through a distributed key-value store. The receiver listens for data changes and updates its state accordingly.

UI effects are as follows:

⚠️ Important Note:

This example uses system interfaces, so you need to manually replace the Full SDK to compile successfully. For specific steps, refer to the Replacement Guide.

• 🔍 Device Discovery - Discover nearby devices on the same network
• 🔐 Secure Pairing - Authenticate and pair discovered devices using PIN code verification
• 📡 Real-time Sync - Send data from one device to another in real time
• 💾 Distributed KV Store - Utilize OpenHarmony's distributed key-value storage system
• 🔄 Cross-device Communication - Seamless data synchronization across paired devices

• Two OpenHarmony-compatible devices (e.g., Dayu200 Development Board and OpenHarmony Developer Phone)
• Valid network connection (both devices must be on the same network)

• OpenHarmony SDK API Level 11 or higher
• DevEco Studio 4.0 or higher
• System-level application privileges
• Valid signature configurations

• ACCESS_SERVICE_DM - For device discovery and management
• DISTRIBUTED_DATASYNC - For cross-device data synchronization

git clone https://github.com/imansmallapple/app-SuperDeviceDemo.git
cd app-SuperDeviceDemo

1. Install DevEco Studio
2. Replace with Full SDK following the official guide
3. Configure system-level application settings (see tutorial)

1. Open the project in DevEco Studio
2. Ensure you are using API level 11
3. Confirm your app is configured as a system-level application
4. Sign the application with valid signature configurations
5. Connect two OpenHarmony-compatible devices
6. Ensure both devices are connected to the same network
7. Click the Run button to install the application on both devices

Ensure both devices support OpenHarmony and are connected to the same network.

1. On the initiating device, tap the Find Nearby Device button
2. Select the target device from the pop-up list
3. A verification dialog will appear on the receiver device
4. Accept the pairing request on the receiver device
5. A random PIN code will be generated and displayed
6. Enter the PIN code on the sender device
7. Pairing is complete ✅

Once paired:

• The initiating device is automatically labeled as the Sender
• The target device is labeled as the Receiver

1. On the Sender device, enter text in the input box
2. Tap the Send button to push the message
3. The data is synchronized via the distributed KV store

The Receiver device will automatically receive and display the message in real-time.

Tap the Unbind button to disconnect the paired device and reset the session.

app-SuperDeviceDemo/
├── AppScope/                    # Application scope configuration
│   ├── app.json5               # Application metadata
│   └── resources/              # Global resources
├── entry/                       # Main entry module
│   ├── src/
│   │   ├── main/
│   │   │   ├── ets/
│   │   │   │   ├── entryability/    # Application entry ability
│   │   │   │   ├── pages/           # UI pages
│   │   │   │   ├── utils/           # Utility classes
│   │   │   │   │   ├── DeviceManager.ets    # Device management
│   │   │   │   │   ├── kvStoreUtil.ts       # KV store operations
│   │   │   │   │   └── Log.ts               # Logging utility
│   │   │   │   └── view/            # Custom components
│   │   │   └── resources/          # Module resources
│   │   ├── ohosTest/               # Test files
│   │   └── mock/                   # Mock data
│   └── build-profile.json5         # Build configuration
├── hvigor/                      # Build tool configuration
├── images/                      # Documentation images
├── CHANGELOG.md                 # Version history
├── LICENSE                      # Apache 2.0 License
└── README.md                    # This file

Edit AppScope/app.json5 to modify application metadata:

{
  "app": {
    "bundleName": "com.example.superdevicedemo",
    "vendor": "example",
    "versionCode": 1000000,
    "versionName": "1.0.0"
  }
}

Required permissions are defined in entry/src/main/module.json5:

{
  "requestPermissions": [
    {
      "name": "ohos.permission.ACCESS_SERVICE_DM"
    },
    {
      "name": "ohos.permission.DISTRIBUTED_DATASYNC"
    }
  ]
}

import DeviceManager from '../utils/DeviceManager'

// Discover nearby devices
DeviceManager.discoverDevices()

// Pair with a device
DeviceManager.pairDevice(deviceId)

// Unbind device
DeviceManager.unbindDevice(deviceId)

import KvStoreModel from '../utils/kvStoreUtil'

// Create KV store
const kvStore = new KvStoreModel()
kvStore.createKvStore(context, callback)

// Put data
kvStore.put(key, value)

// Get data
kvStore.get(key)

// Subscribe to changes
kvStore.subscribeDataChange(callback)

• Tutorial - Detailed code explanations and architecture deep-dives
• Changelog - Version history and release notes
• Oniro Project Documentation - Oniro project resources

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Please ensure your code follows the project's coding standards and includes appropriate tests.

See CHANGELOG.md for a detailed version history.

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

• Author: imansmallapple
• Repository: https://github.com/eclipse-oniro4openharmony/app-SuperDeviceDemo
• Issues: https://github.com/eclipse-oniro4openharmony/app-SuperDeviceDemo/issues