@tarojs/plugin-platform-harmony-ets 3.7.0-alpha.27

package/dist/apis/framework/index.ts

@@ -0,0 +1,32 @@
+import { Current } from '@tarojs/runtime'
+
+import { temporarilyNotSupport } from '../utils'
+
+export const ENV_TYPE = {
+  WEAPP: 'WEAPP',
+  SWAN: 'SWAN',
+  ALIPAY: 'ALIPAY',
+  TT: 'TT',
+  QQ: 'QQ',
+  JD: 'JD',
+  WEB: 'WEB',
+  RN: 'RN',
+  HARMONY: 'HARMONY',
+  QUICKAPP: 'QUICKAPP'
+}
+
+export function getEnv () {
+  return ENV_TYPE.HARMONY
+}
+
+export const getCurrentInstance = () => Current
+
+export const nextTick = (cb: (...args: any[]) => any, ctx?: Record<string, any>) => {
+  setTimeout(function () {
+    ctx ? cb.call(ctx) : cb()
+  }, 1)
+}
+
+export const requirePlugin = temporarilyNotSupport('requirePlugin')
+
+export { eventCenter, Events, History } from '@tarojs/runtime/dist/runtime.esm'

package/dist/apis/index.ts

@@ -0,0 +1,124 @@
+import _display from '@ohos.display'
+import { Current, hooks } from '@tarojs/runtime'
+import { isFunction, PLATFORM_TYPE } from '@tarojs/shared'
+
+import * as apis from './apis'
+import { permanentlyNotSupport } from './utils'
+
+const taro = Object.assign({}, apis)
+
+const requirePlugin = /* @__PURE__ */ permanentlyNotSupport('requirePlugin')
+export function initNativeApi (taro) {
+  (Current as any).taro = taro
+  taro.requirePlugin = requirePlugin
+  taro.getApp = getApp
+  taro.pxTransform = pxTransform
+  taro.initPxTransform = initPxTransform
+  taro.canIUseWebp = canIUseWebp
+  taro.getAppInfo = getAppInfo
+
+  if (hooks.isExist('initNativeApi')) {
+    hooks.call('initNativeApi', taro)
+  }
+}
+
+const defaultDesignWidth = 750
+const defaultDesignRatio: Record<string | number, number> = {
+  640: 2.34 / 2,
+  750: 1,
+  828: 1.81 / 2
+}
+const defaultBaseFontSize = 20
+const defaultUnitPrecision = 5
+const defaultTargetUnit = 'vp'
+
+export function getApp () {
+  return Current.app
+}
+
+export function initPxTransform ({
+  designWidth = defaultDesignWidth,
+  deviceRatio = defaultDesignRatio,
+  baseFontSize = defaultBaseFontSize,
+  unitPrecision = defaultUnitPrecision,
+  targetUnit = defaultTargetUnit
+}) {
+  const taro = (Current as any).taro
+
+  if (taro) {
+    taro.config ||= {}
+    const config = taro.config
+    config.designWidth = designWidth
+    config.deviceRatio = deviceRatio
+    config.baseFontSize = baseFontSize
+    config.targetUnit = targetUnit
+    config.unitPrecision = unitPrecision
+  }
+}
+
+const display = _display.getDefaultDisplaySync()
+
+let designWidthFunc: (input: number) => number
+function getRatio (value: number) {
+  const config = (Current as any).taro?.config || {}
+  if (!isFunction(designWidthFunc)) {
+    designWidthFunc = isFunction(config.designWidth)
+      ? config.designWidth
+      : () => config.designWidth
+  }
+  const designWidth = designWidthFunc(value) || defaultDesignWidth
+  const deviceRatio = config.deviceRatio || defaultDesignRatio
+  if (!(designWidth in deviceRatio)) {
+    throw new Error(`deviceRatio 配置中不存在 ${designWidth} 的设置！`)
+  }
+  return Math.min(display.width, display.height) / designWidth / deviceRatio[designWidth]
+}
+
+// Note: 设置为 style 单位时会自动完成设计稿转换，设计开发者调用 API 时也许抹平差异，例如 pageScrollTo[option.offsetTop]
+export function pxTransformHelper (size: number, unit?: string, isNumber = false): number | string {
+  const config = (Current as any).taro?.config || {}
+  const targetUnit = unit || config.targetUnit || defaultTargetUnit
+
+  const ratio = getRatio(size)
+  let val = size * ratio
+
+  switch (targetUnit) {
+    case 'vp':
+      // Note: 在应用创建前调用无效
+      val = px2vp(val)
+      break
+    default:
+  }
+  return isNumber ? val : val + targetUnit
+}
+
+export function pxTransform (size: number): number {
+  const config = (Current as any).taro?.config || {}
+  const targetUnit = config.targetUnit || defaultTargetUnit
+
+  let val = size
+  switch (targetUnit) {
+    case 'vp':
+      val = px2vp(size)
+      break
+    default:
+      // NOTE: 鸿蒙环境下 style 会自动完成设计稿转换，无需在方法内二次调整
+  }
+  return val + config.targetUnit
+}
+
+export function canIUseWebp () {
+  return true
+}
+
+export function getAppInfo () {
+  const config = (Current as any).taro?.config
+  return {
+    platform: process.env.TARO_PLATFORM || PLATFORM_TYPE.HARMONY,
+    taroVersion: process.env.TARO_VERSION || 'unknown',
+    designWidth: config?.designWidth,
+  }
+}
+
+export * from './apis'
+export default taro

package/dist/apis/location/index.ts

@@ -0,0 +1,133 @@
+// HarmonyOS 文档: https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-apis-geolocation-0000001199568865#section13752433138
+// WX 文档: https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.onLocationChange.html
+// ✅ wx.offLocationChange
+// ✅ wx.getLocation
+// ✅ wx.onLocationChange
+
+// 不支持实现
+// ❌ wx.startLocationUpdateBackground
+// ❌ wx.onLocationChangeError
+// ❌ wx.offLocationChangeError
+// ❌ wx.openLocation 地图相关
+// ❌ wx.choosePoi 地图相关
+// ❌ wx.chooseLocation 地图相关
+// ❌ wx.stopLocationUpdate
+// ❌ wx.startLocationUpdate
+
+import geoLocationManager from '@ohos.geoLocationManager'
+import Taro from '@tarojs/taro'
+
+import { callAsyncFail, callAsyncSuccess, validateParams } from '../utils'
+
+interface IGetOHOSGeolocationParams {
+  type?: string
+  altitude?: boolean
+  isHighAccuracy?: boolean
+  highAccuracyExpireTime?: number
+  priority?: number // 数值为固定几种
+  scenario?: number // 数值为固定几种
+  maxAccuracy?: number // 表示精度信息，单位是米。
+  timeoutMs?: number
+}
+
+interface ILocationRequest {
+  priority?: number
+  scenario?: number // 勘误：注意 Harmony OS 这个参数是必填
+  timeInterval?: number
+  distanceInterval?: number
+  maxAccuracy?: number
+}
+
+interface ILocationSuccessDataOHOS {
+  latitude: number
+  longitude: number
+  altitude: number
+  accuracy: number
+  speed: number
+  timeStamp: number
+  direction: number
+  timeSinceBoot: number
+  additions: Array<string>
+  additionSize: number
+}
+
+interface ILocationSuccessOHOS {
+  code: number
+  data: ILocationSuccessDataOHOS
+}
+
+function formatLocation (location: ILocationSuccessDataOHOS) {
+  const locationWX = {
+    latitude: location.latitude,
+    longitude: location.longitude,
+    altitude: location.altitude,
+    accuracy: location.accuracy,
+    speed: location.speed,
+    verticalAccuracy: 0, // OHOS 不支持返回此参数，直接设置为默认值
+    horizontalAccuracy: 0 // OHOS 不支持返回此参数，直接设置为默认值
+  }
+  return locationWX
+}
+// TODO：增加参数校验
+// const getLocationSchema = {
+//   type: 'String',
+//   altitude: 'Boolean',
+//   ishighAccuracy: 'Boolean',
+//   highAccuracyExpireTime: 'number'
+// }
+
+export const getLocation: typeof Taro.getLocation = function (options = {}) {
+  return new Promise((resolve, reject) => {
+    /**
+     * ohos 有 priority, scenario, maxAccuracy, timeoutMs
+     * wx 有 type, altitude, isHighAccuracy, highAccuracyExpireTime
+     * 二者参数不一致
+     */
+    const { type, altitude, isHighAccuracy, highAccuracyExpireTime } = options
+    const params: IGetOHOSGeolocationParams = {
+      type,
+      altitude,
+      isHighAccuracy,
+      highAccuracyExpireTime
+    }
+    try {
+      return geoLocationManager.getCurrentLocation(params).then((location: ILocationSuccessOHOS) => {
+        if (location.code !== 0) {
+          callAsyncFail(reject, location, options)
+        } else {
+          const locationWX = formatLocation(location.data)
+          callAsyncSuccess(resolve, locationWX, options)
+        }
+      }).catch(error => {
+        callAsyncFail(reject, error, options)
+      })
+    } catch (error) {
+      callAsyncFail(reject, error, options)
+    }
+  })
+}
+
+export const onLocationChange: typeof Taro.onLocationChange = function (callback) {
+  validateParams('onLocationChange', [callback], ['Function'])
+  const requestInfo: ILocationRequest = {}
+  geoLocationManager.on('locationChange', requestInfo, (location: ILocationSuccessDataOHOS) => {
+    if (location) {
+      const locationWX = formatLocation(location)
+      callback(locationWX)
+    }
+  })
+}
+
+export const offLocationChange: typeof Taro.offLocationChangeError = function (callback) {
+  validateParams('offLocationChange', [callback], ['Function'])
+  geoLocationManager.off('locationChange', (location: ILocationSuccessOHOS) => {
+    const status = {
+      errCode: 200,
+      errMsg: location ? 'offLocationChange is off' : 'offLocationChange err'
+    }
+
+    if (callback) {
+      callback(status)
+    }
+  })
+}

package/dist/apis/media/common.ts

@@ -0,0 +1,74 @@
+// HarmonyOS 文档链接：https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-apis-media-0000001103383404
+// WX 文档链接：https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.previewMedia.html
+// ✅ wx.previewMedia(Object object)
+// ✅ wx.chooseMedia
+
+import mediaLibrary from '@ohos.multimedia.mediaLibrary'
+import Taro from '@tarojs/taro'
+
+import { callAsyncFail, callAsyncSuccess, validateParams } from '../utils'
+
+interface IPreviewImagesOptionsOHOS {
+  images: Array<string>
+  index: number
+}
+
+interface IChooseMediaOptionsOHOS {
+  type: string
+  count: number
+}
+
+const previewMediaSchema = {
+  sources: 'Array'
+}
+
+// TODO: 扩展支持预览video
+export const previewMedia: typeof Taro.previewMedia = function (options) {
+  return new Promise((resolve, reject) => {
+    try {
+      validateParams('previewMedia', options, previewMediaSchema)
+    } catch (error) {
+      const res = { errMsg: error.message }
+      return callAsyncFail(reject, res, options)
+    }
+    const { sources, current } = options
+    const urls: Array<string> = []
+    for (const s of sources) {
+      if (s.type === 'image') {
+        urls.push(s.url)
+      }
+    }
+    const previewImageOptions: IPreviewImagesOptionsOHOS = {
+      images: urls,
+      index: current || 0
+    }
+    mediaLibrary.getMediaLibrary().startImagePreview(previewImageOptions.images, previewImageOptions.index).then((value) => {
+      callAsyncSuccess(resolve, value, options)
+    }).catch((error) => {
+      callAsyncFail(reject, error, options)
+    })
+  })
+}
+
+export const chooseMedia: typeof Taro.chooseMedia = function (options) {
+  return new Promise((resolve, reject) => {
+    try {
+      validateParams('chooseMedia', [options], ['Object'])
+    } catch (error) {
+      const res = { errMsg: error.message }
+      return callAsyncFail(reject, res, options)
+    }
+    const { count = 9, mediaType = ['image'] } = options
+    // HarmonyOS不支持image和video同时选择
+    // TODO: 不支持视频拍摄，无现成组件，后续需要封装
+    const mediaSelectOptions: IChooseMediaOptionsOHOS = {
+      count,
+      type: mediaType[0]
+    }
+    mediaLibrary.getMediaLibrary().startMediaSelect(mediaSelectOptions).then((value) => {
+      callAsyncSuccess(resolve, value, options)
+    }).catch((error) => {
+      callAsyncFail(reject, error, options)
+    })
+  })
+}

package/dist/apis/media/image.ts

@@ -0,0 +1,122 @@
+// HarmonyOS 图片模块首批接口从API version 7开始支持。
+// HarmonyOS 文档链接：https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-apis-image-0000001122977382
+// WX 文档链接：https://developers.weixin.qq.com/miniprogram/dev/api/media/image/wx.saveImageToPhotosAlbum.html
+
+// ✅ wx.getImageInfo(Object object) API7以上支持
+// ✅ wx.compressImage(Object object) API7以上支持
+// ✅ wx.chooseImage(Object object)
+// ❌ wx.chooseMessageFile(Object object) HarmonyOS不支持
+// ❌ wx.saveImageToPhotosAlbum(Object object) api 9+ HarmonyOS不支持
+// ❌ wx.previewImage(Object object) api 9+ HarmonyOS不支持
+
+import picker from '@ohos.file.picker'
+import image from '@ohos.multimedia.image'
+import { isNull } from '@tarojs/shared'
+import Taro from '@tarojs/taro'
+
+import { callAsyncFail, callAsyncSuccess, temporarilyNotSupport, validateParams } from '../utils'
+
+interface IPackingOptionOHOS {
+  format: string
+  quality: number
+}
+
+const getImageInfoSchema = {
+  url: 'String'
+}
+
+const compressImageSchema = {
+  url: 'String'
+}
+
+const chooseImageSchema = {
+  count: 'Number'
+}
+
+const photoSelectOptions = new picker.PhotoSelectOptions()
+
+export const getImageInfo: typeof Taro.getImageInfo = function (options) {
+  return new Promise((resolve, reject) => {
+    try {
+      validateParams('getImageInfo', options, getImageInfoSchema)
+    } catch (error) {
+      const res = { errMsg: error.message }
+      return callAsyncFail(reject, res, options)
+    }
+    const { src } = options
+    // FIX: 调试发现在版本api7中 source 为 undefined, 需鸿蒙侧确认
+    const source = image.createImageSource(src)
+    if (isNull(source)) {
+      const createImageSourceError = { errMsg: 'getImageInfo fail: createImageSource has failed.' }
+      callAsyncFail(reject, createImageSourceError, options)
+      return
+    }
+    source.getImageInfo().then((value) => {
+      callAsyncSuccess(resolve, value, options)
+    }).catch((error) => {
+      callAsyncFail(reject, error, options)
+    })
+  })
+}
+
+export const compressImage: typeof Taro.compressImage = function (options) {
+  return new Promise((resolve, reject) => {
+    try {
+      validateParams('compressImage', options, compressImageSchema)
+    } catch (error) {
+      const res = { errMsg: error.message }
+      return callAsyncFail(reject, res, options)
+    }
+    const { src, quality = 80 } = options
+
+    const source = image.createImageSource(src)
+    if (isNull(source)) {
+      const createImageSourceError = { errMsg: 'compressImage fail: createImageSource has failed.' }
+      callAsyncFail(reject, createImageSourceError, options)
+      return
+    }
+
+    const packer = image.createImagePacker(src)
+    if (isNull(packer)) {
+      const createImagePackerError = { errMsg: 'compressImage fail: createImagePacker has failed.' }
+      callAsyncFail(reject, createImagePackerError, options)
+    }
+
+    const packingOptionsOHOS: IPackingOptionOHOS = {
+      // TODO：需要获取文件名后缀
+      format: 'image/jpeg',
+      quality: quality
+    }
+    packer.packing(source, packingOptionsOHOS).then((value) => {
+      callAsyncSuccess(resolve, value, options)
+    }).catch((error) => {
+      callAsyncFail(reject, error, options)
+    })
+  })
+}
+
+export const chooseImage: typeof Taro.chooseImage = function (options) {
+  return new Promise((resolve, reject) => {
+    try {
+      validateParams('chooseImage', options, chooseImageSchema)
+    } catch (error) {
+      const res = { errMsg: error.message }
+      return callAsyncFail(reject, res, options)
+    }
+
+    const { count = 9 } = options
+    const photoViewPicker = new picker.PhotoViewPicker()
+
+    photoSelectOptions.maxSelectNumber = count // 选择媒体文件的最大数目
+    photoSelectOptions.MIMEType = picker.PhotoViewMIMETypes.IMAGE_TYPE // 过滤选择媒体文件类型为IMAGE
+
+    photoViewPicker.select(photoSelectOptions).then((photoSelectResult) => {
+      callAsyncSuccess(resolve, { tempFilePaths: photoSelectResult.photoUris })
+    }).catch((error) => {
+      callAsyncFail(reject, error, options)
+    })
+  })
+}
+
+export const previewImage = temporarilyNotSupport('previewImage')
+export const saveImageToPhotosAlbum = temporarilyNotSupport('saveImageToPhotosAlbum')

package/dist/apis/media/index.ts

@@ -0,0 +1,3 @@
+export * from './common'
+export * from './image'
+export * from './video'

package/dist/apis/media/video.ts

@@ -0,0 +1,86 @@
+// HarmonyOS 文档链接：https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-apis-media-0000001103383404
+// WX 文档链接：https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.chooseVideo.html
+// ✅ wx.saveVideoToPhotosAlbum
+// ❌ wx.openVideoEditor
+// ❌ wx.getVideoInfo
+// ❌ wx.createVideoContext
+// ❌ wx.compressVideo
+// ✅ wx.chooseVideo
+// VideoContext
+//   ❌ VideoContext.exitBackgroundPlayback
+//   ❌ VideoContext.exitFullScreen
+//   ❌ VideoContext.exitPictureInPicture
+//   ❌ VideoContext.hideStatusBar
+//   ❌ VideoContext.pause
+//   ❌ VideoContext.play
+//   ❌ VideoContext.playbackRate
+//   ❌ VideoContext.requestBackgroundPlayback
+//   ❌ VideoContext.requestFullScreen
+//   ❌ VideoContext.seek
+//   ❌ VideoContext.sendDanmu
+//   ❌ VideoContext.showStatusBar
+//   ❌ VideoContext.stop
+
+import mediaLibrary from '@ohos.multimedia.mediaLibrary'
+import Taro from '@tarojs/taro'
+
+import { callAsyncFail, callAsyncSuccess, validateParams } from '../utils'
+
+interface IChooseVideoOptionOHOS {
+  type: string
+  count: number
+}
+
+interface ISaveVideoToPhotosAlbumOptionsOHOS {
+  src: string
+  mimeType: string
+  relativePath?: string
+}
+
+const saveVideoToPhotosAlbumSchema = {
+  filePath: 'String'
+}
+
+// TODO: 1.返回属性补全
+// TODO: 2.只支持从相册选择，补充摄像头拍摄功能，需要HarmonyOS提供选择组件
+export const chooseVideo: typeof Taro.chooseVideo = function (options = {}) {
+  return new Promise((resolve, reject) => {
+    try {
+      validateParams('chooseVideo', [options], ['Object'])
+    } catch (error) {
+      const res = { errMsg: error.message }
+      return callAsyncFail(reject, res, options)
+    }
+    const chooseVideoOptionsOHOS: IChooseVideoOptionOHOS = {
+      type: 'video',
+      count: 1
+    }
+    mediaLibrary.getMediaLibrary().startMediaSelect(chooseVideoOptionsOHOS).then((value) => {
+      callAsyncSuccess(resolve, { tempFilePaths: value })
+    }).catch((error) => {
+      callAsyncFail(reject, error, options)
+    })
+  })
+}
+
+export const saveVideoToPhotosAlbum: typeof Taro.saveVideoToPhotosAlbum = function (options) {
+  return new Promise((resolve, reject) => {
+    try {
+      validateParams('saveVideoToPhotosAlbum', options, saveVideoToPhotosAlbumSchema)
+    } catch (error) {
+      const res = { errMsg: error.message }
+      return callAsyncFail(reject, res, options)
+    }
+    const { filePath } = options
+    const saveVideoToPhotosAlbumOptions: ISaveVideoToPhotosAlbumOptionsOHOS = {
+      src: filePath,
+      // TODO：需要获取文件名后缀，'video/mp4'、'video/3gpp'等
+      mimeType: 'video/mp4'
+    }
+    mediaLibrary.getMediaLibrary().storeMediaAsset(saveVideoToPhotosAlbumOptions).then((value) => {
+      callAsyncSuccess(resolve, value, options)
+    }).catch((error) => {
+      callAsyncFail(reject, error, options)
+    })
+  })
+}

package/dist/apis/navigate/index.ts

@@ -0,0 +1,8 @@
+import { temporarilyNotSupport } from '../utils'
+
+// 跳转
+export const openEmbeddedMiniProgram = /* @__PURE__ */ temporarilyNotSupport('openEmbeddedMiniProgram')
+export const navigateToMiniProgram = /* @__PURE__ */ temporarilyNotSupport('navigateToMiniProgram')
+export const navigateBackMiniProgram = /* @__PURE__ */ temporarilyNotSupport('navigateBackMiniProgram')
+export const exitMiniProgram = /* @__PURE__ */ temporarilyNotSupport('exitMiniProgram')
+export const openBusinessView = /* @__PURE__ */ temporarilyNotSupport('openBusinessView')