开发时如何通过终端控制Android应用加载mock数据（React Native）

针对React Native Android端无法像控制台应用那样用命令行参数控制mock数据加载的问题，我整理了几个实用的终端可控方案，你可以根据场景选择：

方案一：使用Android系统属性（推荐，运行时灵活切换） #

Android系统支持通过adb设置临时系统属性，我们可以利用这一点在终端控制应用行为，无需修改构建流程或重启应用。

步骤1：终端设置系统属性 #

在终端执行以下命令来启用/禁用mock数据：

# 启用mock数据
adb shell setprop debug.mock_data_enabled true

# 禁用mock数据
adb shell setprop debug.mock_data_enabled false

注意：系统属性是临时的，设备重启后会恢复默认值，调试时可以把这两个命令存成脚本快速调用。

步骤2：在React Native中读取属性 #

我们需要写一个简单的原生模块来读取系统属性，然后在JS层调用：

1. 创建原生模块文件 android/app/src/main/java/com/yourapp/MockDataModule.java：

package com.yourapp;

import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.bridge.ReactContextBaseJavaModule;
import com.facebook.react.bridge.ReactMethod;

public class MockDataModule extends ReactContextBaseJavaModule {
    public MockDataModule(ReactApplicationContext reactContext) {
        super(reactContext);
    }

    @Override
    public String getName() {
        return "MockDataModule"; // JS层调用的模块名
    }

    @ReactMethod
    public boolean isMockDataEnabled() {
        // 读取系统属性，默认返回false
        return android.os.SystemProperties.getBoolean("debug.mock_data_enabled", false);
    }
}

2. 在MainApplication.java中注册这个模块：

// 导入必要的类
import com.yourapp.MockDataModule;
import java.util.List;

public class MainApplication extends Application implements ReactApplication {
    // ... 其他原有代码

    @Override
    protected List<ReactPackage> getPackages() {
        List<ReactPackage> packages = new PackageList(this).getPackages();
        // 添加自定义模块
        packages.add(new ReactPackage() {
            @Override
            public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
                return List.of(new MockDataModule(reactContext));
            }

            @Override
            public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
                return List.of();
            }
        });
        return packages;
    }
}

3. 在JS层使用：

import { NativeModules } from 'react-native';

const { MockDataModule } = NativeModules;

// 在API客户端初始化时判断
async function initAPIClient() {
    const useMockData = await MockDataModule.isMockDataEnabled();
    if (useMockData) {
        console.log('✅ 启用Mock数据模式');
        // 配置使用mock数据的API逻辑
    } else {
        console.log('🔴 使用真实API服务');
        // 配置生产环境API逻辑
    }
}

initAPIClient();

方案二：通过Gradle构建参数控制（编译时确定） #

如果你的调试场景不需要频繁切换，而是希望在编译时就确定是否加载mock数据，可以用Gradle参数生成BuildConfig字段。

步骤1：修改app/build.gradle #

在android > buildTypes > debug节点下添加BuildConfig字段：

android {
    buildTypes {
        debug {
            // 读取Gradle参数，默认关闭mock
            buildConfigField "boolean", "USE_MOCK_DATA", project.hasProperty('useMockData') ? project.property('useMockData') : "false"
        }
    }
}

步骤2：终端编译时传递参数 #

执行编译命令时加上参数：

# 编译启用mock的debug包
./gradlew assembleDebug -PuseMockData=true

# 编译禁用mock的debug包（可不加参数，默认false）
./gradlew assembleDebug

步骤3：在React Native中读取BuildConfig #

同样需要通过原生模块暴露给JS：

// 在MockDataModule的isMockDataEnabled方法中修改
@ReactMethod
public boolean isMockDataEnabled() {
    return BuildConfig.USE_MOCK_DATA;
}

JS层的调用和方案一完全一致。

方案三：SharedPreferences + 广播（持久化切换） #

如果希望mock设置在应用重启后依然有效，可以用SharedPreferences存储状态，通过adb发送广播来修改。

步骤1：注册广播接收器 #

创建广播接收器来处理mock开关的修改：

package com.yourapp;

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.SharedPreferences;

public class MockDataReceiver extends BroadcastReceiver {
    private static final String PREF_NAME = "MockSettings";
    private static final String KEY_MOCK_ENABLED = "mock_enabled";

    @Override
    public void onReceive(Context context, Intent intent) {
        boolean enabled = intent.getBooleanExtra("enabled", false);
        SharedPreferences prefs = context.getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE);
        prefs.edit().putBoolean(KEY_MOCK_ENABLED, enabled).apply();
    }

    // 供模块调用的读取方法
    public static boolean isMockEnabled(Context context) {
        SharedPreferences prefs = context.getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE);
        return prefs.getBoolean(KEY_MOCK_ENABLED, false);
    }
}

别忘了在AndroidManifest.xml中注册接收器：

<receiver android:name=".MockDataReceiver" android:exported="true">
    <intent-filter>
        <action android:name="com.yourapp.SET_MOCK_DATA" />
    </intent-filter>
</receiver>

步骤2：终端发送广播修改状态 #

# 启用mock
adb shell am broadcast -a com.yourapp.SET_MOCK_DATA --ez enabled true

# 禁用mock
adb shell am broadcast -a com.yourapp.SET_MOCK_DATA --ez enabled false

步骤3：在React Native中读取状态 #

修改MockDataModule的方法：

@ReactMethod
public boolean isMockDataEnabled() {
    return MockDataReceiver.isMockEnabled(getReactApplicationContext());
}

JS层调用和之前一致。

方案对比 #

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