React Native 雖然能寫出跨平台的介面,但難免會遇到必須跳到原生 Activity 的時刻——例如開啟系統相簿、播放器的設定頁,或是既有的老舊原生畫面。做法是把原生的功能包成一個「原生模組」註冊給 RN,JS 端就能像呼叫普通函式一樣使用。
步驟一:打開原生專案
在 IDEA 中開啟 RN 專案下的 ./android/app。第一次開可能會等一會兒,因為 Gradle 需要下載相依套件。
步驟二:建立要跳轉的 Activity
跟寫一般原生 App 沒兩樣,這裡只做一個帶返回按鈕的簡單頁面:
public class TestActivity extends AppCompatActivity {
private Button mBtGoBack;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_test);
mBtGoBack = (Button) findViewById(R.id.bt_go_back);
mBtGoBack.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
finish();
}
});
}
}
步驟三:寫一個繼承 ReactContextBaseJavaModule 的類去接訊息
public class ExampleInterface extends ReactContextBaseJavaModule {
private ReactApplicationContext mRApplicationContext;
public ExampleInterface(ReactApplicationContext reactContext) {
super(reactContext);
mRApplicationContext = reactContext;
}
// RN 就是靠這個名稱找到原生模組
@Override
public String getName() {
return "ExampleInterface";
}
// 必須加上 @ReactMethod,才會被註冊成 JS 可呼叫的函式
@ReactMethod
public void HandlerMessage(String aMessage){
Log.d("lt", "====receive message from RN===" + aMessage);
Intent intent = new Intent(mRApplicationContext, TestActivity.class);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
mRApplicationContext.startActivity(intent);
}
}
這裡有兩個關鍵:getName() 回傳的字串就是 JS 端要用的模組名稱;@ReactMethod 註解則是讓方法被暴露給 JS 的必要條件,少了它,JS 那邊會找不到函式。
步驟四:實作 Package 管理器並註冊進去
public class AnExampleReactPackage implements ReactPackage {
@Override
public List<NativeModule> createNativeModules(ReactApplicationContext reactApplicationContext) {
List<NativeModule> modules = new ArrayList<>();
modules.add(new ExampleInterface(reactApplicationContext));
return modules;
}
@Override
public List<Class<? extends JavaScriptModule>> createJSModules() {
return Collections.emptyList();
}
@Override
public List<ViewManager> createViewManagers(ReactApplicationContext reactApplicationContext) {
return Collections.emptyList();
}
}
步驟五:在 MainApplication 註冊這個 Package
@Override
protected List<ReactPackage> getPackages() {
return Arrays.<ReactPackage>asList(
new MainReactPackage(),
new AnExampleReactPackage()
);
}
這一步最常被遺漏。前面寫得再完整,只要沒把 Package 加進 getPackages(),JS 端呼叫時就會收到 undefined。
步驟六:JS 端發送訊息
buttonPress: function(){
NativeModules.ExampleInterface.HandlerMessage('test');
}
記得在檔案頂端引入 NativeModules:import { NativeModules } from 'react-native';。這裡的 ExampleInterface 必須和步驟三的 getName() 完全一致,大小寫也要對得上。
完整串起來看
整個流程是:JS 呼叫 NativeModules.ExampleInterface.HandlerMessage() → RN 橋樑找到對應的原生模組與方法 → 原生端建立 Intent 並啟動 TestActivity。要回傳結果給 JS,則再補一個 sendEvent 之類的方法即可,這裡只示範單向的通知與跳轉。
以上就是 JS 介面向原生發送訊息並完成頁面跳轉的完整步驟,之後要擴充更多原生能力,只要重複步驟三到五的循環即可。