# DistributedContacts

**Repository Path**: harmonyos_codelabs/DistributedContacts

## Basic Information

- **Project Name**: DistributedContacts
- **Description**: 本篇Codelab以通讯录为例，介绍分布式键值数据库的创建、数据的增加/删除/修改/查询/同步等操作方法。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 8
- **Created**: 2024-06-15
- **Last Updated**: 2025-09-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基于分布式键值数据库实现通讯录功能

## 简介

本篇Codelab以通讯录为例，介绍分布式键值数据库的创建、数据的增加/删除/修改/查询/同步等操作方法。

![](screenshots/device/contact.gif)

## 相关概念

- 应用数据持久化概述：应用数据持久化，是指应用将内存中的数据通过文件或数据库的形式保存到设备上。内存中的数据形态通常是任意的数据结构或数据对象，存储介质上的数据形态可能是文本、数据库、二进制文件等。
- 键值型数据库：键值型数据库存储键值对形式的数据，当需要存储的数据没有复杂的关系模型，比如存储商品名称及对应价格、员工工号及今日是否已出勤等，由于数据复杂度低，更容易兼容不同数据库版本和设备类型，因此推荐使用键值型数据库持久化此类数据。
- @ohos.data.distributedKVStore (分布式键值数据库)：分布式键值数据库为应用程序提供不同设备间数据库的分布式协同能力。通过调用分布式键值数据库各个接口，应用程序可将数据保存到分布式键值数据库中，并可对分布式键值数据库中的数据进行增加、删除、修改、查询等操作。

## 相关权限

本篇Codelab用到分布式的能力，需要在配置文件module.json5里添加不同设备间的数据交换权限：ohos.permission.DISTRIBUTED_DATASYNC。

## 使用说明

1. 应用首页，点击右上角的“添加”按钮，进入新建联系人页面。
2. 应用首页，点击右上角的“更多”按钮，点击“批量删除”，进入联系人批量删除页面。
3. 应用首页，点击列表联系人，进入联系人详情页面。
4. 联系人详情页面，点击下方"编辑"按钮，进入联系人编辑页面。
5. 联系人详情页面，点击下方“删除”按钮，删除该联系人。
6. 新建联系人页面，输入联系人信息后，点击右上“保存”按钮，添加联系人，页面跳转到应用首页。
7. 联系人批量删除页面，点击下方全选，全部选中/不选中所有联系人。
8. 联系人批量删除页面，选中需要删除的联系人，下方点击“删除”按钮，删除选中的联系人。
9. 联系人编辑页面，编辑好联系人信息后，点击右上角的“保存”按钮，修改联系人信息。

## 约束与限制

1. 本示例仅支持标准系统上运行，支持设备：华为手机。
2. HarmonyOS系统：HarmonyOS 5.0.5 Release及以上。
3. DevEco Studio版本：DevEco Studio 5.0.5 Release及以上。
4. HarmonyOS SDK版本：HarmonyOS 5.0.5 Release SDK及以上。