鸿蒙开发 拉起邮件类应用（mailto方式）

使用场景

通过mailto电子邮件协议，可以创建指向电子邮件地址的超链接，方便用户通过网页或应用中的超链接直接跳转电子邮件应用。同时，支持在mailto:的相关字段中定义邮件的收件人、主题、正文内容等，节省用户编辑邮件的时间。

常见的应用场景举例如下：

1. 从网页拉起：

• 用户在购物网站浏览产品页面时，看到“联系我们”按钮，点击后会拉起默认邮件客户端。收件人自动填写为客服邮箱，邮件主题设定为产品咨询。
• 在招聘岗位页面，点击“申请职位”按钮，会拉起邮件客户端。收件人地址为招聘邮箱，邮件主题为“应聘某职位”，正文可以预先填入申请模板。

2. 从应用拉起：

• 移动应用中，用户点击“反馈”按钮时，应用调用系统功能，拉起默认邮件客户端，预先填写反馈邮箱、问题描述等信息。
• 移动应用中，当用户点击“通过邮件分享”按钮时，应用会通过 mailto 调用邮件客户端，预填邮件主题和正文。

mailto协议格式

mailto协议标准格式如下：

mailto:someone@example.com?key1=value1&key2=value2

• mailto:：mailto scheme，必填。
• someone@example.com：收件人地址，选填。如果存在多个地址，用英文逗号分隔。
• ?：邮件头声明开始符号。如果带邮件头参数，则必填。
• key-value：邮件头参数，详细参数见下表。

邮件头	含义	数据类型	是否必填
subject	邮件主题	string	否
body	邮件正文	string	否
cc	抄送人，多个用逗号分隔	string	否
bcc	密送人，多个用逗号分隔	string	否

拉起方开发步骤

从网页拉起
网页中的超链接需要满足mailto协议。示例如下：

<a href="mailto:support@example.com?subject=Product Inquiry&body=I am interested in...">联系我们</a>

实际开发时，需要将邮箱地址替换为真实的邮箱，邮件内容可以根据需要进行配置。

实现效果如下：

从应用拉起
保证mailto字符串传入uri参数即可，在应用中page页面可通过 getContext(this) 获取context，在ability中可通过this.context获取context。

@Entry
@Component
struct Index {

  build() {
    Column() {
      Button('反馈')
        .onClick(() => {
          let ctx = getContext(this) as common.UIAbilityContext;
          ctx.startAbility({
            action: 'ohos.want.action.sendToData',
            uri: 'mailto:feedback@example.com?subject=App Feedback&body=Please describe your feedback here...'
          })
        
        })
    }
  }
}

实现效果如下：

目标方开发步骤

1. 为了能够支持被其他应用通过mailto协议拉起，目标应用需要在 module.json5配置文件 中声明mailto。

{
  "module": {
    // ...
    "abilities": [
      {
        // ...
        "skills": [
          {
          "actions": [
              'ohos.want.action.sendToData'
            ],
            "uris": [
              {
                "scheme": "mailto",
                // linkFeature 用于适配垂类面板拉起
                "linkFeature": 'ComposeMail'
              }
            ]
          }
        ]
      }
    ]
  }
}

2. 目标应用在代码中取出uri参数进行解析。

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void { 
    // 应用冷启动生命周期回调，其他业务处理...
    parseMailto(want);
  }

  onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    // 应用热启动生命周期回调，其他业务处理...
    parseMailto(want);
  }

  public parseMailto(want: Want) {
    const uri = want?.uri;
    if (!uri || uri.length <= 0) {
      return;
    }
    // 开始解析 mailto...
  }
}

最后：

如果还有不知道从哪里开始入手了解鸿蒙开发技术、想要更深的掌握鸿蒙开发技术知识点的朋友们，或者是转行求职人员还在为面试问题而犯难的，可以动动手指进来参考一下针对‌鸿蒙开发学习‌而设计的系统性学习方案，涵盖基础入门到进阶实战项目相关学习文档：https://docs.qq.com/doc/DSk9ZeU9RTUhETm53

 这些内容是从初级>中级>高级的所有知识点，带你更快速了解基本编程逻辑，▶适合人群包括：零基础开发者、移动端转型者、物联网从业者、应届生/计算机专业。

【鸿蒙全栈开发学习指南】https://docs.qq.com/doc/DSk9ZeU9RTUhETm53