在该目录下执行:
npm install --save react-native
执行完上述命令之后,你会看到如下警告:
其中,有一条警告npm WARN react-native@0.55.4 requires a peer of react@16.3.1 but none is installed
告诉我们需要安装react@16.3.1
:
npm install --save react@16.3.1
至此,一个不含Android和iOS模块的React Native项目便创建好了。此过程所遇到的更多问题可查阅:React Native与Android 混合开发讲解的视频教程
提示:npm 会在你的目录下创建一个
node_modules
,node_modules
体积很大且是动态生成了,建议将其添加到.gitignore
文件中;
通过react-native init来初始化一个React Native项目
除了上述方式之外,我们也可以通过react-native init
命令来初始化一个React Native项目。
react-native init RNHybrid
上述命令会初始化一个完成的名为RNHybrid的React Native项目,然后我们将里面的android
和ios
目录删除,替换成已存在Android和iOS项目。
2. 添加React Native所需要的依赖
在上文中我们已经创建了个一个React Native项目,接下来我们来看一下如何将这个React Native项目和我们已经存在的Native项目进行融合。
在进行融合之前我们需要将已经存在的Native项目放到我们创建的RNHybrid下,比如:我有一个名为RNHybridAndroid
的Android项目,将其放到RNHybrid目录下:
RNHybrid
├── RNHybridAndroid
├── package.json
├── node_modules
└── .gitignore
第一步:配置maven
接下来我们需要为已经存在的RNHybridAndroid项目添加 React Native依赖,在RNHybrid/RNHybridAndroid/app/build.gradle
文件中添加如下代码:
dependencies {
compile ‘com.android.support:appcompat-v7:23.0.1’
…
compile “com.facebook.react:react-native:+” // From node_modules
}
然后,我们为RNHybridAndroid项目配置使用的本地React Native maven目录,在RNHybrid/RNHybridAndroid/build.gradle
文件中添加如下代码:
allprojects {
repositories {
mavenLocal()
maven {
// All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
url “$rootDir/…/node_modules/react-native/android”
}
…
}
…
}
提示:为确保你配置的目录正确,可以通过在Android Studio中运行Gradle sync 看是否有 “Failed to resolve: com.facebook.react:react-native:0.x.x" 的错误出现,没有错误则说明配置正确,否则说明配置路由有问题。 此过程所遇到的更多问题可查阅:React Native与Android 混合开发讲解的视频教程
第二步:配置权限
接下来我们为APP运行配置所需要的权限:检查你项目中的AndroidManifest.xml
文件中看是否有如下权限:
如果没有,则需要将上述权限添加到AndroidManifest.xml
中。
另外,如果你需要用到RN的
Dev Settings
功能:
则需要在AndroidManifest.xml
文件中添加如下代码:
提示:上述图片就是RN 开发调试弹框中的
Dev Settings
功能,打开该功能会弹出上图的一个界面,这个界面就是DevSettingsActivity。
第三步:指定要ndk需要兼容的架构(重要)
Android不能同时加载多种架构的so库,现在很多Android第三方sdks对abi的支持比较全,可能会包含armeabi, armeabi-v7a,x86, arm64-v8a,x86_64五种abi,如果不加限制直接引用会自动编译出支持5种abi的APK,而Android设备会从这些abi进行中优先选择某一个,比如:arm64-v8a,但如果其他sdk不支持这个架构的abi的话就会出现crash。如下图:
怎么解决呢:
在app/gradle
文件中添加如下代码:
defaultConfig {
…
ndk {
abiFilters “armeabi-v7a”, “x86”
}
}
上述代码的意思是,限制打包的so库只包含armeabi-v7a
与x86
。此过程所遇到的更多问题可查阅:React Native与Android 混合开发讲解的视频教程
可参考:libgnustl_shared.so" is 32-bit instead of 64-bit
3.创建index.js并添加你的React Native代码
通过上述两步,我们已经为RNHybridAndroid项目添加了React Native依赖,接下来我们来开发一些JS代码。
在RNHybrid目录下创建一个index.js
文件并添加如下代码:
import { AppRegistry } from ‘react-native’;
import App from ‘./App’;
AppRegistry.registerComponent(‘App1’, () => App);
上述代码,AppRegistry.registerComponent('App1', () => App);
目的是向React Native注册一个名为App1
的组件,然后我会在第四步给大家介绍如何在Android中加载并显示出这个组件。
另外,在上述代码中我们引用了一个App.js
文件:
import React, { Component } from ‘react’;
import {
Platform,
StyleSheet,
Text,
View
} from ‘react-native’;
type Props = {};
export default class App extends Component {
render() {
return (
this is App
);
}
}
const styles = StyleSheet.create({
container: {
flex: 1,
justifyContent: ‘center’,
alignItems: ‘center’,
backgroundColor: ‘#F5FCFF’,
},
welcome: {
fontSize: 20,
textAlign: ‘center’,
margin: 10,
}
});
这个App.js
文件代表了我们React Native的一个页面,在这个页面中显示了this is App
的文本内容。
以上就是为本次演示所添加的React Native代码,你也可以根据需要添加更多的React Native代码以及组件出来。
4. 为React Native创建一个Activity来作为容器
经过上述3、4步,我们已经为RNHybridAndroid项目添加了React Native依赖,并且创建一些React Native代码和注册了一个名为App1
的组件,接下来我们来学习下如何在RNHybridAndroid项目中使用这个App1
组件。
创建RNPageActivity
首先我们需要创建一个Activity来作为React Native的容器,
public class RNPageActivity 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”)
.setJSMainModulePath(“index”)
.addPackage(new MainReactPackage())
.setUseDeveloperSupport(BuildConfig.DEBUG)
.setInitialLifecycleState(LifecycleState.RESUMED)
.build();
// 这个"App1"名字一定要和我们在index.js中注册的名字保持一致AppRegistry.registerComponent()
mReactRootView.startReactApplication(mReactInstanceManager, “App1”, null);
setContentView(mReactRootView);
}
@Override
public void invokeDefaultOnBackPressed() {
super.onBackPressed();
}
}
参数说明
setBundleAssetName
:打包时放在assets
目录下的JS bundle包的名字,App release之后会从该目录下加载JS bundle;setJSMainModulePath
:JS bundle中主入口的文件名,也就是我们上文中创建的那个index.js
文件;addPackage
:向RN添加Native Moudle,在上述代码中我们添加了new MainReactPackage()
这个是必须的,另外,如果我们创建一些其他的Native Moudle也需要通过addPackage
的方式将其注册到RN中。需要指出的是RN除了这个方法外,也提供了一个addPackages
方法用于批量向RN添加Native Moudle;setUseDeveloperSupport
:设置RN是否开启开发者模式(debugging,reload,dev memu),比如我们常用开发者弹框;setInitialLifecycleState
:通过这个方法来设置RN初始化时所处的生命周期状态,一般设置成LifecycleState.RESUMED
就行,和下文讲的Activity容器的生命周期状态关联;mReactRootView.startReactApplication
:它的第一个参数是mReactInstanceManager
,第二个参数是我们在index.js
中注册的组件的名字,第三个参数接受一个Bundle
来作为RN初始化时传递给JS的初始化数据,它的具体用法我会在**React Android 混合开发讲解的视频教程**中再具体的讲解;
在中AndroidManifest.xml
注册一个RNPageActivity
Android系统要求,每一个要打开的Activity都要在AndroidManifest.xml
中进行注册:
上述代码中我们为
RNPageActivity
添加了一个@style/Theme.AppCompat.Light.NoActionBar
类型的theme,这也是React Native UI组件所要求的主题。
为ReactInstanceManager添加Activity的生命周期回调
一个 ReactInstanceManager可以被多个activities或fragments共享,所以我们需要在Activity的生命周期中回调ReactInstanceManager的对于的方法。
@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
public void onBackPressed() {
if (mReactInstanceManager != null) {
mReactInstanceManager.onBackPressed();
} else {
super.onBackPressed();
}
}
@Override
protected void onDestroy() {
super.onDestroy();
if (mReactInstanceManager != null) {
mReactInstanceManager.onHostDestroy(this);
}
if (mReactRootView != null) {
mReactRootView.unmountReactApplication();
}
}
从上述代码中你会发现有个不属于Activity生命周期中的方法onBackPressed
,添加它的目的主要是为了当用户单击手机的返回键之后将事件传递给JS,如果JS消费了这个事件,Native就不再消费了,如果JS没有消费这个事件那么RN会回调invokeDefaultOnBackPressed
代码。
@Override
public void invokeDefaultOnBackPressed() {
super.onBackPressed();
}
此过程更细致的讲解可查阅:React Native与Android 混合开发讲解的视频教程
添加开发者菜单
在RN中有个很好用的工具开发者菜单,我们平时调试RN应用时对它的使用频率很高,接下来我们来为RNHybridAndroid添加开着菜单。
public boolean onKeyUp(int keyCode, KeyEvent event) {
if (getUseDeveloperSupport()) {
if (keyCode == KeyEvent.KEYCODE_MENU) {//Ctrl + M 打开RN开发者菜单
mReactInstanceManager.showDevOptionsDialog();
return true;
}
}
return super.onKeyUp(keyCode, event);
}
通过上代码即可监听Ctrl + M
来打开RN开发者菜单。
另外,RN也提供了双击R来快速加载JS的功能,通过如下代码即可打开该功能:
public boolean onKeyUp(int keyCode, KeyEvent event) {
if (getUseDeveloperSupport()) {
if (keyCode == KeyEvent.KEYCODE_MENU) {//Ctrl + M 打开RN开发者菜单
mReactInstanceManager.showDevOptionsDialog();
return true;
}
boolean didDoubleTapR = Assertions.assertNotNull(mDoubleTapReloadRecognizer).didDoubleTapR(keyCode, getCurrentFocus());
if (didDoubleTapR) {//双击R 重新加载JS
mReactInstanceManager.getDevSupportManager().handleReloadJS();
return true;
}
}
return super.onKeyUp(keyCode, event);
}
此过程更细致的讲解可查阅:React Native与Android 混合开发讲解的视频教程
使用ReactActivity来作为RN容器
在上述的代码中我们都是通过ReactInstanceManager
来创建和加载JS的,然后重写了Activity的生命周期来对ReactInstanceManager
进行回调,另外,重写了onKeyUp
来启用开发者菜单等功能。
另外,查看RN的源码你会发现在RN sdk中有个叫ReactActivity
的Activity,该Activity是RN官方封装的一个RN容器。另外,在通过react-native init
命令初始化的一个项目中你会发现有个MainActivity
是继承ReactActivity
的,接下来我们就来继承ReactActivity
来封装一个RN容器。
public class ReactPageActivity extends ReactActivity implements IJSBridge{
/**
- Returns the name of the main component registered from JavaScript.
- This is used to schedule rendering of the component.
*/
@Override
protected String getMainComponentName() {
return “App1”;
}
}
另外,我们需要实现一个MainApplication
并添加如下代码:
public class MainApplication extends Application implements ReactApplication {
private final ReactNativeHost mReactNativeHost = new ReactNativeHost(this) {
@Override
public boolean getUseDeveloperSupport() {
return BuildConfig.DEBUG;
}
@Override
protected List getPackages() {
return Arrays.asList(
new MainReactPackage()
);
}
最后
感谢您的阅读,在文末给大家准备一个福利。本人从事Android开发已经有十余年,算是一名资深的移动开发架构师了吧。根据我的观察发现,对于很多初中级Android工程师而言,想要提升技能,往往是自己摸索成长,不成体系的学习效果低效漫长且无助。
所以在此将我十年载,从萌新小白一步步成长为Android移动开发架构师的学习笔记,从Android四大组件到手写实现一个架构设计,我都有一一的对应笔记为你讲解。
当然我也为你们整理好了百度、阿里、腾讯、字节跳动等等互联网超级大厂的历年面试真题集锦。这也是我这些年来养成的习惯,一定要学会把好的东西,归纳整理,然后系统的消化吸收,这样才能极大的提高学习效率和成长进阶。碎片、零散化的东西,我觉得最没有价值的。就好比你给我一张扑克牌,我只会觉得它是一张废纸,但如果你给我一副扑克牌,它便有了它的价值。这和我们收集资料就要收集那些系统化的,是一个道理。
最后,赠与大家一句诗,共勉!
不驰于空想,不骛于虚声。不忘初心,方得始终。
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!
对应笔记为你讲解。
当然我也为你们整理好了百度、阿里、腾讯、字节跳动等等互联网超级大厂的历年面试真题集锦。这也是我这些年来养成的习惯,一定要学会把好的东西,归纳整理,然后系统的消化吸收,这样才能极大的提高学习效率和成长进阶。碎片、零散化的东西,我觉得最没有价值的。就好比你给我一张扑克牌,我只会觉得它是一张废纸,但如果你给我一副扑克牌,它便有了它的价值。这和我们收集资料就要收集那些系统化的,是一个道理。
[外链图片转存中…(img-U8cNamcr-1715590520283)]
最后,赠与大家一句诗,共勉!
不驰于空想,不骛于虚声。不忘初心,方得始终。
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》,点击传送门,即可获取!