React Native（RN）项目构建

基础环境

• Node（>14）
• JDK（jdk11）
• Android 环境或者 iOS 环境
• npm 、yarn
• 设置镜像，但是不要 使用 cnpm 命令，它会导致package 不识别路径。

以RN为主体创建 react-native 工程

• 创建 RN 工程 ：
  npx react-native init RNproject
• 可能会创建失败，这时创建RN 脚手架
  npm install -g react-native-cli
  • 然后创建项目
    react-native init RNproject
  • 这时可能会报错 cli.init is not a function
    执行： yarn add react-native --exact, 再看react-native 版本（react-native -v）,变成最新版本了。
  • 然后再执行：react-native init RNProject
• 打开模拟器，或者连接真机，cd 到你创建的项目 RNProject 里，
  执行 yarn android 或者 yarn react-native run-android ， 会打开另一个命令窗口运行metro。（有两个窗口同时运行）
• 等待一段时间（十分钟以上，网络不好的 半小时起）

以原生为主体创建 react-native 插件(bundle文件形式)

ReactNative 工程配置

• 创建空文件夹 androidRN
• 创建 package.json 文件

{
  "name": "MyReactNativeApp",
  "version": "0.0.1",
  "private": true,
  "scripts": {
    "start": "yarn react-native start"
  }
}

• 在 androidRN 目录下执行：
  yarn add react-native
• 等待一段时间（10分钟，网速慢20分钟）
• 再执行 yarn add react
• 创建 index.js文件

import React from 'react';
import {
  AppRegistry,
  StyleSheet,
  Text,
  View
} from 'react-native';

class HelloWorld extends React.Component {
  render () {
    return (
      <View style={styles.container}>
        <Text style={styles.hello}>Hello, World</Text>
      </View>
    );
  }
}
var styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center'
  },
  hello: {
    fontSize: 20,
    textAlign: 'center',
    margin: 10
  }
});

AppRegistry.registerComponent(
  'MyReactNativeApp',
  () => HelloWorld
);

• 生成bundle 文件，若没有assets 文件夹， 需要创建一个。
  npx react-native bundle --platform android --dev false --entry-file index.js --bundle-output android/app/src/main/assets/index.android.bundle --assets-dest android/app/src/main/res/

现有项目配置

• 把生成的bundle 文件 放入已有项目的assts 文件夹下。
• 在现有的 Android 项目里添加依赖

    implementation "com.facebook.react:react-native:+" // From node_modules
    implementation "org.webkit:android-jsc:+"

• 在 setting.gradle 文件中添加 【1】

       maven {
            // All of React Native (JS, Android binaries) is installed from npm
            url "D:/WORKING/ZHG/RN-example/androidRN/node_modules/react-native/android"
        }
        maven {
            // Android JSC is installed from npm
            url("D:/WORKING/ZHG/RN-example/androidRN/node_modules/jsc-android/dist")
        }

• 或者 把现有的项目移入 androidRN 目录下的 android 中， 在 setting.gradle 文件中添加 【2】

         maven {
            // All of React Native (JS, Android binaries) is installed from npm
            url "$rootDir/../node_modules/react-native/android"
        }
        maven {
            // Android JSC is installed from npm
            url("$rootDir/../node_modules/jsc-android/dist")
        }

• 注意必须设置【1】或者【2】，不然项目运行不起来
• 然后再创建一个 ReactActivity

class MyRNActivity : Activity(), DefaultHardwareBackBtnHandler {

    private var mReactRootView: ReactRootView? = null
    private var mReactInstanceManager: ReactInstanceManager? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        SoLoader.init(this, false)
        mReactRootView = ReactRootView(this)
//        val packages: List<ReactPackage> = PackageList(application).getPackages()
        // 有一些第三方可能不能自动链接，对于这些包我们可以用下面的方式手动添加进来：
        // packages.add(new MyReactNativePackage());
        // 同时需要手动把他们添加到`settings.gradle`和 `app/build.gradle`配置文件中。


        mReactInstanceManager = ReactInstanceManager.builder()
            .setApplication(application)
            .setCurrentActivity(this)
            .setBundleAssetName("index.android.bundle")
            .setJSMainModulePath("index")
            .addPackage(MainReactPackage())
            .setUseDeveloperSupport(BuildConfig.DEBUG)
            .setInitialLifecycleState(LifecycleState.RESUMED)
            .build()
        // 注意这里的MyReactNativeApp 必须对应"index.js"中的
        // "AppRegistry.registerComponent()"的第一个参数
        mReactRootView!!.startReactApplication(mReactInstanceManager, "MyReactNativeApp", null)
        setContentView(mReactRootView)
    }

    override fun invokeDefaultOnBackPressed() {
        super.onBackPressed()
    }
}

• 启动项目

若想联机调试需要如下操作

• 在setting.gradle 末尾添加
  apply from: file("../node_modules/@react-native-community/cli-platform-android/native_modules.gradle"); applyNativeModulesSettingsGradle(settings)
• 在 app/build.gradle 末尾添加：
  apply from: file("../../node_modules/@react-native-community/cli-platform-android/native_modules.gradle"); applyNativeModulesAppBuildGradle(project)
• 在 AndroidManifest.xml中 application 标签内添加android:usesCleartextTraffic="true"

从 Android 9 (API level 28)开始，默认情况下明文传输（http 接口）是禁用的，只能访问 https 接口。 this prevents your application from connecting to the [Metro bundler][metro]. The changes below allow cleartext traffic in debug builds.

• 先在项目根目录运行：yarn start 启动 Metro（不要关闭metro 窗口）
• 再在AS 启动项目，就可以看到rn 的画面了。

Demo

• 以RN为主体创建react-native 项目
• 以原生为主体创建 react-native 插件