RN 原生模块（Native Module）

只要 RN 没有封装某个平台能力，或者某段计算放在 JS 线程上会卡住交互，就该落到原生模块；判断标准是「需不需要平台 API」和「要不要离开 JS 线程」。

原生模块官方定位：

有时候 App 需要访问平台 API，但在 React Native 可能还没有相应的模块。或者你需要复用一些 Java 代码，而不想用 JavaScript 再重新实现一遍；又或者你需要实现某些高性能的、多线程的代码，譬如图片处理、数据库、或者一些高级扩展。我们把 React Native 设计为可以在其基础上编写真正的原生代码，并且可以访问平台所有的能力。

开发安卓原生模块流程

1. 编写原生模块的相关代码；
2. 暴露接口和数据交互；
3. 注册与导出 RN 原生模块。

下面按这三步走完整流程。

第一步：写模块类

新建 android/app/src/main/java/com/yourapp/DeviceInfoModule.java：

package com.yourapp;

import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.bridge.ReactContextBaseJavaModule;
import com.facebook.react.bridge.ReactMethod;
import com.facebook.react.bridge.Promise;
import com.facebook.react.bridge.WritableMap;
import com.facebook.react.bridge.Arguments;

public class DeviceInfoModule extends ReactContextBaseJavaModule {
    private final ReactApplicationContext context;

    public DeviceInfoModule(ReactApplicationContext ctx) {
        super(ctx);
        this.context = ctx;
    }

    // JS 里通过 NativeModules.DeviceInfo 访问，名字必须固定
    @Override
    public String getName() {
        return "DeviceInfo";
    }

    // 同步方法：JS 调用时立刻返回，不要做耗时操作
    @ReactMethod(isBlockingSynchronousMethod = true)
    public String getAppVersion() {
        try {
            return context.getPackageManager()
                .getPackageInfo(context.getPackageName(), 0).versionName;
        } catch (Exception e) {
            return "unknown";
        }
    }

    // 异步方法：返回 Promise，JS 侧 await 使用
    @ReactMethod
    public void getDeviceInfo(Promise promise) {
        try {
            WritableMap map = Arguments.createMap();
            map.putString("brand", android.os.Build.BRAND);
            map.putString("model", android.os.Build.MODEL);
            map.putInt("sdkInt", android.os.Build.VERSION.SDK_INT);
            promise.resolve(map);
        } catch (Exception e) {
            promise.reject("ERR_DEVICE_INFO", e);
        }
    }
}

三个要点：

• getName() 返回的名字就是 JS 侧 NativeModules.X 的 key，改名等于改接口
• 原生方法必须在原生模块线程执行，不能直接碰 UI；要改 UI 用 UiThreadUtil.runOnUiThread
• 同步方法会阻塞 JS 线程，只适合读常量这类瞬时操作；网络、文件、加解密一律用 Promise

第二步：用 Package 注册模块

package com.yourapp;

import com.facebook.react.ReactPackage;
import com.facebook.react.bridge.NativeModule;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.uimanager.ViewManager;

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

public class DeviceInfoPackage implements ReactPackage {
    @Override
    public List<NativeModule> createNativeModules(ReactApplicationContext ctx) {
        List<NativeModule> modules = new ArrayList<>();
        modules.add(new DeviceInfoModule(ctx));
        return modules;
    }

    @Override
    public List<ViewManager> createViewManagers(ReactApplicationContext ctx) {
        return Collections.emptyList();
    }
}