React Native組件集成到Android原生項目

作者：佚名 2018-06-13 16:38:33

為了把 React Native 集成到 Android 原生項目中，踩了很多坑，因為作為web前端開發，本來就不熟悉安卓，參考了網上很多文章，但是都很舊了，而 React Native 已經升級到了 0.55 版本了，入口文件已經合成了一個 index.js，下面的內容也是基于這個版本實踐的。

環境搭建

已經搭建好 React Native 環境的可以跳過，還沒有的可以參考 React Native 中文網的搭建教程，比較詳細。

創建Android原生項目

安卓開發者自然很熟悉這個步驟，然而對于web前端開發者還是比較迷茫的。可以參考一下使用Android Studio創建一個新的Android工程，創建一個 Empty Activity，接下來會比較好操作。

[[232848]]

集成React Native

步驟一：安裝相關依賴

在項目根目錄下執行 npm init 命令，生成 package.json 文件，添加以下命令

"scripts": { 
    "start": "node node_modules/react-native/local-cli/cli.js start" 
}

執行 npm i react react-native -S 安裝 react 和 react-native

步驟二：配置maven

在你的 app/ 目錄下的 build.gradle 文件中的 dependencies 里添加 React Native 依賴:

dependencies { 
    ... 
    compile "com.facebook.react:react-native:+" 
}

在項目根目錄下的 build.gradle 文件中為 React Native 添加一個 maven 依賴的入口，必須寫在 “allprojects” 代碼塊中:

allprojects { 
    repositories { 
        ... 
        maven { 
            url "$rootDir/node_modules/react-native/android" 
        } 
    } 
}

步驟三：代碼集成，創建我們的 react-native 組件，在根目錄下創建 index.js，（在 react-native 0.49.0版本以前，是 index.android.js 和 index.ios.js 作為入口文件，現在合成一個 index.js 文件了）

import React, {Component} from 'react'; 
import {AppRegistry,View,Text} from 'react-native'; 
class App extends Component{ 
    render(){ 
        return ( 
            <View> 
                <Text>哈哈哈</Text> 
            </View> 
        ) 
    } 
} 
AppRegistry.registerComponent('ReactNativeView', () => App);

然后創建 MyReactActivity，Activity 是安卓中基本的頁面單元，簡單的說，可以看做 web 開發中的一個 html 頁面。

在上面創建安卓項目的時候，已經創建了一個 MainActivity，在它的同級目錄下，在 Android Studio右鍵新建一個 Activity，命名為 MyReactActivity，然后把內容改為如下：

package com.example.administrator.androidreactnative; 
import javax.annotation.Nullable; 
import com.facebook.react.ReactActivity; 
public class MyReactActivity extends ReactActivity { 
    @Nullable 
    @Override 
    protected String getMainComponentName() { 
        return "ReactNativeView"; 
    } 
}

接著創建 MainApplication

package com.example.administrator.androidreactnative; 
import android.app.Application; 
import com.facebook.react.ReactApplication; 
import com.facebook.react.ReactNativeHost; 
import com.facebook.react.ReactPackage; 
import com.facebook.react.shell.MainReactPackage; 
import com.facebook.soloader.SoLoader; 
import java.util.Arrays; 
import java.util.List; 
public class MainApplication extends Application implements ReactApplication { 
    private final ReactNativeHost mReactNativeHost = new ReactNativeHost(this) { 
        @Override 
        public boolean getUseDeveloperSupport() { 
            return BuildConfig.DEBUG; 
        } 
        @Override 
        protected List<ReactPackage> getPackages() { 
            return Arrays.<ReactPackage>asList( 
                new MainReactPackage() 
            ); 
        } 
    }; 
    @Override 
    public ReactNativeHost getReactNativeHost() { 
        return mReactNativeHost; 
    } 
    @Override 
    public void onCreate() { 
        super.onCreate(); 
        SoLoader.init(this,false); 
    } 
}

***在 app/src/main/AndroidManifest.xml 文件中，添加一些權限，以及聲明MainApplication 跟 MyReactActivity

<?xml version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
    package="com.example.administrator.androidreactnative"> 
    <uses-permission android:name="android.permission.INTERNET"/>   <!-- 網絡權限 --> 
    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/> <!-- 彈框權限 --> 
    <uses-permission android:name="android.permission.SYSTEM_OVERLAY_WINDOW"/> <!-- 窗體覆蓋權限 --> 
    <!-- 聲明MainApplication --> 
    <application 
        android:name=".MainApplication" 
        android:allowBackup="true" 
        android:icon="@mipmap/ic_launcher" 
        android:label="@string/app_name" 
        android:roundIcon="@mipmap/ic_launcher_round" 
        android:supportsRtl="true" 
        android:theme="@style/AppTheme"> 
        <activity android:name=".MainActivity"> 
            <intent-filter> 
                <action android:name="android.intent.action.MAIN" /> 
                <category android:name="android.intent.category.LAUNCHER" /> 
            </intent-filter> 
        </activity> 
        <!-- 聲明MyReactActivity --> 
        <activity 
            android:name=".MyReactActivity" 
            android:label="@string/app_name" 
            android:theme="@style/AppTheme"> 
        </activity> 
        <!-- 聲明可以通過晃動手機或者點擊Menu菜單打開相關的調試頁面 --> 
        <activity android:name="com.facebook.react.devsupport.DevSettingsActivity"/> 
    </application> 
</manifest>

原生頁面跳轉到react-native頁面

在 MainActivity 添加一個按鈕跳轉到 MyReactActivity，首先在 app/src/main/res/layout 下的 activity_main.xml 添加一個按鈕元素

<Button 
    android:id="@+id/btn" 
    android:layout_width="wrap_content" 
    android:layout_height="wrap_content" 
    android:text="點擊跳轉到RN界面"/>

然后在 MainActivity 里添加點擊跳轉事件

package com.example.administrator.androidreactnative; 
import android.support.v7.app.AppCompatActivity; 
import android.content.Intent; 
import android.os.Bundle; 
import android.view.View; 
public class MainActivity extends AppCompatActivity { 
    @Override 
    protected void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.activity_main); 
        // 點擊按鈕跳轉到 react-native 頁面 
        findViewById(R.id.btn).setOnClickListener(new View.OnClickListener() { 
            @Override 
            public void onClick(View view) { 
                startActivity(new Intent(MainActivity.this,MyReactActivity.class)); 
            } 
        }); 
    } 
}

然后在Android Studio 的模擬器中打開就可以看到以下頁面：

同時執行 npm start 啟動本地服務器，點擊按鈕，出現了紅屏，也就是錯誤頁面。

從錯誤信息 error: bundling failed: NotFoundError: Cannot find entry file index.android.js in any of the roots 我們可以看出找不到入口文件index.android.js，而我們的入口文件是 index.js，因此我們需要另外加一些配置讓它知道我們的入口文件其實是 index.js

解決方法參考 react-native/issues/16517。在 app/ 目錄下的 build.gradle 文件中最上面添加

apply plugin: 'com.android.application' // 這時原來存在的 
apply from: "../node_modules/react-native/react.gradle" 
project.ext.react = [ 
    entryFile: "index.js" 
]

然后在 MainApplication 的 ReactNativeHost 類中添加：

private final ReactNativeHost mReactNativeHost = new ReactNativeHost(this) { 
    ... 
    // 這是需要添加的 
    @Override 
    protected String getJSMainModuleName() { 
        return "index"; 
    } 
}

重新在模擬器中運行，就可以正常跳轉到 react-native 的頁面了。

【本文為51CTO專欄作者“林鑫”的原創稿件，轉載請通過微信公眾號聯系作者獲取授權】

戳這里，看該作者更多好文

責任編輯：武曉燕來源： 51CTO專欄

React Native 組件 Android