@tarojs/plugin-platform-harmony-ets 4.0.0-beta.6 → 4.0.0-beta.60

package/dist/apis/base/system.ts

@@ -1,24 +1,56 @@
+import ConfigurationConstant from '@ohos.app.ability.ConfigurationConstant'
 // 设备信息,从 API Version 6 开始支持
 import deviceInfo from '@ohos.deviceInfo'
 // 显示设备属性,从 API Version 7 开始支持
 import _display from '@ohos.display'
 // 从 API Version 7 开始支持
 import i18n from '@ohos.i18n'
-// 设备信息 从API Version 6开始，该接口不再维护，推荐使用新接口'@ohos.deviceInfo'进行设备信息查询
-import deviceMethod from '@system.device'
+import { Current, window } from '@tarojs/runtime'
 
 import { callAsyncFail, callAsyncSuccess } from '../utils'
 
 import type Taro from '@tarojs/taro/types'
 
-const display = _display.getDefaultDisplaySync()
+let display
+let navigationIndicatorRect
+let safeArea: TaroGeneral.SafeAreaResult | null = null
+let statusBarHeight
+let windowRect
 
-let device
+(Current as any).contextPromise.then((context) => {
+  const win = window.__ohos.getLastWindow(context)
+  win.then(mainWindow => {
+    const topRect = mainWindow.getWindowAvoidArea(window.__ohos.AvoidAreaType.TYPE_SYSTEM).topRect
+    navigationIndicatorRect = mainWindow.getWindowAvoidArea(window.__ohos.AvoidAreaType.TYPE_NAVIGATION_INDICATOR).bottomRect
+    statusBarHeight = topRect.top + topRect.height
+    windowRect = mainWindow.getWindowProperties().windowRect
 
-deviceMethod.getInfo({
-  success: data => {
-    device = data
-  }
+    try {
+      display = _display.getDefaultDisplaySync()
+      // @ts-ignore
+      display.getCutoutInfo((err, { boundingRects = [], waterfallDisplayAreaRects = {} }: _display.CutoutInfo = {}) => {
+        if (err?.code) {
+          console.error('Failed to get cutout info', JSON.stringify(err))
+          return
+        }
+
+        const top = Math.max(...boundingRects.map(rect => rect.top + rect.height), waterfallDisplayAreaRects.top?.top + waterfallDisplayAreaRects.top?.height, statusBarHeight)
+        const bottom = Math.min(display.height - waterfallDisplayAreaRects.bottom?.top, navigationIndicatorRect?.top)
+        const left = waterfallDisplayAreaRects.left?.left + waterfallDisplayAreaRects.left?.width
+        const right = display.width - waterfallDisplayAreaRects.right?.left
+        safeArea = {
+          top,
+          bottom,
+          left,
+          right,
+          height: bottom - top,
+          width: right - left,
+        }
+      })
+    } catch (e) {
+      console.error('Failed to get display', e)
+    }
+  })
 })
 
 /* 同步版本 */
@@ -32,7 +64,7 @@ export const getSystemInfoSync: typeof Taro.getSystemInfoSync = function () {
   res.cameraAuthorized = null // 允许使用摄像头的开关 boolean
   res.enableDebug = null // 是否已打开调试 boolean
   res.fontSizeSetting = null // 用户字体大小（单位px） number
-  res.language = i18n && i18n.getSystemLanguage && i18n.getSystemLanguage() // string
+  res.language = i18n?.getSystemLanguage?.() // string
   res.locationAuthorized = null // 定位的开关 boolean
   res.locationEnabled = null // 地理位置的系统开关 boolean
   res.microphoneAuthorized = null // 麦克风的开关 boolean
@@ -43,17 +75,18 @@ export const getSystemInfoSync: typeof Taro.getSystemInfoSync = function () {
   res.notificationSoundAuthorized = false // 通知带有声音的开关（仅 iOS 有效）boolean
   res.phoneCalendarAuthorized = null // 使用日历的开关 boolean
   res.wifiEnabled = false // Wi-Fi 的系统开关 boolean
-  res.pixelRatio = null // 设备像素比,number
-  res.platform = 'android' // 客户端平台 string
-  res.safeArea = null // 在竖屏正方向下的安全区域 General.SafeAreaResult
-  res.screenHeight = display && display.height // 屏幕高度，单位px number
-  res.screenWidth = display && display.width // 屏幕宽度，单位px number
-  res.statusBarHeight = null // 状态栏的高度，单位px number
-  res.system = deviceInfo && deviceInfo.osFullName // 操作系统及版本 string
-  res.theme = null // 系统当前主题，取值为light或dark 'light' | 'dark'
-  res.windowWidth = device && device.windowWidth // 可使用窗口宽度，单位px number
-  res.windowHeight = device && device.windowHeight // 可使用窗口高度，单位px number
-  res.version = deviceInfo && deviceInfo.displayVersion // 版本号 string
+  res.pixelRatio = display && display.densityPixels // 设备像素比,number
+  res.platform = 'harmony' // 客户端平台 string
+  res.safeArea = safeArea // 在竖屏正方向下的安全区域 General.SafeAreaResult
+  res.screenHeight = display?.height // 屏幕高度，单位px number
+  res.screenWidth = display?.width // 屏幕宽度，单位px number
+  res.statusBarHeight = statusBarHeight // 状态栏的高度，单位px number
+  res.system = deviceInfo?.osFullName // 操作系统及版本 string
+  // Note: 更新配置时才能记录
+  res.theme = AppStorage.get('__TARO_APP_CONFIG')?.colorMode === ConfigurationConstant.ColorMode.COLOR_MODE_DARK ? 'dark' : 'light' // 系统当前主题，取值为light或dark 'light' | 'dark'
+  res.windowHeight = windowRect?.height // 可使用窗口高度，单位px number
+  res.windowWidth = windowRect?.width // 可使用窗口宽度，单位px number
+  res.version = deviceInfo?.displayVersion // 版本号 string
 
   return res
 }

package/dist/apis/canvas/index.ts

@@ -1,12 +1,21 @@
+import { eventSource } from '@tarojs/runtime'
+
 import { temporarilyNotSupport } from '../utils'
 
+// @ts-ignore
+import type { TaroCanvasElement } from '@tarojs/runtime'
 // 画布
 
 /** 创建离屏 canvas 实例 */
 export const createOffscreenCanvas = /* @__PURE__ */ temporarilyNotSupport('createOffscreenCanvas')
 
 /** 创建 canvas 的绘图上下文 CanvasContext 对象 */
-export const createCanvasContext = /* @__PURE__ */ temporarilyNotSupport('createOffscreenCanvas')
+// export const createCanvasContext = /* @__PURE__ */ temporarilyNotSupport('createOffscreenCanvas')
+export const createCanvasContext = (canvasId: string) => {
+  const dom = eventSource.get(`canvasId-${canvasId}`)
+  // return dom as TaroCanvasElement
+  if (dom) return (dom as unknown as TaroCanvasElement).context
+}
 
 /** 把当前画布指定区域的内容导出生成指定大小的图片 */
 export const canvasToTempFilePath = /* @__PURE__ */ temporarilyNotSupport('createOffscreenCanvas')

package/dist/apis/device/clipboard.ts

@@ -1,5 +1,6 @@
 // 从 API Version 6 开始支持
 import pasteboard from '@ohos.pasteboard'
+import promptAction from '@ohos.promptAction'
 import { isString } from '@tarojs/shared'
 
 import { callAsyncFail, getParameterError, object2String } from '../utils'
@@ -38,6 +39,14 @@ export const setClipboardData: typeof Taro.setClipboardData = function (options)
         }
         callAsyncFail(reject, res, options)
       } else {
+
+        promptAction.showToast({ 
+          message: '内容已复制', 
+          duration: 1500,
+          bottom: '50%',
+          showMode: 1 // 设置弹窗显示模式，显示在应用之上。
+        })
+        
         return handle.success({
           data,
         }, { resolve, reject })

package/dist/apis/framework/index.ts

@@ -1,5 +1,3 @@
-import { Current } from '@tarojs/runtime'
-
 import { temporarilyNotSupport } from '../utils'
 
 export const ENV_TYPE = {
@@ -19,12 +17,10 @@ export function getEnv () {
   return ENV_TYPE.HARMONY
 }
 
-export { Current }
-
 // TODO
 export const getCurrentPages = () => []
 
-export const getCurrentInstance = () => Current
+export { Current, getCurrentInstance } from '@tarojs/runtime'
 
 export const requirePlugin = temporarilyNotSupport('requirePlugin')
 

package/dist/apis/index.ts

@@ -33,7 +33,7 @@ const defaultUnitPrecision = 5
 const defaultTargetUnit = 'vp'
 
 export function getApp () {
-  return Current.app
+  return Current.app || {}
 }
 
 export function initPxTransform ({
@@ -58,20 +58,25 @@ export function initPxTransform ({
 
 const display = _display.getDefaultDisplaySync()
 
+let displayWidth = display.width
+let ratioCache: number | false = false
 let designWidthFunc: (input: number) => number
+let designWidth = defaultDesignWidth
 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} 的设置！`)
+  // Note: 提前调用 display 可能无法获取正确值
+  if (ratioCache === false || displayWidth !== display.width) {
+    const config = (Current as any).taro?.config || {}
+    if (!isFunction(designWidthFunc)) {
+      designWidthFunc = isFunction(config.designWidth)
+        ? config.designWidth
+        : () => config.designWidth
+      designWidth = designWidthFunc(value) || defaultDesignWidth
+    }
+    displayWidth = display.width
+    ratioCache = Math.min(display.width, display.height) / designWidth
   }
-  return Math.min(display.width, display.height) / designWidth / deviceRatio[designWidth]
+
+  return ratioCache
 }
 
 // Note: 设置为 style 单位时会自动完成设计稿转换，设计开发者调用 API 时也许抹平差异，例如 pageScrollTo[option.offsetTop]
@@ -79,6 +84,9 @@ export function pxTransformHelper (size: number, unit?: string, isNumber = false
   const config = (Current as any).taro?.config || {}
   const targetUnit = unit || config.targetUnit || defaultTargetUnit
 
+  if (targetUnit === 'PX') {
+    return px2vp(size * display.scaledDensity) + 'vp'
+  }
   const ratio = getRatio(size)
   let val = size * ratio
 
@@ -92,19 +100,19 @@ export function pxTransformHelper (size: number, unit?: string, isNumber = false
   return isNumber ? val : val + targetUnit
 }
 
-export function pxTransform (size: number): number {
+export function pxTransform (size: number): number | string {
   const config = (Current as any).taro?.config || {}
   const targetUnit = config.targetUnit || defaultTargetUnit
 
-  let val = size
+  const val = size
   switch (targetUnit) {
     case 'vp':
-      val = px2vp(size)
-      break
+      return pxTransformHelper(size, 'px')
+      // return `${size}lpx`
     default:
       // NOTE: 鸿蒙环境下 style 会自动完成设计稿转换，无需在方法内二次调整
   }
-  return val + config.targetUnit
+  return val + targetUnit
 }
 
 export function canIUseWebp () {
@@ -120,5 +128,7 @@ export function getAppInfo () {
   }
 }
 
+initNativeApi(taro)
+
 export * from './apis'
 export default taro

package/dist/apis/network/request.ts

@@ -6,7 +6,7 @@
 // ✅ RequestTask.onHeadersReceived
 
 import http from '@ohos.net.http'
-import { isString, isUndefined } from '@tarojs/shared'
+import { isString } from '@tarojs/shared'
 
 import { callAsyncFail, callAsyncSuccess, validateParams } from '../utils'
 
@@ -59,10 +59,10 @@ export const request: typeof Taro.request = function (options) {
     }
 
     // 检查 Header 是否有 Referer
-    if (isUndefined(header.Referer)) {
-      const error = { errMsg: 'request fail parameter error: the header doesn‘t support Referer property' }
-      callAsyncFail(reject, error, options)
-    }
+    // if (isUndefined(header.Referer)) {
+    //   const error = { errMsg: 'request fail parameter error: the header doesn‘t support Referer property' }
+    //   callAsyncFail(reject, error, options)
+    // }
 
     // 检查 method 是否正确
     if (method) {

package/dist/apis/route/index.ts

@@ -16,6 +16,21 @@ function parseURL (raw = ''): [string, Record<string, unknown>] {
   const [urlStr, queryStr = ''] = raw.split('?')
   const query: Record<string, unknown> = queryToJson(queryStr)
   let url = urlStr.replace(/^\//, '')
+
+  // 处理相对路径
+  if (url.indexOf('.') === 0) {
+    const page = router.getState()
+    const parts = page.path.split('/')
+    parts.pop()
+    url.split('/').forEach((item) => {
+      if (item === '.') {
+        return
+      }
+      item === '..' ? parts.pop() : parts.push(item)
+    })
+    url = parts.join('/')
+  }
+
   if (isTabPage(url)) {
     query.$page = url
     url = TARO_TABBAR_PAGE_PATH

package/dist/apis/storage/index.ts

@@ -3,114 +3,181 @@
  * https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/js-apis-data-preferences-0000001427745052-V3
 */
 import bundleManager from '@ohos.bundle.bundleManager'
-import dataPreferences from '@ohos.data.preferences'
-import hilog from '@ohos.hilog'
+import distributedKVStore from '@ohos.data.distributedKVStore'
 import { Current } from '@tarojs/runtime'
 
-import { callAsyncFail, callAsyncSuccess, temporarilyNotSupport, validateParams } from '../utils'
+import { temporarilyNotSupport, validateParams } from '../utils'
+import { MethodHandler } from '../utils/handler'
 
 import type Taro from '@tarojs/taro/types'
 
-const preferencesPromise = (Current as any).contextPromise
-  .then((context) => {
-    return bundleManager
-      .getBundleInfoForSelf(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION)
-      .then(data => {
-        return dataPreferences
-          .getPreferences(context, `${data.appInfo.uid}Store`)
-      })
-  })
-  .catch((error) => {
-    hilog.error(0x0000, 'TaroFailedTag', 'Failed to load the storage. Cause: %{public}s', error.code ? JSON.stringify(error) : error.message || error)
-  })
+let context
+let kvManager: distributedKVStore.KVManager
+let kvStore: distributedKVStore.SingleKVStore
+let kvStorePromise: Promise<void>
+
+(Current as any).contextPromise.then((ctx) => {
+  context = ctx
+  const kvManagerConfig: distributedKVStore.KVManagerConfig = {
+    context: context,
+    bundleName: 'com.example.taro'
+  }
 
-async function getItem (key: string): Promise<{ result: boolean, data?: number | string | boolean }> {
   try {
-    const preferences = await preferencesPromise
-    const item = await preferences.get(key, null)
+    // 创建KVManager实例
+    kvManager = distributedKVStore.createKVManager(kvManagerConfig)
+    // 继续创建获取数据库
+    const options: distributedKVStore.Options = {
+      createIfMissing: true,
+      encrypt: false,
+      backup: false,
+      autoSync: false,
+      // kvStoreType不填时，默认创建多设备协同数据库
+      kvStoreType: distributedKVStore.KVStoreType.SINGLE_VERSION,
+      // 多设备协同数据库：kvStoreType: distributedKVStore.KVStoreType.DEVICE_COLLABORATION,
+      securityLevel: distributedKVStore.SecurityLevel.S1
+    }
 
-    return { result: true, data: item }
-  } catch (error) {
-    return { result: false }
+    const data = bundleManager.getBundleInfoForSelfSync(bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION)
+    kvStorePromise = new Promise(resolve => {
+      kvManager.getKVStore<distributedKVStore.SingleKVStore>(`${data.appInfo.uid}Store`, options, (err, store: distributedKVStore.SingleKVStore) => {
+        if (err) {
+          console.error(`Failed to get KVStore: Code:${err.code},message:${err.message}`)
+          return
+        }
+        kvStore = store
+        // 请确保获取到键值数据库实例后，再进行相关数据操作
+        resolve()
+      })
+    })
+  } catch (e) {
+    console.error(`Failed to create KVManager. Code:${e.code},message:${e.message}`)
   }
-}
+
+  return context
+})
 
 const storageSchema = {
   key: 'String'
 }
 
+function checkContextExist (api: string, isAsync = false) {
+  if (!context) {
+    const message = `${api} 调用失败，Taro 不支持过早地调用 ${api}，请确保页面已经渲染完成再调用此 API`
+    if (isAsync) {
+      return {
+        isExist: false,
+        error: Promise.reject(new Error(message))
+      }
+    } else {
+      console.warn(message)
+
+      return {
+        isExist: false,
+      }
+    }
+  }
+
+  return {
+    isExist: true,
+  }
+}
+
 export function getStorage<T = any> (options: Taro.getStorage.Option<T>) {
+  const name = 'getStorage'
+  const { isExist, error } = checkContextExist(name, true)
+
+  if (!isExist) {
+    return error
+  }
+
+  const { key, success, fail, complete } = options || {}
+  const handle = new MethodHandler<{data: any}>({ name, success, fail, complete })
+
   return new Promise((resolve, reject) => {
-    try {
-      validateParams('getStorage', options, storageSchema)
-    } catch (error) {
-      const res = { errMsg: error.message }
-      return callAsyncFail(reject, res, options)
-    }
-    getItem(options.key).then(({ result, data }) => {
-      const res: Record<string, any> = { errMsg: 'getStorage:ok' }
-
-      if (result) {
-        res.data = data
-        callAsyncSuccess(resolve, res, options)
-      } else {
-        res.errMsg = 'getStorage:fail data not found'
-        callAsyncFail(reject, res, options)
+    kvStorePromise.then(() => {
+      try {
+        validateParams(name, options, storageSchema)
+      } catch (error) {
+        const res = { errMsg: error.message }
+        return handle.fail(res, { resolve, reject })
       }
+  
+      kvStore = kvStore as distributedKVStore.SingleKVStore
+      kvStore.get(key, (err, data) => {
+        if (err) {
+          handle.fail({ errMsg: `Failed to get data. Code:${err.code},message:${err.message}` }, { resolve, reject })
+          return
+        }
+  
+        handle.success({ data }, { resolve, reject })
+      })
     })
   })
 }
 
 export function setStorage (options: Taro.setStorage.Option) {
-  return new Promise((resolve, reject) => {
-    try {
-      validateParams('setStorage', options, storageSchema)
-    } catch (error) {
-      const res = { errMsg: error.message }
-      return callAsyncFail(reject, res, options)
-    }
+  const name = 'setStorage'
+  const { isExist, error } = checkContextExist(name, true)
 
-    const { key, data } = options
-    const res = { errMsg: 'setStorage:ok' }
+  if (!isExist) {
+    return error
+  }
 
-    preferencesPromise.then(async (preferences) => {
-      await preferences.put(key, data)
-      await preferences.flush()
+  const { key, data, success, fail, complete } = options || {}
+  const handle = new MethodHandler({ name, success, fail, complete })
 
-      callAsyncSuccess(resolve, res, options)
+  return new Promise((resolve, reject) => {
+    kvStorePromise.then(() => {
+      try {
+        validateParams(name, options, storageSchema)
+      } catch (error) {
+        const res = { errMsg: error.message }
+        return handle.fail(res, { resolve, reject })
+      }
+  
+      kvStore = kvStore as distributedKVStore.SingleKVStore
+      kvStore.put(key, data, (err) => {
+        if (err) {
+          handle.fail({ errMsg: `Failed to put data. Code:${err.code},message:${err.message}` }, { resolve, reject })
+          return
+        }
+  
+        handle.success({}, { resolve, reject })
+      })
     })
   })
 }
 
 export function removeStorage (options: Taro.removeStorage.Option) {
-  return new Promise((resolve, reject) => {
-    try {
-      validateParams('removeStorage', options, storageSchema)
-    } catch (error) {
-      const res = { errMsg: error.message }
-      return callAsyncFail(reject, res, options)
-    }
+  const name = 'removeStorage'
+  const { isExist, error } = checkContextExist(name, true)
 
-    const { key } = options
-
-    preferencesPromise.then(async (preferences) => {
-      await preferences.delete(key)
-      await preferences.flush()
-
-      const res = { errMsg: 'removeStorage:ok' }
-      callAsyncSuccess(resolve, res, options)
-    })
-  })
-}
+  if (!isExist) {
+    return error
+  }
 
-export function clearStorage (options: Taro.clearStorage.Option) {
-  return new Promise(resolve => {
-    preferencesPromise.then(async (preferences) => {
-      await preferences.clear()
-      await preferences.flush()
+  const { key, success, fail, complete } = options || {}
+  const handle = new MethodHandler({ name, success, fail, complete })
 
-      const res = { errMsg: 'clearStorage:ok' }
-      callAsyncSuccess(resolve, res, options)
+  return new Promise((resolve, reject) => {
+    kvStorePromise.then(() => {
+      try {
+        validateParams(name, options, storageSchema)
+      } catch (error) {
+        const res = { errMsg: error.message }
+        return handle.fail(res, { resolve, reject })
+      }
+  
+      kvStore = kvStore as distributedKVStore.SingleKVStore
+      kvStore.delete(key, (err) => {
+        if (err) {
+          handle.fail({ errMsg: `Failed to delete data. Code:${err.code},message:${err.message}` }, { resolve, reject })
+          return
+        }
+  
+        handle.success({}, { resolve, reject })
+      })
     })
   })
 }
@@ -118,11 +185,6 @@ export function clearStorage (options: Taro.clearStorage.Option) {
 export const getStorageInfoSync = temporarilyNotSupport('getStorageInfoSync')
 export const getStorageInfo = temporarilyNotSupport('getStorageInfo')
 
-export const getStorageSync = temporarilyNotSupport('getStorageSync', 'getStorage')
-export const setStorageSync = temporarilyNotSupport('setStorageSync', 'setStorage')
-export const clearStorageSync = temporarilyNotSupport('clearStorageSync', 'clearStorage')
-export const removeStorageSync = temporarilyNotSupport('removeStorageSync', 'removeStorage')
-
 export const createBufferURL = /* @__PURE__ */ temporarilyNotSupport('createBufferURL')
 export const revokeBufferURL = /* @__PURE__ */ temporarilyNotSupport('revokeBufferURL')
 
@@ -131,5 +193,11 @@ export const batchSetStorage = /* @__PURE__ */ temporarilyNotSupport('batchSetSt
 export const batchGetStorageSync = /* @__PURE__ */ temporarilyNotSupport('batchGetStorageSync')
 export const batchGetStorage = /* @__PURE__ */ temporarilyNotSupport('batchGetStorage')
 
+export const clearStorage = temporarilyNotSupport('clearStorage')
+export const getStorageSync = temporarilyNotSupport('getStorageSync', 'getStorage')
+export const setStorageSync = temporarilyNotSupport('setStorageSync', 'setStorage')
+export const clearStorageSync = temporarilyNotSupport('clearStorageSync', 'clearStorage')
+export const removeStorageSync = temporarilyNotSupport('removeStorageSync', 'removeStorage')
+
 export * from './background-fetch'
 export * from './cache-manager'