介绍
本示例使用@ohos.contact 接口,实现了对联系人的增删查改功能。
效果预览
使用说明
1.点击 + 按钮,跳转添加联系人界面,输入联系人信息,点击 √,确认添加联系人,并返回首页;
2.点击联系人列表跳转页面查看详细信息,并且可以编辑或删除联系人信息;
3.在搜索栏输入号码或邮箱可查询对应的联系人。
工程目录
entry/src/main/ets/
|---component
| |---Contact.ets // 联系人页面
| |---ContactInfo.ets // 联系人详情页主体内容
| |---Home.ets // 主页主体内容
| |---ItemContainer.ets // 联系人列表
| |---NewContact.ets // 新建联系人页面主体内容
| |---UpdateContact.ets
|---data // 日志文件
|---entryability
| |---EntryAbility.ets // 应用入口,在这里请求相关权限
|---pages
| |---AddContact.ets // 新建联系人页面
| |---EditContact.ets // 编辑联系人
| |---Index.ets // 主页
| |---NameCard.ets // 联系人详情页
| |---Setting.ets // 设置页面
具体实现
- 本示例的主要逻辑功能和源码在下列相关类中:
- 查询所有联系人:在Contact.ets 页面调用contact.queryContacts()查询所有的联系人;
- 新建联系人:在AddContact.ets 页面检验数据格式后通过contact.addContact()创建新的联系人;
- 搜索联系人:在Contact.ets
页面调用contact.queryContactsByPhoneNumber()通过电话号码查询联系人或者调用contact.queryContactsByEmail()通过邮箱查询联系人; - 删除联系人:在ContactInfo.ets 调用contact.deleteContact()删除指定的联系人;
- 修改联系人:在EditContact.ets 页面调用contact.updateContact()。
相关权限
ohos.permission.READ_CONTACTS
ohos.permission.WRITE_CONTACTS
依赖
不涉及。
约束与限制
1.本示例仅支持标准系统上运行,支持设备:RK3568。
2.本示例需要使用DevEco Studio 3.1 Beta2 (Build Version: 3.1.0.400, built on April 7, 2023)及以上版本才可编译运行。
3.本示例已适配API version 9版本SDK,版本号:3.2.11.9。
4.本示例涉及ohos.permission.READ_CONTACTS、ohos.permission.WRITE_CONTACTS 为system_basic级别(相关权限级别可通过权限定义列表)查看),需要手动配置对应级别的权限签名(具体操作可查看自动化签名方案。
下载
如需单独下载本工程,执行如下命令:
git init
git config core.sparsecheckout true
echo code/BasicFeature/Telephony/Contact/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master
为了帮助大家更深入有效的学习到鸿蒙开发知识点,小编特意给大家准备了一份全套最新版的HarmonyOS NEXT学习资源,获取完整版方式请点击→HarmonyOS教学视频:https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3
HarmonyOS教学视频:语法ArkTS、TypeScript、ArkUI等…视频教程
鸿蒙生态应用开发白皮书V2.0PDF: 获取完整版白皮书方式请点击→https://docs.qq.com/doc/DZVVkRGRUd3pHSnFG?u=a42c4946d1514235863bb82a7b2ac128
鸿蒙 (Harmony OS)开发学习手册→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3
一、入门必看
1.应用开发导读(ArkTS)
2………
二、HarmonyOS 概念→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3
1.系统定义
2.技术架构
3.技术特性
4.系统安全
5…
三、如何快速入门?→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3
1.基本概念
2.构建第一个ArkTS应用
3…
四、开发基础知识→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3
1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
五、基于ArkTS 开发→https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3
1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
更多了解更多鸿蒙开发的相关知识可以参考:https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3