分享

接口声明

  1. { "name": "system.share" }

导入模块

  1. import share from '@system.share' 或 const share = require('@system.share')

接口定义

share.share(OBJECT)

分享数据到其他 app

参数：

参数名类型必填说明
typeString是数据的 MIME TYPE，要求字母全小写
dataString是分享的数据：1. 如果 type 是 text/开头的 mimetype（如 text/plain），则 data 是要分享的文本内容；2. 如果 type 是其他值，则 data 是要分享的文件路径。支持三种文件路径：1. 通过 fetch.fetch 下载的文件路径；2. 通过 file.save 或 list 获得的文件路径；3. 以/开头的应用内部的资源文件。
successFunction否成功回调。因为大部分 android app 都没有正确的返回分享状态，所以即使分享成功了，也可能执行 cancel 回调，而不是 success 回调。
failFunction否失败回调
cancelFunction否取消回调
completeFunction否执行结束后的回调

示例：

  1. share.share({
  2.   type: 'text/html',
  3.   data: '<b>bold</b>',
  4.   success: function(data) {
  5.     console.log('handling success')
  6.   },
  7.   fail: function(data, code) {
  8.     console.log(`handling fail, code = ${code}`)
  9.   }
  10. })

后台运行限制

禁止使用。后台运行详细用法参见后台运行 脚本。