如何针对React Native特定构建版本排除指定测试类库

一、Android 端配置（基于 Flavours + BuildTypes） #

1. 精准控制依赖引入 #

在 app/build.gradle 中，仅为测试相关的变体引入测试库，避免生产构建包含该依赖：

android {
    flavorDimensions "environment"
    productFlavors {
        dev { dimension "environment" }
        testing { dimension "environment" }
        prod { dimension "environment" }
    }
    buildTypes {
        debug {}
        release {}
    }
}

dependencies {
    // 仅在 testing 风味的所有构建类型下引入测试库
    testingImplementation project(':my-library-name')
    // 若需更精准，可指定仅 testingRelease 构建引入
    // testingReleaseImplementation project(':my-library-name')
}

2. 修复 React Native 自动链接配置（解决「Library not found」错误） #

之前的 react-native.config.js 仅指定单个 buildType，无法覆盖所有测试变体。改用 variantFilter 匹配所有含 testing 的变体：

module.exports = {
  dependencies: {
    'my-library-name': {
      platforms: {
        android: {
          variantFilter: (variant) => {
            // 仅在包含「testing」的变体中链接库
            return variant.name.includes('testing');
          },
        },
      },
    },
  },
};

3. JS 层代码隔离 #

确保生产环境下完全不引用测试库，可结合环境变量与 Metro 配置排除测试代码：

// 仅在非生产环境初始化测试库
if (process.env.ENVIRONMENT !== 'production') {
  import('my-library-name').then((lib) => {
    lib.initTestSession();
  });
}

在 metro.config.js 中排除测试目录（生产构建时生效）：

const { getDefaultConfig, mergeConfig } = require('@react-native/metro-config');

const baseConfig = getDefaultConfig(__dirname);
const customConfig = {};

if (process.env.ENVIRONMENT === 'production') {
  customConfig.resolver = {
    blacklistRE: /src\/testing\/.*/,
  };
}

module.exports = mergeConfig(baseConfig, customConfig);

二、iOS 端配置（基于 Schema + Configurations） #

1. 通过 CocoaPods 控制依赖范围 #

在 Podfile 中指定测试库仅在测试相关配置下安装：

target 'YourApp' do
  # 基础 React Native 依赖
  pod 'React', :path => '../node_modules/react-native'
  # ...其他核心依赖

  # 仅在 Testing 配置下引入测试库（需与 Xcode 中配置名称一致）
  pod 'my-library-name', :path => '../node_modules/my-library-name', :configurations => ['Testing Debug', 'Testing Release']
end

执行 pod install 使配置生效。

2. 修正 React Native 自动链接的配置 #

确保 react-native.config.js 中的 iOS 配置与 Xcode 实际配置名称匹配：

module.exports = {
  dependencies: {
    'my-library-name': {
      platforms: {
        ios: {
          configurations: ['Testing Debug', 'Testing Release'],
        },
      },
    },
  },
};

3. Xcode 手动辅助配置（可选） #

打开 Xcode 项目，进入测试库的 Target → Build Phases → Link Binary With Libraries，点击库名旁的箭头，取消勾选 Production 相关配置，确保仅测试配置链接该库。

4. JS 层代码隔离 #

与 Android 逻辑一致，通过环境变量判断引入测试库，并在 Metro 配置中排除测试代码，避免生产打包包含相关逻辑。

三、额外优化技巧 #

• 环境变量统一驱动：打包时通过 ENVIRONMENT=production 或 ENVIRONMENT=testing 触发各工具链的配置切换，确保构建一致性。
• Android SourceSets 隔离：在 app/build.gradle 中为 prod 风味排除测试代码目录：

android {
    productFlavors {
        prod {
            sourceSets {
                main {
                    java.srcDirs -= ['src/testing/java']
                }
            }
        }
    }
}

• iOS 排除测试文件：在 Xcode 的 Production 配置 → Build Settings → Excluded Source Files 中添加测试相关文件路径，彻底从编译中排除。

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