安卓原生app嵌入React-Native
程序员文章站
2022-06-28 18:22:18
...
本文的记录适合已经按照 React-Native 中文网搭建好环境并且能够成功运行 Hello World 的 React-Native 原生项目的同学。文末会放上 github 的地址。
各种环境的搭建参照 React-Native中文网,环境搭建好后就可以开始了。
1. 打开 AS ,新建一个原生项目,这里项目名为 RNDemo
2.在 AS 终端中输入命令
npm init
接下来按照提示输入对应信息,有的可以不填,如图:
**这里注意,名字不能有大写字母!
初始化完成后就会在项目根目录下生成一个 package.json 文件。打开文件,在 scripts{} 里添加如下部分,用于之后启动 packager:
"start": "node node_modules/react-native/local-cli/cli.js start"
**注意两行之间要有逗号。
文件整体如下:
{
"name": "rnapp",
"version": "1.0.0",
"description": "This is my first RN-App!",
"main": "index.android.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1",
"start": "node node_modules/react-native/local-cli/cli.js start"
},
"author": "yq",
"license": "ISC"
}
2. 终端输入命令:
npm install --save react react-native
有一个等待的过程,完成后会在项目根目录下生成一个 node_modules 文件夹,文件夹里的内容就是执行命令所下载的,如图所示:
但是终端会有一些警告,如图:
按照提示安装对应版本,命令如下:
npm install --save aaa@qq.com aaa@qq.com
3. 在项目根目录 build.gradle 文件的 allprojects{} (注意是:allprojects 里)添加如下地址:
maven{
url "$rootDir/node_modules/react-native/android"
}
添加完后是这样的:
allprojects {
repositories {
jcenter()
maven{
url "$rootDir/node_modules/react-native/android"
}
}
}
然后在 app 目录下的 build.gradle 里添加依赖:
compile 'com.facebook.react:react-native:+'
同步项目,会报如下的错误:
Error:Conflict with dependency 'com.google.code.findbugs:jsr305' in project ':app'. Resolved versions for app (3.0.0) and test app (2.0.1) differ. See http://g.co/androidstudio/app-test-app-conflict for details.
在 app/bulid.gradle 文件的 android{} 模块里添加
configurations.all {
//for Error:Conflict with dependency 'com.google.code.findbugs:jsr305'
resolutionStrategy.force 'com.google.code.findbugs:jsr305:1.3.9'
}
同步项目,上面的问题解决了,但是又有新的错误,如下:
Manifest merger failed : uses-sdk:minSdkVersion 15 cannot be smaller than version 16 declared in library [com.facebook.react:react-native:0.47.2]
C:\Users\yinqi.android\build-cache\1db15acba046d1d8bc220e7717d1e2ffd328aad6\output\AndroidManifest.xml
这个还是能看的明白的,最低版本不能低于16,那我们就修改最低支持版本为16,修改后在同步项目 ok 了。
解决了错误,还要确认下下载到的 react-native 依赖包的版本是否是 0.47.2,如果不是 0.47.2 而是0.20.1,说明上面的 maven 地址配置的可能有问题。
3. 在项目根目录下新建 index.android.js (这里的文件名要和第一步输入的那个package name 对应的名字一样)文件,加入如下代码:
'use strict';
import React, { Component } from 'react';
import {
AppRegistry,
StyleSheet,
Text,
View
} from 'react-native';
//hello world 对应代码
class HelloWorld extends React.Component {
render() {
return (
<View style={styles.container}>
<Text style={styles.hello}>Hello, World!\nThis is my first rnApp!</Text>
</View>
)
}
}
var styles = StyleSheet.create({
container: {
flex: 1,
justifyContent: 'center',
},
hello: {
fontSize: 20,
color:'red',
textAlign: 'center',
margin: 10,
},
});
//这里的 rnapp 可以和项目的名字不一样
AppRegistry.registerComponent('rnapp', () => HelloWorld);
4. 新建用于加载 index.android.js 的 Activity,要实现 DefaultHardwareBackBtnHandler 接口,代码如下:
package com.yq.rndemo;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.KeyEvent;
import com.facebook.react.ReactInstanceManager;
import com.facebook.react.ReactRootView;
import com.facebook.react.common.LifecycleState;
import com.facebook.react.modules.core.DefaultHardwareBackBtnHandler;
import com.facebook.react.shell.MainReactPackage;
public class RNActivity extends AppCompatActivity implements DefaultHardwareBackBtnHandler {
private ReactRootView mReactRootView;
private ReactInstanceManager mReactInstanceManager;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
mReactRootView = new ReactRootView(this);
mReactInstanceManager = ReactInstanceManager.builder()
.setApplication(getApplication())
.setBundleAssetName("index.android.bundle")//bundle 的名字
.setJSMainModuleName("index.android")//js 文件的名字
.addPackage(new MainReactPackage())
.setUseDeveloperSupport(true)//开发者模式
.setInitialLifecycleState(LifecycleState.RESUMED)
.build();
mReactRootView.startReactApplication(mReactInstanceManager, "rnapp", null);
setContentView(mReactRootView);
}
@Override
public void invokeDefaultOnBackPressed() {
super.onBackPressed();
}
@Override
protected void onPause() {
super.onPause();
if (mReactInstanceManager != null) {
mReactInstanceManager.onHostPause(this);
}
}
@Override
protected void onResume() {
super.onResume();
if (mReactInstanceManager != null) {
mReactInstanceManager.onHostResume(this, this);
}
}
@Override
protected void onDestroy() {
super.onDestroy();
if (mReactInstanceManager != null) {
mReactInstanceManager.onHostDestroy(this);
}
}
@Override
public void onBackPressed() {
// if (mReactInstanceManager != null) {
// mReactInstanceManager.onBackPressed();
// } else {
// }
super.onBackPressed();
}
@Override
public boolean onKeyUp(int keyCode, KeyEvent event) {
if (keyCode == KeyEvent.KEYCODE_MENU && mReactInstanceManager != null) {
mReactInstanceManager.showDevOptionsDialog();
return true;
}
return super.onKeyUp(keyCode, event);
}
}
5. 添加权限并注册 RN 的设置界面, manifest文件如下:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.yq.rndemo">
<uses-permission android:name="android.permission.INTERNET" />
<!--悬浮窗-->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<application
android:name=".RNApplication"
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
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>
<activity
android:name=".RNActivity"
android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
<!-- React-Native 设置界面-->
<activity android:name="com.facebook.react.devsupport.DevSettingsActivity" />
</application>
最后在 MainActivity 中加入跳转到 RNActivity 的按钮,原生项目嵌入 React-Native 就完成了,接下来就是运行项目看是否能成功。
5.首先启动 package server ,命令如下:
npm start
看到 Loading dependency graph, done. 就是启动成功了。
然后安装 app 到手机,命令如下:
gradlew installDebug
运行 app 跳转到 RNActivity 界面,有时候可能不会显示,这时候就要配置调试端口再 Reload了,直接 Reload 会提示:
端口配置步骤如下:
手机菜单(Menu)按键 –> Dev Setting –> Debugging 下的 Debug server host & port for device,点击输入 192.168.1.xxx:8081 就可以了。
** 注:手机要和电脑在同一局域网下。
这时候返回点击手机菜单键再次 Reload 就可以了;如果不行,返回重新进入页面。
6.另外需要注意的两点
(1)调试需要悬浮窗权限,如果 app target设置为 23 以上,手机系统版本为 6.0 以上并且没有动态申请权限的话,一定要记得手动开启悬浮窗权限;
(2)在调试过程中 packger 必须要保证运行状态,否则进行 Reload 操作的时候会报错误,如图:
补充:加载 index.android.js 的 Activity 的另一种写法:
1. 继承 ReactActivity ,重写 getMainComponentName 方法,返回值为 js 文件中注册的名字(demo 中为 ‘rnapp’),代码如下:
package com.yq.rndemo;
import com.facebook.react.ReactActivity;
public class MyReactActivity extends ReactActivity {
@Override
protected String getMainComponentName() {
return "rnapp";
}
}
(2) 自定义 Application 类,实现 ReactApplication 接口(上面那种方法不需要),否则会报错:
java.lang.RuntimeException: Unable to start activity ComponentInfo{com.yq.rndemo/com.yq.rndemo.MyReactActivity}: java.lang.ClassCastException: android.app.Application cannot be cast to com.facebook.react.ReactApplication
具体代码如下:
package com.yq.rndemo;
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;
/**
* Created by yinqi on 2017/8/31.
*/
public class RNApplication 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, /* native exopackage */ false);
}
}
(3)不要忘了在 manifest 中注册:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.yq.rndemo">
<uses-permission android:name="android.permission.INTERNET" />
<!--悬浮窗-->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
<!--继承 ReactActivity 注意:实际在 manifest 中这一行要删除,否则报错-->
android:name=".RNApplication"
android:label="@string/app_name"
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>
<!--实现 DefaultHardwareBackBtnHandler 接口-->
<activity
android:name=".RNActivity"
android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
<!--继承 ReactActivity-->
<activity
android:name=".MyReactActivity"
android:theme="@style/Theme.AppCompat.Light.NoActionBar"></activity>
<!-- React-Native 设置界面-->
<activity android:name="com.facebook.react.devsupport.DevSettingsActivity" />
</application>
</manifest>
最后,打正式包:
首次在 app/src/main 目录下新建 assets 文件夹,然后终端在项目根目录下执行命令:
react-native bundle --platform android --dev false --entry-file index.android.js --bundle-output app/src/main/assets/index.android.bundle --assets-dest app/src/main/res/
以上过程是我一边操作一边记录下来的,尽可能地详细说明了步骤,过程中肯定会遇到其他问题,这就需要耐心慢慢解决了。如果有说的不对的地方,请指正!
GitHub Demo,node-modules文件夹由于过大没有上传,请自行下载
推荐阅读