更新记录

1.0.0（2026-04-17）

• 支持 Android 拉起系统邮件编辑器
• 支持 Android 拉起系统短信编辑器
• 支持 iOS 拉起系统邮件编辑器
• 支持 iOS 拉起系统短信编辑器
• 支持预填收件人、主题、正文、附件
• 统一返回 opened、sent、saved、cancelled、failed 等结果

平台兼容性

uni-app(4.75)

uni-app x(4.75)

austin-message

统一拉起 Android / iOS 系统邮件与短信编辑器，支持预填收件人、主题、正文、附件，并返回统一结果结构。

适用场景

• 问题反馈邮件
• 账单、合同、对账单邮件转发
• 客服联系
• 邀请短信
• 故障日志上报

模板页

当前插件下的 index.vue 是完整模板页，按真实业务场景拆成：

• 反馈邮件
• 账单转发
• 邀请短信

模板页不是按钮说明书，而是一个“系统消息工作台”，便于直接改字段测试。

manifest 配置

无需额外配置危险权限。

• Android：插件内已集成 FileProvider，用于给邮件附件临时授权读取
• iOS：无需额外权限声明

API

getMessageComposeCapabilities()

返回当前设备的系统消息编辑能力。

composeEmail(options)

拉起系统邮件编辑器。

composeSms(options)

拉起系统短信编辑器。

MessageComposeAttachment

mimeType 是文件类型标识，例如：

• PDF：application/pdf
• PNG：image/png
• JPG：image/jpeg
• 文本：text/plain

大多数常见文件可以不手动填写，插件会优先根据 name 或文件路径后缀自动推断。只有在文件没有标准后缀、后缀不准确，或你想强制指定附件类型时，才建议手动传入 mimeType。

返回结构

composeEmail 与 composeSms 使用同一套返回结构：

平台说明

• Android：邮件通常返回 opened，表示已成功打开系统邮件客户端；当前版本优先支持单个邮件附件，短信当前版本不承诺附件能力
• iOS：邮件依赖系统已配置邮箱账户；短信与邮件都能返回更明确的发送/取消状态

示例

import {
  getMessageComposeCapabilities,
  composeEmail,
  composeSms,
} from '@/uni_modules/austin-message'

const capabilities = getMessageComposeCapabilities()

composeEmail({
  to: ['support@example.com'],
  subject: 'App 问题反馈',
  body: '订单详情页切换网络后未刷新',
})

composeSms({
  recipients: ['***'],
  body: '你好，邀请你参加活动：https://example.com/invite',
})