React Native原生模块封装HealthKit类型映射简化传参的实现方法

根因说明 #

• 此前通过Object.assign将映射常量挂载到MyHealthLibrary原生实例上的方案不生效，核心原因是：NativeModules导出的原生模块是桥接层的特殊代理对象，所有方法调用会直接将传入的参数序列化后转发给Swift侧，你额外挂载在这个JS代理对象上的映射属性，完全不会参与原生方法的参数处理流程——原生侧最终收到的依然是业务代码传入的"HeartRate"这类简化名称，无法被Swift层的HealthKit逻辑识别。

正确实现步骤 #

1. 定义独立的映射常量 #

不需要把映射逻辑和原生模块实例绑定，直接在Healthkit.js封装层内定义读、写权限对应的简化名到真实HK标识符的映射表即可：

// Healthkit.js 内部维护映射表
const HK_READ_TYPE_MAP = {
  HeartRate: "HKQuantityTypeIdentifierHeartRate",
  StepCount: "HKQuantityTypeIdentifierStepCount",
  // 按业务需要补充其他类型映射
};

const HK_WRITE_TYPE_MAP = {
  // 写权限映射同读侧规则，按需补充
};

2. 做JS层方法拦截，替代直接导出原生实例 #

不要直接将NativeModules.MyHealthLibrary原样导出，而是在JS层对需要做参数转换的原生方法做一层拦截：在把参数传递给Swift侧之前，先完成简化名到全量HK标识符的转换。
参考实现代码：

import { NativeModules } from 'react-native';
const { MyHealthLibrary } = NativeModules;

// 上述映射表定义放在此处

// 重写requestAuthorization方法，实现参数转换
const requestAuthorization = (authOptions = {}) => {
  // 转换读权限参数，过滤未定义的简化名
  const validReadTypes = (authOptions.read || []).map(simpleTypeName => {
    const realType = HK_READ_TYPE_MAP[simpleTypeName];
    if (!realType) {
      console.warn(`未注册的HealthKit读类型: ${simpleTypeName}，已自动跳过`);
      return null;
    }
    return realType;
  }).filter(Boolean);

  // 转换写权限参数，逻辑同读侧
  const validWriteTypes = (authOptions.write || []).map(simpleTypeName => {
    const realType = HK_WRITE_TYPE_MAP[simpleTypeName];
    if (!realType) {
      console.warn(`未注册的HealthKit写类型: ${simpleTypeName}，已自动跳过`);
      return null;
    }
    return realType;
  }).filter(Boolean);

  // 将转换后的合法参数传递给原生方法
  return MyHealthLibrary.requestAuthorization({
    read: validReadTypes,
    write: validWriteTypes
  });
}

// 透传原生模块上其他不需要参数处理的方法，减少重复代码
const wrappedModule = {
  requestAuthorization,
  ...Object.entries(MyHealthLibrary).reduce((acc, [key, value]) => {
    // 透传所有原生方法，跳过已经手动重写的requestAuthorization
    if (typeof value === 'function' && key !== 'requestAuthorization') {
      acc[key] = (...args) => value.apply(MyHealthLibrary, args);
    }
    return acc;
  }, {})
};

export default wrappedModule;

3. 业务层调用适配 #

改造完成后，业务代码不需要再拼接冗长的HK全量标识符，直接传入简化类型名称即可，JS封装层会自动完成参数转换再传给原生侧：

// App.js 调用示例
import HealthKit from './Healthkit';

HealthKit.requestAuthorization({
  read: ['HeartRate', 'StepCount'],
  write: ['StepCount']
})

补充优化提示 #

• 如果需要拦截的原生方法较多，可以直接用Proxy对MyHealthLibrary做统一代理，不需要手动逐个透传方法，核心逻辑不变：所有参数转换必须发生在JS层向原生桥接层传参之前，绝对不能依赖给原生代理对象挂载自定义属性实现自动转换。

内容的提问来源于stack exchange，提问作者grooot