DIV CSS 佈局教程網

React Native 與原生 Android 雙向通訊:JS 發訊號並跳轉原生頁面
編輯:關於JavaScript     

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 介面向原生發送訊息並完成頁面跳轉的完整步驟,之後要擴充更多原生能力,只要重複步驟三到五的循環即可。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved