@mpxjs/core 2.10.18 → 2.10.19

package/@types/index.d.ts

@@ -387,7 +387,37 @@ export interface RnConfig {
    * @platform android
    * @default true
    */
-  enableNativeKeyboardAvoiding?: boolean
+  enableNativeKeyboardAvoiding?: boolean,
+
+  /**
+   * 自定义蓝牙权限检查函数，用于在调用 openBluetoothAdapter 时替代默认的权限检查逻辑。
+   *
+   * Mpx 在 iOS 上默认返回 true（假定权限由系统弹窗处理），在 Android 上会请求 ACCESS_FINE_LOCATION 或 BLUETOOTH_SCAN/CONNECT 权限。
+   * 如果需要自定义权限申请逻辑（例如在某些定制 Android 设备上），可配置此函数。
+   *
+   * @returns Promise<boolean> Resolves 为 true 表示权限获取成功，false 表示失败。
+   */
+  bluetoothPermission?: () => Promise<boolean>
+
+  /**
+   * 自定义 Wi-Fi 权限检查函数，用于在调用 startWifi 时替代默认的权限检查逻辑。
+   *
+   * Mpx 在 Android 上默认会请求 ACCESS_FINE_LOCATION 权限。
+   * 如果需要自定义权限申请逻辑，可配置此函数。
+   *
+   * @returns Promise<boolean> Resolves 为 true 表示权限获取成功，false 表示失败。
+   */
+  wifiPermission?: () => Promise<boolean>
+
+  /**
+   * 自定义相机权限检查函数，用于在渲染 Camera 组件前进行权限检查。
+   *
+   * 默认情况下，Mpx 会直接渲染 Camera 组件。
+   * 如果配置了此函数，Camera 组件会等待该函数返回 true 后再进行渲染。
+   *
+   * @returns Promise<boolean> Resolves 为 true 表示权限获取成功，false 表示失败。
+   */
+  cameraPermission?: () => Promise<boolean>
 }
 
 interface MpxConfig {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpxjs/core",
-  "version": "2.10.18",
+  "version": "2.10.19",
   "description": "mpx runtime core",
   "keywords": [
     "miniprogram",
@@ -113,5 +113,5 @@
     "url": "https://github.com/didi/mpx/issues"
   },
   "sideEffects": false,
-  "gitHead": "8ce11a81959cb4b807d683b14c2d0b72c3991da3"
+  "gitHead": "ca50ba6b1361f3c7790746476dd8b8e6be802ea3"
 }

package/src/platform/builtInMixins/index.js

@@ -26,7 +26,8 @@ export default function getBuiltInMixins ({ type, rawOptions = {} }) {
       refsMixin(),
       i18nMixin(),
       relationsMixin(type),
-      pageRouteMixin(type)
+      pageRouteMixin(type),
+      pageScrollMixin(type)
     ]
   } else if (isWeb) {
     bulitInMixins = [

package/src/platform/builtInMixins/pageScrollMixin.ios.js

@@ -0,0 +1,142 @@
+import { warn } from '@mpxjs/utils'
+import { CREATED } from '../../core/innerLifecycle'
+
+/**
+ * React Native 页面滚动 Mixin
+ * 提供页面级别的 pageScrollTo 方法
+ * 使用该功能需在页面的 scroll-view 组件上声明 wx:ref="pageScrollView"
+ */
+export default function pageScrollMixin (mixinType) {
+  if (mixinType !== 'page') {
+    return
+  }
+
+  return {
+    [CREATED] () {
+      this.__registerPageScrollTo()
+    },
+    beforeUnmount () {
+      const navigation = this.__props?.navigation
+      if (navigation && navigation.pageScrollTo) {
+        delete navigation.pageScrollTo
+      }
+    },
+    methods: {
+      /**
+       * 注册 pageScrollTo 方法到 navigation 对象
+       */
+      __registerPageScrollTo () {
+        const navigation = this.__props?.navigation
+
+        // navigation.pageScrollTo 不存在时才注册，避免重复
+        if (navigation && !navigation.pageScrollTo) {
+          navigation.pageScrollTo = (options) => {
+            this.__pageScrollTo(options)
+          }
+        }
+      },
+
+      /**
+       * 获取页面滚动视图节点（通过固定 ref 名称 pageScrollView）
+       * @returns {Object|null} 滚动视图的节点实例
+       */
+      __findScrollableNode () {
+        const ref = this.__refs?.pageScrollView?.[0]
+        if (!ref || ref.type !== 'node' || !ref.instance?.getNodeInstance) return null
+        return ref.instance.getNodeInstance()
+      },
+
+      /**
+       * 页面滚动到指定位置
+       * @param {Object} options - 配置选项
+       * @param {number} options.scrollTop - 滚动到页面的目标位置（单位 px）
+       * @param {number} options.duration - 滚动动画的时长（单位 ms）
+       * @param {string} options.selector - 选择器
+       * @param {number} options.offsetTop - 偏移距离
+       * @param {Function} options.onSuccess - 成功回调
+       * @param {Function} options.onFail - 失败回调
+       */
+      __pageScrollTo (options = {}) {
+        const {
+          scrollTop,
+          duration = 300,
+          selector,
+          offsetTop = 0,
+          onSuccess,
+          onFail
+        } = options
+
+        try {
+          const nodeInstance = this.__findScrollableNode()
+
+          if (nodeInstance) {
+            this.__executeScroll(nodeInstance, scrollTop, duration, selector, offsetTop, onSuccess, onFail)
+            return
+          }
+
+          // 没找到可滚动视图
+          const errMsg = 'pageScrollTo:fail scrollable view not found. Please add wx:ref="pageScrollView" to the scroll-view component in your page'
+          warn(errMsg)
+          onFail && onFail(errMsg)
+        } catch (e) {
+          const errMsg = `pageScrollTo:fail ${e.message}`
+          warn(errMsg)
+          onFail && onFail(errMsg)
+        }
+      },
+
+      /**
+       * 执行滚动操作
+       */
+      __executeScroll (scrollViewNodeInstance, scrollTop, duration, selector, offsetTop, onSuccess, onFail) {
+        try {
+          const scrollViewNode = scrollViewNodeInstance.instance.node
+
+          // 如果提供了 selector，使用 scrollIntoView
+          if (selector) {
+            if (scrollViewNode.scrollIntoView) {
+              scrollViewNode.scrollIntoView(selector, {
+                offset: offsetTop,
+                animated: duration > 0,
+                duration
+              })
+              onSuccess && onSuccess()
+            } else {
+              const errMsg = 'pageScrollTo:fail scrollIntoView method not available'
+              warn(errMsg)
+              onFail && onFail(errMsg)
+            }
+            return
+          }
+
+          // 使用 scrollTop 进行滚动
+          if (scrollTop !== undefined) {
+            if (scrollViewNode.scrollTo) {
+              scrollViewNode.scrollTo({
+                top: scrollTop,
+                left: 0,
+                animated: duration > 0,
+                duration
+              })
+              onSuccess && onSuccess()
+            } else {
+              const errMsg = 'pageScrollTo:fail scrollTo method not available'
+              warn(errMsg)
+              onFail && onFail(errMsg)
+            }
+            return
+          }
+
+          // 既没有 scrollTop 也没有 selector
+          const errMsg = 'pageScrollTo:fail scrollTop or selector is required'
+          warn(errMsg)
+          onFail && onFail(errMsg)
+        } catch (e) {
+          const errMsg = `pageScrollTo:fail ${e.message}`
+          warn(errMsg)
+          onFail && onFail(errMsg)
+        }
+      }
+    }
+  }
+}

package/src/platform/env/vuePlugin.js

@@ -1,4 +1,4 @@
-import { walkChildren, parseSelector, error, hasOwn, collectDataset } from '@mpxjs/utils'
+import { walkChildren, parseSelector, error, hasOwn, collectDataset, getByPath } from '@mpxjs/utils'
 import { createSelectorQuery, createIntersectionObserver } from '@mpxjs/api-proxy'
 import { EffectScope } from 'vue'
 import { PausedState } from '../../helper/const'
@@ -56,6 +56,17 @@ const hackEffectScope = () => {
 }
 
 export default function install (Vue) {
+  const originalWatch = Vue.prototype.$watch
+  Vue.prototype.$watch = function (expOrFn, cb, options) {
+    if (typeof expOrFn === 'string' && expOrFn.indexOf(',') > -1) {
+      const keys = expOrFn.split(',').map(key => key.trim())
+      expOrFn = function () {
+        return keys.map(key => getByPath(this, key))
+      }
+    }
+    return originalWatch.call(this, expOrFn, cb, options)
+  }
+
   Object.defineProperties(Vue.prototype, {
     data: {
       get () {