如何为React Native应用添加Web构建能力

1. 安装核心依赖 #

先安装支持Web构建的必要包：

npm install react-native-web react-dom @babel/preset-react --save

如果用Yarn：

yarn add react-native-web react-dom @babel/preset-react

2. 配置Babel #

修改根目录babel.config.js，添加React预设并配置模块别名，让Web环境优先使用react-native-web：

module.exports = {
  presets: [
    'module:metro-react-native-babel-preset',
    '@babel/preset-react'
  ],
  plugins: [
    [
      'module-resolver',
      {
        extensions: ['.web.js', '.js', '.json', '.web.ts', '.ts', '.web.tsx', '.tsx'],
        alias: {
          'react-native$': 'react-native-web'
        }
      }
    ]
  ]
};

3. 添加Web入口文件 #

在项目根目录创建index.web.js作为Web端入口：

import React from 'react';
import { AppRegistry } from 'react-native-web';
import App from './App';
import { name as appName } from './app.json';

AppRegistry.registerComponent(appName, () => App);
AppRegistry.runApplication(appName, {
  rootTag: document.getElementById('root'),
});

同时创建public/index.html作为Web页面模板：

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>dotmac Web</title>
    <style>
      body { margin: 0; }
      #root { height: 100vh; }
    </style>
  </head>
  <body>
    <div id="root"></div>
  </body>
</html>

4. 配置Webpack（手动构建方案） #

如果不使用Expo，需配置Webpack打包Web代码。先安装Webpack相关依赖：

npm install webpack webpack-cli webpack-dev-server html-webpack-plugin babel-loader style-loader css-loader --save-dev

然后在根目录创建webpack.config.js：

const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
  entry: './index.web.js',
  output: {
    path: path.resolve(__dirname, 'web-build'),
    filename: 'bundle.js',
  },
  resolve: {
    extensions: ['.web.js', '.js', '.json', '.web.ts', '.ts', '.web.tsx', '.tsx'],
    alias: {
      'react-native$': 'react-native-web',
    },
  },
  module: {
    rules: [
      {
        test: /\.(js|jsx|ts|tsx)$/,
        exclude: /node_modules/,
        use: 'babel-loader',
      },
      {
        test: /\.css$/,
        use: ['style-loader', 'css-loader'],
      },
      {
        test: /\.(png|svg|jpg|jpeg|gif)$/i,
        type: 'asset/resource',
      },
    ],
  },
  plugins: [
    new HtmlWebpackPlugin({
      template: './public/index.html',
    }),
  ],
  devServer: {
    static: {
      directory: path.join(__dirname, 'public'),
    },
    compress: true,
    port: 3000,
    hot: true,
  },
};

5. 更新npm脚本 #

在package.json的scripts中添加Web开发和构建命令：

"web": "webpack serve --mode development",
"build:web": "webpack --mode production"

6. 处理原生依赖兼容性 #

你的项目中部分依赖仅支持原生平台，需针对Web端做兼容：

• flutterwave-react-native：替换为Flutterwave官方Web SDK
• react-native-onesignal：使用OneSignal Web SDK实现推送功能
• react-native-paystack-webview：切换为Paystack Web支付集成方案
• Zoho相关SDK：检查是否有对应Web版本，若无则需在Web端实现替代逻辑

可通过Platform.OS区分平台做条件渲染：

import { Platform } from 'react-native';

const PaymentComponent = () => {
  if (Platform.OS === 'web') {
    return <WebPaystackComponent />; // 自定义Web支付组件
  }
  return <NativePaystackComponent />; // 原生支付组件
};

7. 测试构建 #

执行npm run web启动Web开发服务器，访问http://localhost:3000查看效果；执行npm run build:web生成生产环境构建文件，产物会放在web-build目录下。

内容的提问来源于stack exchange，提问作者Sheriff Dean