From 2dc84944765c88ca146c72621f2a2ce0d12fb730 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Wed, 11 Jun 2025 03:40:32 +0000 Subject: [PATCH 01/21] update zh-cn/application-dev/contacts/contacts-intro.md. Signed-off-by: xiajunhao --- .../contacts/contacts-intro.md | 28 ------------------- 1 file changed, 28 deletions(-) diff --git a/zh-cn/application-dev/contacts/contacts-intro.md b/zh-cn/application-dev/contacts/contacts-intro.md index 9d1a65cb308..a2543a57441 100644 --- a/zh-cn/application-dev/contacts/contacts-intro.md +++ b/zh-cn/application-dev/contacts/contacts-intro.md @@ -55,34 +55,6 @@ Contacts Kit可以帮助开发者轻松实现联系人的增删改查等功能 3. 完成操作，返回想要的data数据。 -## 选择联系人（受限开放） - -1. 声明接口调用所需要的权限。 - - 选择联系人，调用selectContacts接口，需要配置ohos.permission.WRITE_CONTACTS权限，权限级别为system_basic。在申请权限前，请保证符合[权限使用的基本原则](../security/AccessToken/app-permission-mgmt-overview.md#权限使用的基本原则)。然后参考[申请应用权限](../security/AccessToken/determine-application-mode.md#system_basic等级应用申请权限的方式)声明对应权限。 - -2. 设置一个需要的Permissions数组变量。 - -3. 执行对应联系人的权限操作。 - - ```ts - import { common, abilityAccessCtrl, Permissions } from '@kit.AbilityKit'; - import { contact } from '@kit.ContactsKit'; - - let context = this.getUIContext().getHostContext() as common.UIAbilityContext; - const permissions: Array = ['ohos.permission.WRITE_CONTACTS']; - - abilityAccessCtrl.createAtManager().requestPermissionsFromUser(context, permissions).then(() => { - try { - contact.selectContacts(); - } catch(err) { - console.error('errCode: ' + err.code + ', errMessage: ' + err.message); - } - }) - - ``` - - ## 联系人管理（受限开放） 若需要在应用内实现管理联系人的功能，可以使用permissions接口获取应用对联系人的编辑权限。 -- Gitee From e7d8efa53a2104e0938a16936e9bd00be7b07bc3 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Wed, 11 Jun 2025 03:56:49 +0000 Subject: [PATCH 02/21] update zh-cn/application-dev/contacts/contacts-intro.md. Signed-off-by: xiajunhao --- .../contacts/contacts-intro.md | 74 +++++++++++++++++++ 1 file changed, 74 insertions(+) diff --git a/zh-cn/application-dev/contacts/contacts-intro.md b/zh-cn/application-dev/contacts/contacts-intro.md index a2543a57441..930303e56c1 100644 --- a/zh-cn/application-dev/contacts/contacts-intro.md +++ b/zh-cn/application-dev/contacts/contacts-intro.md @@ -115,3 +115,77 @@ Contacts Kit可以帮助开发者轻松实现联系人的增删改查等功能 } } ``` + +# 使用picker保存联系人 + +**场景介绍** + +通过拉起picker的方式添加联系人 + + +**接口说明** + +| 接口名 | 描述 | +| --------------------- | ------------------------------------------ | +| addContactViaUI(context: Context, contact: Contact): Promise<number> | 调用新建联系人接口，打开新建联系人UI界面，新建完成。使用Promise异步回调。 | + +**示例代码** + +>**说明：** +> +>在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。 + + +```js +import { common } from '@kit.AbilityKit'; + +// 获取context。 +let contactInfo: contact.Contact = { + name: { + fullName: 'xxx' + }, + phoneNumbers: [{ + phoneNumber: '138xxxxxx' + }] +} +let context = this.getUIContext().getHostContext() as common.UIAbilityContext; +let promise = contact.addContactViaUI(context, contactInfo); +``` + +# 使用picker保存至已有联系人 + +**场景介绍** + +通过拉起picker的方式将联系人信息保存到已有联系人 + + +**接口说明** + +| 接口名 | 描述 | +| --------------------- | ------------------------------------------ | +| saveToExistingContactViaUI(context: Context, contact: Contact): Promise<number> | 调用保存至已有联系人接口，选择联系人UI界面并完成编辑。使用Promise异步回调。 | + + +**示例代码** + +>**说明：** +> +>在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。 + + +```js +import { common } from '@kit.AbilityKit'; + +// 获取context。 +let contactInfo: contact.Contact = { + id: 1, + name: { + fullName: 'xxx' + }, + phoneNumbers: [{ + phoneNumber: '138xxxxxx' + }] +} +let context = this.getUIContext().getHostContext() as common.UIAbilityContext; +let promise = contact.saveToExistingContactViaUI(context, contactInfo); +``` \ No newline at end of file -- Gitee From b23767491429fd2e9a5cbc1c201f5d0c96510348 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Thu, 12 Jun 2025 09:39:05 +0000 Subject: [PATCH 03/21] add zh-cn/application-dev/contacts/contacts-addcontactviaui. Signed-off-by: xiajunhao --- .../contacts/contacts-addcontactviaui | 36 +++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 zh-cn/application-dev/contacts/contacts-addcontactviaui diff --git a/zh-cn/application-dev/contacts/contacts-addcontactviaui b/zh-cn/application-dev/contacts/contacts-addcontactviaui new file mode 100644 index 00000000000..e87a9f8b2ad --- /dev/null +++ b/zh-cn/application-dev/contacts/contacts-addcontactviaui @@ -0,0 +1,36 @@ +# 使用picker保存联系人 + +## 场景介绍 + +通过拉起picker的方式添加联系人 + + +## 接口说明 + +| 接口名 | 描述 | +| --------------------- | ------------------------------------------ | +| addContactViaUI(context: Context, contact: Contact): Promise<number> | 调用新建联系人接口，打开新建联系人UI界面，新建完成。使用Promise异步回调。 | + + +## 示例代码 + +### 说明： + +在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。 + + +```js +import { common } from '@kit.AbilityKit'; + +// 获取context。 +let contactInfo: contact.Contact = { + name: { + fullName: 'xxx' + }, + phoneNumbers: [{ + phoneNumber: '138xxxxxx' + }] +} +let context = this.getUIContext().getHostContext() as common.UIAbilityContext; +let promise = contact.addContactViaUI(context, contactInfo); +``` \ No newline at end of file -- Gitee From 8a9f5c587d79b912ec9fa8ea45d9a18a9ff010a1 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Thu, 12 Jun 2025 09:39:34 +0000 Subject: [PATCH 04/21] rename contacts-addcontactviaui.md. Signed-off-by: xiajunhao --- .../{contacts-addcontactviaui => contacts-addcontactviaui.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename zh-cn/application-dev/contacts/{contacts-addcontactviaui => contacts-addcontactviaui.md} (100%) diff --git a/zh-cn/application-dev/contacts/contacts-addcontactviaui b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md similarity index 100% rename from zh-cn/application-dev/contacts/contacts-addcontactviaui rename to zh-cn/application-dev/contacts/contacts-addcontactviaui.md -- Gitee From 554eb3121a564b280138c1916b596e7b6f4906c4 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Thu, 12 Jun 2025 09:41:12 +0000 Subject: [PATCH 05/21] add zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md. Signed-off-by: xiajunhao --- .../contacts-savetoexistingcontactviaui.md | 37 +++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md diff --git a/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md b/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md new file mode 100644 index 00000000000..54a15a8f11d --- /dev/null +++ b/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md @@ -0,0 +1,37 @@ +# 使用picker保存至已有联系人 + +## 场景介绍** + +通过拉起picker的方式将联系人信息保存到已有联系人 + + +## 接口说明 + +| 接口名 | 描述 | +| --------------------- | ------------------------------------------ | +| saveToExistingContactViaUI(context: Context, contact: Contact): Promise<number> | 调用保存至已有联系人接口，选择联系人UI界面并完成编辑。使用Promise异步回调。 | + + +## 示例代码 + +### 说明： + +在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。 + + +```js +import { common } from '@kit.AbilityKit'; + +// 获取context。 +let contactInfo: contact.Contact = { + id: 1, + name: { + fullName: 'xxx' + }, + phoneNumbers: [{ + phoneNumber: '138xxxxxx' + }] +} +let context = this.getUIContext().getHostContext() as common.UIAbilityContext; +let promise = contact.saveToExistingContactViaUI(context, contactInfo); +``` \ No newline at end of file -- Gitee From ad9dcbcba260eb05e091c63ee1d39278522d9321 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Thu, 12 Jun 2025 09:41:22 +0000 Subject: [PATCH 06/21] update zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md. Signed-off-by: xiajunhao --- .../contacts/contacts-savetoexistingcontactviaui.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md b/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md index 54a15a8f11d..427852496bc 100644 --- a/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md +++ b/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md @@ -1,6 +1,6 @@ # 使用picker保存至已有联系人 -## 场景介绍** +## 场景介绍 通过拉起picker的方式将联系人信息保存到已有联系人 -- Gitee From 78dcde48ba74275f8be506e9b7e1cfec963d921a Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Thu, 12 Jun 2025 09:41:42 +0000 Subject: [PATCH 07/21] update zh-cn/application-dev/contacts/contacts-intro.md. Signed-off-by: xiajunhao --- .../contacts/contacts-intro.md | 74 ------------------- 1 file changed, 74 deletions(-) diff --git a/zh-cn/application-dev/contacts/contacts-intro.md b/zh-cn/application-dev/contacts/contacts-intro.md index 930303e56c1..a2543a57441 100644 --- a/zh-cn/application-dev/contacts/contacts-intro.md +++ b/zh-cn/application-dev/contacts/contacts-intro.md @@ -115,77 +115,3 @@ Contacts Kit可以帮助开发者轻松实现联系人的增删改查等功能 } } ``` - -# 使用picker保存联系人 - -**场景介绍** - -通过拉起picker的方式添加联系人 - - -**接口说明** - -| 接口名 | 描述 | -| --------------------- | ------------------------------------------ | -| addContactViaUI(context: Context, contact: Contact): Promise<number> | 调用新建联系人接口，打开新建联系人UI界面，新建完成。使用Promise异步回调。 | - -**示例代码** - ->**说明：** -> ->在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。 - - -```js -import { common } from '@kit.AbilityKit'; - -// 获取context。 -let contactInfo: contact.Contact = { - name: { - fullName: 'xxx' - }, - phoneNumbers: [{ - phoneNumber: '138xxxxxx' - }] -} -let context = this.getUIContext().getHostContext() as common.UIAbilityContext; -let promise = contact.addContactViaUI(context, contactInfo); -``` - -# 使用picker保存至已有联系人 - -**场景介绍** - -通过拉起picker的方式将联系人信息保存到已有联系人 - - -**接口说明** - -| 接口名 | 描述 | -| --------------------- | ------------------------------------------ | -| saveToExistingContactViaUI(context: Context, contact: Contact): Promise<number> | 调用保存至已有联系人接口，选择联系人UI界面并完成编辑。使用Promise异步回调。 | - - -**示例代码** - ->**说明：** -> ->在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。 - - -```js -import { common } from '@kit.AbilityKit'; - -// 获取context。 -let contactInfo: contact.Contact = { - id: 1, - name: { - fullName: 'xxx' - }, - phoneNumbers: [{ - phoneNumber: '138xxxxxx' - }] -} -let context = this.getUIContext().getHostContext() as common.UIAbilityContext; -let promise = contact.saveToExistingContactViaUI(context, contactInfo); -``` \ No newline at end of file -- Gitee From 8c5538466eb37ca7b3ab819925524b46d2d114ea Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Thu, 12 Jun 2025 09:44:36 +0000 Subject: [PATCH 08/21] update zh-cn/application-dev/contacts/contacts-addcontactviaui.md. Signed-off-by: xiajunhao --- zh-cn/application-dev/contacts/contacts-addcontactviaui.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md index e87a9f8b2ad..756138afd6e 100644 --- a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md +++ b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md @@ -16,7 +16,7 @@ ### 说明： -在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。 +在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../application-models/uiability-usage.md#获取uiability的上下文信息)。 ```js -- Gitee From cb823ad47706527cdaf1bb4bf684912769567096 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Thu, 12 Jun 2025 09:44:55 +0000 Subject: [PATCH 09/21] update zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md. Signed-off-by: xiajunhao --- .../contacts/contacts-savetoexistingcontactviaui.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md b/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md index 427852496bc..9af49a55073 100644 --- a/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md +++ b/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md @@ -16,7 +16,7 @@ ### 说明： -在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。 +在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../application-models/uiability-usage.md#获取uiability的上下文信息)。 ```js -- Gitee From ae344ed8a26e1fe426e6bbd1ff6a0930b7c9ca1e Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Fri, 13 Jun 2025 10:10:08 +0000 Subject: [PATCH 10/21] update zh-cn/application-dev/contacts/Readme-CN.md. Signed-off-by: xiajunhao --- zh-cn/application-dev/contacts/Readme-CN.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/zh-cn/application-dev/contacts/Readme-CN.md b/zh-cn/application-dev/contacts/Readme-CN.md index 89aecf5bd83..4a76a706508 100644 --- a/zh-cn/application-dev/contacts/Readme-CN.md +++ b/zh-cn/application-dev/contacts/Readme-CN.md @@ -1,3 +1,5 @@ # Contacts Kit（联系人服务） - [Contacts Kit开发概述](contacts-intro.md) +- [使用picker保存联系人](contacts-addcontactviaui.md) +- [使用picker保存至已有联系人](contacts-savetoexistingcontactviaui.md) -- Gitee From d5b14797854cfc5f6d83f0f15f0f088042605fa7 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Fri, 13 Jun 2025 10:10:48 +0000 Subject: [PATCH 11/21] update zh-cn/application-dev/contacts/contacts-addcontactviaui.md. Signed-off-by: xiajunhao --- .../application-dev/contacts/contacts-addcontactviaui.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md index 756138afd6e..cd1a1b81011 100644 --- a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md +++ b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md @@ -2,7 +2,7 @@ ## 场景介绍 -通过拉起picker的方式添加联系人 +通过拉起picker的方式添加联系人。 ## 接口说明 @@ -14,9 +14,9 @@ ## 示例代码 -### 说明： - -在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../application-models/uiability-usage.md#获取uiability的上下文信息)。 +> **说明：** +> +> 在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../application-models/uiability-usage.md#获取uiability的上下文信息)。 ```js -- Gitee From 8c47e3ae935d27328a96da24fe5a4f360df9cc24 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Fri, 13 Jun 2025 10:11:58 +0000 Subject: [PATCH 12/21] update zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md. Signed-off-by: xiajunhao --- .../contacts/contacts-savetoexistingcontactviaui.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md b/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md index 9af49a55073..b52de78bc83 100644 --- a/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md +++ b/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md @@ -2,7 +2,7 @@ ## 场景介绍 -通过拉起picker的方式将联系人信息保存到已有联系人 +通过拉起picker的方式将联系人信息保存到已有联系人。 ## 接口说明 @@ -14,9 +14,9 @@ ## 示例代码 -### 说明： - -在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../application-models/uiability-usage.md#获取uiability的上下文信息)。 +> **说明：** +> +> 在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../application-models/uiability-usage.md#获取uiability的上下文信息)。 ```js -- Gitee From f96330ed3c558f7ec7955af38013de804db35308 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Fri, 13 Jun 2025 10:13:34 +0000 Subject: [PATCH 13/21] update zh-cn/application-dev/contacts/contacts-intro.md. Signed-off-by: xiajunhao --- zh-cn/application-dev/contacts/contacts-intro.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/zh-cn/application-dev/contacts/contacts-intro.md b/zh-cn/application-dev/contacts/contacts-intro.md index a2543a57441..e2d8d193784 100644 --- a/zh-cn/application-dev/contacts/contacts-intro.md +++ b/zh-cn/application-dev/contacts/contacts-intro.md @@ -23,8 +23,6 @@ Contacts Kit可以帮助开发者轻松实现联系人的增删改查等功能 - [联系人管理](#联系人管理受限开放) -- [选择联系人](#选择联系人受限开放) - ## 使用Picker选择联系人 -- Gitee From 41f0ed12cd77f0d81e58a10d91ba7eed44fb0358 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Tue, 17 Jun 2025 03:03:53 +0000 Subject: [PATCH 14/21] update zh-cn/application-dev/contacts/contacts-addcontactviaui.md. Signed-off-by: xiajunhao --- .../contacts/contacts-addcontactviaui.md | 90 +++++++++++++++---- 1 file changed, 74 insertions(+), 16 deletions(-) diff --git a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md index cd1a1b81011..77e386ab5dc 100644 --- a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md +++ b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md @@ -2,7 +2,7 @@ ## 场景介绍 -通过拉起picker的方式添加联系人。 +通过拉起picker的方式保存联系人。 ## 接口说明 @@ -14,23 +14,81 @@ ## 示例代码 -> **说明：** -> -> 在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../application-models/uiability-usage.md#获取uiability的上下文信息)。 +```js +import { common } from '@kit.AbilityKit'; +import contact from '@ohos.contact'; + + +@Entry +@Component +struct Index { + @State message: string = 'Hello World'; + + Row() { + Column() { + Text(this.message) + .fontSize(50) + .fontWeight(FontWeight.Bold) + .onClick(() => { + let contactInfo: contact.Contact = { + name: { + fullName: 'xxx' + }, + phoneNumbers: [{ + phoneNumber: '138xxxxxx' + }] + } + let context = this.getUIContext().getHostContext() as common.UIAbilityContext; + let promise = contact.addContactViaUI(context, contactInfo); + }) + } + } +} +``` + +## 场景介绍 + +通过拉起picker的方式将联系人信息保存到已有联系人。 + + +## 接口说明 + +| 接口名 | 描述 | +| --------------------- | ------------------------------------------ | +| saveToExistingContactViaUI(context: Context, contact: Contact): Promise<number> | 调用保存至已有联系人接口，选择联系人UI界面并完成编辑。使用Promise异步回调。 | + + +## 示例代码 - ```js import { common } from '@kit.AbilityKit'; +import contact from '@ohos.contact'; + -// 获取context。 -let contactInfo: contact.Contact = { - name: { - fullName: 'xxx' - }, - phoneNumbers: [{ - phoneNumber: '138xxxxxx' - }] +@Entry +@Component +struct Index { + @State message: string = 'Hello World'; + + Row() { + Column() { + Text(this.message) + .fontSize(50) + .fontWeight(FontWeight.Bold) + .onClick(() => { + let contactInfo: contact.Contact = { + id: 1, + name: { + fullName: 'xxx' + }, + phoneNumbers: [{ + phoneNumber: '138xxxxxx' + }] + } + let context = this.getUIContext().getHostContext() as common.UIAbilityContext; + let promise = contact.saveToExistingContactViaUI(context, contactInfo); + }) + } + } } -let context = this.getUIContext().getHostContext() as common.UIAbilityContext; -let promise = contact.addContactViaUI(context, contactInfo); -``` \ No newline at end of file +``` \ No newline at end of file -- Gitee From fa701dbfb1405f2d3074b075740488aebcb44475 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Tue, 17 Jun 2025 03:05:44 +0000 Subject: [PATCH 15/21] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20zh?= =?UTF-8?q?-cn/application-dev/contacts/contacts-savetoexistingcontactviau?= =?UTF-8?q?i.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../contacts-savetoexistingcontactviaui.md | 37 ------------------- 1 file changed, 37 deletions(-) delete mode 100644 zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md diff --git a/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md b/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md deleted file mode 100644 index b52de78bc83..00000000000 --- a/zh-cn/application-dev/contacts/contacts-savetoexistingcontactviaui.md +++ /dev/null @@ -1,37 +0,0 @@ -# 使用picker保存至已有联系人 - -## 场景介绍 - -通过拉起picker的方式将联系人信息保存到已有联系人。 - - -## 接口说明 - -| 接口名 | 描述 | -| --------------------- | ------------------------------------------ | -| saveToExistingContactViaUI(context: Context, contact: Contact): Promise<number> | 调用保存至已有联系人接口，选择联系人UI界面并完成编辑。使用Promise异步回调。 | - - -## 示例代码 - -> **说明：** -> -> 在本文档的示例中，通过this.context来获取UIAbilityContext，其中this代表继承自UIAbility的UIAbility实例。如需要在页面中使用UIAbilityContext提供的能力，请参见[获取UIAbility的上下文信息](../application-models/uiability-usage.md#获取uiability的上下文信息)。 - - -```js -import { common } from '@kit.AbilityKit'; - -// 获取context。 -let contactInfo: contact.Contact = { - id: 1, - name: { - fullName: 'xxx' - }, - phoneNumbers: [{ - phoneNumber: '138xxxxxx' - }] -} -let context = this.getUIContext().getHostContext() as common.UIAbilityContext; -let promise = contact.saveToExistingContactViaUI(context, contactInfo); -``` \ No newline at end of file -- Gitee From c85358611085a0ec52f34626c07dc1fb49d352dd Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Tue, 17 Jun 2025 03:06:12 +0000 Subject: [PATCH 16/21] update zh-cn/application-dev/contacts/Readme-CN.md. Signed-off-by: xiajunhao --- zh-cn/application-dev/contacts/Readme-CN.md | 1 - 1 file changed, 1 deletion(-) diff --git a/zh-cn/application-dev/contacts/Readme-CN.md b/zh-cn/application-dev/contacts/Readme-CN.md index 4a76a706508..6db6e6e8bdd 100644 --- a/zh-cn/application-dev/contacts/Readme-CN.md +++ b/zh-cn/application-dev/contacts/Readme-CN.md @@ -2,4 +2,3 @@ - [Contacts Kit开发概述](contacts-intro.md) - [使用picker保存联系人](contacts-addcontactviaui.md) -- [使用picker保存至已有联系人](contacts-savetoexistingcontactviaui.md) -- Gitee From a0a25a90deeab909aefba8a5d474610de8fab101 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Tue, 17 Jun 2025 03:09:11 +0000 Subject: [PATCH 17/21] update zh-cn/application-dev/contacts/contacts-addcontactviaui.md. Signed-off-by: xiajunhao --- zh-cn/application-dev/contacts/contacts-addcontactviaui.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md index 77e386ab5dc..fea378dc297 100644 --- a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md +++ b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md @@ -24,7 +24,7 @@ import contact from '@ohos.contact'; struct Index { @State message: string = 'Hello World'; - Row() { + build() { Column() { Text(this.message) .fontSize(50) @@ -70,7 +70,7 @@ import contact from '@ohos.contact'; struct Index { @State message: string = 'Hello World'; - Row() { + build() { Column() { Text(this.message) .fontSize(50) -- Gitee From cd2cfab8dc7438fcf2b5d63ce86fe566a92077df Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Tue, 17 Jun 2025 07:18:16 +0000 Subject: [PATCH 18/21] update zh-cn/application-dev/contacts/contacts-addcontactviaui.md. Signed-off-by: xiajunhao --- .../contacts/contacts-addcontactviaui.md | 26 +++++-------------- 1 file changed, 7 insertions(+), 19 deletions(-) diff --git a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md index fea378dc297..0f0c7274a7f 100644 --- a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md +++ b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md @@ -1,18 +1,16 @@ -# 使用picker保存联系人 - -## 场景介绍 - -通过拉起picker的方式保存联系人。 - +# 使用picker管理联系人 ## 接口说明 | 接口名 | 描述 | | --------------------- | ------------------------------------------ | | addContactViaUI(context: Context, contact: Contact): Promise<number> | 调用新建联系人接口，打开新建联系人UI界面，新建完成。使用Promise异步回调。 | +| saveToExistingContactViaUI(context: Context, contact: Contact): Promise<number> | 调用保存至已有联系人接口，选择联系人UI界面并完成编辑。使用Promise异步回调。 | -## 示例代码 +## 使用picker新建联系人 + +调用新建联系人接口，打开新建联系人UI界面，用户可在UI界面中填写并新建联系人 ```js import { common } from '@kit.AbilityKit'; @@ -46,19 +44,9 @@ struct Index { } ``` -## 场景介绍 - -通过拉起picker的方式将联系人信息保存到已有联系人。 - - -## 接口说明 - -| 接口名 | 描述 | -| --------------------- | ------------------------------------------ | -| saveToExistingContactViaUI(context: Context, contact: Contact): Promise<number> | 调用保存至已有联系人接口，选择联系人UI界面并完成编辑。使用Promise异步回调。 | - +## 使用picker更新联系人信息 -## 示例代码 +可以通过拉起picker，将选中的联系人信息更新到现有联系人中。 ```js import { common } from '@kit.AbilityKit'; -- Gitee From 56a5880fef7c28aa4cb860f348dd952c8d269cd2 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Tue, 17 Jun 2025 07:19:04 +0000 Subject: [PATCH 19/21] update zh-cn/application-dev/contacts/contacts-addcontactviaui.md. Signed-off-by: xiajunhao --- zh-cn/application-dev/contacts/contacts-addcontactviaui.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md index 0f0c7274a7f..0ed294978d4 100644 --- a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md +++ b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md @@ -14,7 +14,7 @@ ```js import { common } from '@kit.AbilityKit'; -import contact from '@ohos.contact'; +import { contact } from '@kit.ContactsKit'; @Entry @@ -50,7 +50,7 @@ struct Index { ```js import { common } from '@kit.AbilityKit'; -import contact from '@ohos.contact'; +import { contact } from '@kit.ContactsKit'; @Entry -- Gitee From eb17b6f0603f1e405d8ccaa46b7cf8c2c21e01b2 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Tue, 17 Jun 2025 07:22:17 +0000 Subject: [PATCH 20/21] update zh-cn/application-dev/contacts/Readme-CN.md. Signed-off-by: xiajunhao --- zh-cn/application-dev/contacts/Readme-CN.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/contacts/Readme-CN.md b/zh-cn/application-dev/contacts/Readme-CN.md index 6db6e6e8bdd..2820abd6bb2 100644 --- a/zh-cn/application-dev/contacts/Readme-CN.md +++ b/zh-cn/application-dev/contacts/Readme-CN.md @@ -1,4 +1,4 @@ # Contacts Kit（联系人服务） - [Contacts Kit开发概述](contacts-intro.md) -- [使用picker保存联系人](contacts-addcontactviaui.md) +- [使用picker管理联系人](contacts-addcontactviaui.md) -- Gitee From ffc842618f010d54355ddfc840076caaa2943e65 Mon Sep 17 00:00:00 2001 From: xiajunhao Date: Tue, 17 Jun 2025 07:22:36 +0000 Subject: [PATCH 21/21] update zh-cn/application-dev/contacts/contacts-addcontactviaui.md. Signed-off-by: xiajunhao --- zh-cn/application-dev/contacts/contacts-addcontactviaui.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md index 0ed294978d4..0a688bfbb86 100644 --- a/zh-cn/application-dev/contacts/contacts-addcontactviaui.md +++ b/zh-cn/application-dev/contacts/contacts-addcontactviaui.md @@ -10,7 +10,7 @@ ## 使用picker新建联系人 -调用新建联系人接口，打开新建联系人UI界面，用户可在UI界面中填写并新建联系人 +调用新建联系人接口，打开新建联系人UI界面，用户可在UI界面中填写并新建联系人。 ```js import { common } from '@kit.AbilityKit'; -- Gitee