@bm-fe/react-native-multi-bundle 1.0.0-beta.0

package/scripts/build-multi-bundle.js

@@ -0,0 +1,483 @@
+#!/usr/bin/env node
+
+/**
+ * 多 Bundle 构建脚本
+ * 使用 React Native CLI 的 bundle 命令分别构建主 bundle 和各个模块 bundle
+ * 
+ * 使用方式：
+ * 1. 作为 npm 包使用：node node_modules/@bm-fe/react-native-multi-bundle/scripts/build-multi-bundle.js <platform> [--env <env>]
+ * 2. 全局安装后：multi-bundle-build <platform> [--env <env>]
+ * 
+ * 参数：
+ * - platform: 'ios' 或 'android'
+ * - --env: 'development' | 'staging' | 'production' (默认: 'production')
+ * 
+ * 环境变量：
+ * - PROJECT_ROOT: 项目根目录（可选，默认从脚本位置推断）
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// 支持从任意项目目录运行
+// 如果作为 npm 包使用，PROJECT_ROOT 应该是调用脚本的项目根目录
+// 如果直接运行，PROJECT_ROOT 是脚本所在目录的父目录
+const PROJECT_ROOT = process.env.PROJECT_ROOT || path.join(__dirname, '..');
+const CONFIG_FILE = path.join(PROJECT_ROOT, 'multi-bundle.config.json');
+const OUTPUT_DIR = path.join(PROJECT_ROOT, 'build/bundles');
+
+/**
+ * ANSI 颜色工具函数
+ */
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m',
+};
+
+function green(text) {
+  return `${colors.green}${text}${colors.reset}`;
+}
+
+function yellow(text) {
+  return `${colors.yellow}${text}${colors.reset}`;
+}
+
+function blue(text) {
+  return `${colors.blue}${text}${colors.reset}`;
+}
+
+function red(text) {
+  return `${colors.red}${text}${colors.reset}`;
+}
+
+function cyan(text) {
+  return `${colors.cyan}${text}${colors.reset}`;
+}
+
+function gray(text) {
+  return `${colors.gray}${text}${colors.reset}`;
+}
+
+function bold(text) {
+  return `${colors.bright}${text}${colors.reset}`;
+}
+
+/**
+ * 格式化文件大小
+ */
+function formatSize(bytes) {
+  if (bytes < 1024) {
+    return `${bytes} B`;
+  } else if (bytes < 1024 * 1024) {
+    return `${(bytes / 1024).toFixed(2)} KB`;
+  } else {
+    return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+  }
+}
+
+/**
+ * 格式化文件路径（相对项目根目录）
+ */
+function formatPath(filePath) {
+  return path.relative(PROJECT_ROOT, filePath).replace(/\\/g, '/');
+}
+
+/**
+ * 格式化时间（毫秒转秒或保持毫秒）
+ */
+function formatDuration(ms) {
+  if (ms < 1000) {
+    return `${ms.toFixed(0)}ms`;
+  } else {
+    return `${(ms / 1000).toFixed(2)}s`;
+  }
+}
+
+/**
+ * 显示构建进度
+ */
+function showProgress(current, total, name) {
+  return `[${cyan(`${current}/${total}`)}] ${bold('Building')} ${cyan(name)}...`;
+}
+
+/**
+ * 获取主 bundle 文件名（根据平台）
+ */
+function getMainBundleFileName(platform) {
+  if (platform === 'ios') {
+    return 'main.jsbundle';
+  } else if (platform === 'android') {
+    return 'index.android.bundle';
+  }
+  throw new Error(`Unsupported platform: ${platform}`);
+}
+
+/**
+ * 获取模块 bundle 文件名（根据平台和模块 ID）
+ */
+function getModuleBundleFileName(moduleId, platform) {
+  if (platform === 'ios') {
+    return `${moduleId}.jsbundle`;
+  } else if (platform === 'android') {
+    return `${moduleId}.bundle`;
+  }
+  throw new Error(`Unsupported platform: ${platform}`);
+}
+
+/**
+ * 读取 multi-bundle.config.json 配置文件
+ * 该配置文件用于：
+ * 1. 定义主 bundle 和模块 bundle 的入口文件
+ * 2. 定义模块的版本、依赖关系等元数据
+ * 3. 生成 bundle-manifest.json
+ */
+function loadMultiBundleConfig() {
+  if (!fs.existsSync(CONFIG_FILE)) {
+    throw new Error(`Config file not found: ${CONFIG_FILE}`);
+  }
+  return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+}
+
+/**
+ * 从模块 bundle 中移除 prelude 代码
+ * Prelude 代码从 bundle 开头到第一个 __d( 之前
+ */
+function removePreludeFromBundle(bundlePath) {
+  try {
+    const bundleContent = fs.readFileSync(bundlePath, 'utf-8');
+    const firstModuleDefIndex = bundleContent.indexOf('__d(');
+    
+    if (firstModuleDefIndex > 0) {
+      // 移除 prelude：从开头到第一个 __d( 之前的所有内容
+      const codeWithoutPrelude = bundleContent.substring(firstModuleDefIndex);
+      fs.writeFileSync(bundlePath, codeWithoutPrelude, 'utf-8');
+      console.log(`  ${gray('→')} ${gray('Removed')} ${gray(`${firstModuleDefIndex} characters of prelude`)}`);
+    } else {
+      console.warn(`  ${yellow('⚠')} ${yellow('Warning:')} ${yellow('__d( not found in bundle, prelude not removed')}`);
+    }
+  } catch (error) {
+    console.error(`  ${red('✗')} ${red('Failed to remove prelude:')} ${red(error.message)}`);
+    throw error;
+  }
+}
+
+/**
+ * 确保输出目录存在
+ */
+function ensureOutputDir(platform) {
+  const platformDir = path.join(OUTPUT_DIR, platform);
+  const modulesDir = path.join(platformDir, 'modules');
+  
+  if (!fs.existsSync(platformDir)) {
+    fs.mkdirSync(platformDir, { recursive: true });
+  }
+  if (!fs.existsSync(modulesDir)) {
+    fs.mkdirSync(modulesDir, { recursive: true });
+  }
+  
+  return platformDir;
+}
+
+/**
+ * 构建单个 bundle
+ */
+function buildBundle(entryFile, outputFile, platform, env = 'development', progressInfo = null) {
+  const isProduction = env === 'production';
+  const dev = !isProduction;
+  const startTime = Date.now();
+  
+  // 显示进度信息
+  if (progressInfo) {
+    const { current, total, name } = progressInfo;
+    console.log(showProgress(current, total, name));
+  } else {
+    console.log(`${bold('Building')} ${cyan(formatPath(outputFile))} ${gray(`[${env}]`)}`);
+  }
+  
+  const entry = path.relative(PROJECT_ROOT, entryFile);
+  const out = path.relative(PROJECT_ROOT, outputFile);
+  
+  // ⭐ 关键：判断是否是模块 bundle（通过检查 entry 路径）
+  const isModuleBundle = entry.includes('src/modules/');
+  
+  const commandParts = [
+    // 主 bundle 和模块 bundle 都设置 RN_MULTI_BUNDLE_BUILD，但使用不同的 RN_BUILD_TYPE
+    'RN_MULTI_BUNDLE_BUILD=true',
+    isModuleBundle ? 'RN_BUILD_TYPE=module' : 'RN_BUILD_TYPE=main',
+    'npx react-native bundle',
+    `--entry-file ${entry}`,
+    `--bundle-output ${out}`,
+    `--platform ${platform}`,
+    `--dev ${dev}`,
+    '--reset-cache',
+  ];
+  
+  // 生产环境添加 sourcemap 输出
+  if (isProduction) {
+    const sourcemapOutput = `${out}.map`;
+    commandParts.push(`--sourcemap-output ${sourcemapOutput}`);
+  }
+  
+  const command = commandParts.join(' ');
+  
+  try {
+    execSync(command, {
+      cwd: PROJECT_ROOT,
+      stdio: 'inherit',
+    });
+    
+    const duration = Date.now() - startTime;
+    
+    // 检查文件是否生成
+    if (fs.existsSync(outputFile)) {
+      // ⭐ 如果是模块 bundle，移除 prelude 代码
+      if (isModuleBundle) {
+        removePreludeFromBundle(outputFile);
+      }
+      
+      const stats = fs.statSync(outputFile);
+      const relativePath = formatPath(outputFile);
+      let logMessage = `  ${green('✓')} ${bold(relativePath)} ${gray(`(${formatSize(stats.size)})`)}`;
+      
+      // 检查 sourcemap 是否生成
+      let sourcemapSize = 0;
+      if (isProduction) {
+        const sourcemapFile = `${outputFile}.map`;
+        if (fs.existsSync(sourcemapFile)) {
+          const sourcemapStats = fs.statSync(sourcemapFile);
+          sourcemapSize = sourcemapStats.size;
+          logMessage += ` ${gray(`+ ${formatPath(sourcemapFile)} (${formatSize(sourcemapSize)})`)}`;
+        }
+      }
+      
+      logMessage += ` ${gray(`[${formatDuration(duration)}]`)}`;
+      console.log(logMessage);
+      
+      return {
+        success: true,
+        file: relativePath,
+        size: stats.size,
+        sourcemapSize: sourcemapSize,
+        duration: duration,
+      };
+    } else {
+      throw new Error(`Bundle file not generated: ${outputFile}`);
+    }
+  } catch (error) {
+    const duration = Date.now() - startTime;
+    console.error(`  ${red('✗')} ${red('Failed')} ${formatPath(entryFile)} ${gray(`[${formatDuration(duration)}]`)}`);
+    throw error;
+  }
+}
+
+/**
+ * 生成 manifest
+ * 基于 multi-bundle.config.json 生成 bundle-manifest.json
+ * 
+ * @param {Object} config - 从 multi-bundle.config.json 读取的配置
+ * @param {string} platform - 平台 ('ios' 或 'android')
+ * @returns {Object} 生成的 manifest 对象
+ */
+function generateManifest(config, platform) {
+  // 从 multi-bundle.config.json 读取 formatVersion
+  const mainFileName = getMainBundleFileName(platform);
+  const manifest = {
+    formatVersion: config.formatVersion || 1,
+    main: {
+      // 主 bundle 文件名根据平台自动生成
+      file: mainFileName,
+      // 版本号从 multi-bundle.config.json 读取
+      version: config.main.version,
+    },
+    // 模块列表从 multi-bundle.config.json 读取并转换
+    modules: config.modules.map((module) => ({
+      id: module.id, // 从 multi-bundle.config.json 读取
+      // bundle 文件名根据平台和模块 ID 自动生成
+      file: `modules/${getModuleBundleFileName(module.id, platform)}`,
+      version: module.version, // 从 multi-bundle.config.json 读取
+      dependencies: module.dependencies || [], // 从 multi-bundle.config.json 读取
+      lazy: module.lazy !== false, // 从 multi-bundle.config.json 读取
+    })),
+  };
+
+  const manifestPath = path.join(OUTPUT_DIR, platform, 'bundle-manifest.json');
+  fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+  const relativePath = formatPath(manifestPath);
+  console.log(`  ${green('✓')} ${bold('Generated')} ${cyan(relativePath)} ${gray('(from multi-bundle.config.json)')}`);
+  
+  return manifest;
+}
+
+/**
+ * 打印构建摘要表格
+ */
+function printBuildSummary(results, platform, env, totalDuration) {
+  console.log('\n' + bold('Build Summary'));
+  console.log(gray('─'.repeat(80)));
+  
+  // 表头
+  const header = [
+    'File'.padEnd(35),
+    'Size'.padEnd(12),
+    'Sourcemap'.padEnd(12),
+    'Time'.padEnd(10),
+  ].join(' | ');
+  console.log(bold(header));
+  console.log(gray('─'.repeat(80)));
+  
+  let totalSize = 0;
+  let totalSourcemapSize = 0;
+  
+  // 表格内容
+  for (const result of results) {
+    if (result.success) {
+      const file = result.file.padEnd(35);
+      const size = formatSize(result.size).padEnd(12);
+      const sourcemap = result.sourcemapSize > 0 
+        ? formatSize(result.sourcemapSize).padEnd(12)
+        : gray('-').padEnd(12);
+      const time = formatDuration(result.duration).padEnd(10);
+      
+      console.log(`${file} | ${size} | ${sourcemap} | ${time}`);
+      
+      totalSize += result.size;
+      totalSourcemapSize += result.sourcemapSize;
+    }
+  }
+  
+  console.log(gray('─'.repeat(80)));
+  
+  // 总计行
+  const totalFile = bold('Total').padEnd(35);
+  const totalSizeStr = bold(formatSize(totalSize)).padEnd(12);
+  const totalSourcemapStr = totalSourcemapSize > 0
+    ? bold(formatSize(totalSourcemapSize)).padEnd(12)
+    : gray('-').padEnd(12);
+  const totalTimeStr = bold(formatDuration(totalDuration)).padEnd(10);
+  
+  console.log(`${totalFile} | ${totalSizeStr} | ${totalSourcemapStr} | ${totalTimeStr}`);
+  console.log(gray('─'.repeat(80)));
+  
+  // 输出目录信息
+  const outputPath = formatPath(path.join(OUTPUT_DIR, platform));
+  console.log(`\n${bold('Output:')} ${cyan(outputPath)}`);
+  console.log(`${bold('Platform:')} ${blue(platform)} | ${bold('Environment:')} ${yellow(env)}\n`);
+}
+
+/**
+ * 主构建函数
+ */
+function buildMultiBundle(platform, env = 'development') {
+  const startTime = Date.now();
+  
+  // 构建开始日志
+  console.log('\n' + bold('🚀 Building Multi-Bundle'));
+  console.log(`${bold('Platform:')} ${blue(platform)} | ${bold('Environment:')} ${yellow(env)}\n`);
+  
+  const config = loadMultiBundleConfig();
+  const outputDir = ensureOutputDir(platform);
+  
+  const results = [];
+  const totalBundles = 1 + config.modules.length; // main + modules
+  let currentIndex = 0;
+  
+  // 1. 构建主 bundle
+  currentIndex++;
+  const mainEntry = path.join(PROJECT_ROOT, config.main.entry);
+  const mainFileName = getMainBundleFileName(platform);
+  const mainOutput = path.join(outputDir, mainFileName);
+  const mainResult = buildBundle(
+    mainEntry, 
+    mainOutput, 
+    platform, 
+    env,
+    { current: currentIndex, total: totalBundles, name: mainFileName }
+  );
+  results.push(mainResult);
+
+  // 2. 构建各个模块 bundle
+  for (const module of config.modules) {
+    currentIndex++;
+    const moduleEntry = path.join(PROJECT_ROOT, module.entry);
+    const moduleFileName = getModuleBundleFileName(module.id, platform);
+    const moduleOutput = path.join(outputDir, 'modules', moduleFileName);
+    const moduleResult = buildBundle(
+      moduleEntry, 
+      moduleOutput, 
+      platform, 
+      env,
+      { current: currentIndex, total: totalBundles, name: moduleFileName }
+    );
+    results.push(moduleResult);
+  }
+
+  // 3. 生成 manifest
+  generateManifest(config, platform);
+  
+  const totalDuration = Date.now() - startTime;
+  
+  // 显示构建摘要
+  printBuildSummary(results, platform, env, totalDuration);
+  
+  console.log(green(bold('✅ Build completed successfully!')) + '\n');
+}
+
+/**
+ * CLI 入口
+ */
+function main() {
+  const args = process.argv.slice(2);
+  const platform = args[0] || 'ios';
+  
+  // 解析环境参数
+  // ⭐ 默认使用 production 环境，打包命令应该默认是生产模式
+  let env = 'production';
+  const envIndex = args.indexOf('--env');
+  if (envIndex !== -1 && args[envIndex + 1]) {
+    env = args[envIndex + 1];
+  }
+
+  // 验证平台参数
+  if (!['ios', 'android'].includes(platform)) {
+    console.error(`\n${red('✗')} ${red(bold('Invalid platform'))}`);
+    console.error(`  ${gray('Use:')} ${cyan('ios')} ${gray('or')} ${cyan('android')}\n`);
+    process.exit(1);
+  }
+
+  // 验证环境参数
+  const validEnvs = ['development', 'staging', 'production'];
+  if (!validEnvs.includes(env)) {
+    console.error(`\n${red('✗')} ${red(bold('Invalid environment'))}`);
+    console.error(`  ${gray('Use one of:')} ${validEnvs.map(e => cyan(e)).join(', ')}\n`);
+    process.exit(1);
+  }
+
+  try {
+    buildMultiBundle(platform, env);
+  } catch (error) {
+    console.error(`\n${red('✗')} ${red(bold('Build failed'))}`);
+    if (error.message) {
+      console.error(`  ${red(error.message)}`);
+    } else {
+      console.error(`  ${red(String(error))}`);
+    }
+    console.error('');
+    process.exit(1);
+  }
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = { buildMultiBundle };
+

package/scripts/release-codepush-dev.sh

@@ -0,0 +1,90 @@
+#!/bin/bash
+
+# CodePush 发布脚本 - 开发环境配置
+# 用法: ./scripts/release-codepush-dev.sh [参数]
+# 示例: ./scripts/release-codepush-dev.sh --platform ios --version 1.0.0
+
+# 获取脚本所在目录
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# 切换到项目根目录
+cd "$PROJECT_ROOT"
+
+# ============================================
+# 环境变量配置（开发环境默认值）
+# ============================================
+# 请根据实际情况修改以下环境变量
+
+# CodePush 服务器地址（必填）
+export CODE_PUSH_SERVER_URL="${CODE_PUSH_SERVER_URL:-https://code-push.bminfraaws-prod.com}"
+
+# CodePush 访问密钥（必填）
+export ACCESS_KEY="${ACCESS_KEY:-5u9un34l5A8fYIeHpPtwUEYc8QRg4ksvOXqog}"
+
+# CodePush 应用名称（可选，可通过命令行参数覆盖）
+export CODE_PUSH_APP="${CODE_PUSH_APP:-multiple-bundle-demo-android}"
+
+# 部署环境（可选，可通过命令行参数覆盖）
+# 可选值: Staging, Production
+export CODE_PUSH_DEPLOYMENT="${CODE_PUSH_DEPLOYMENT:-Staging}"
+
+# 平台（可选，可通过命令行参数覆盖）
+# 可选值: ios, android
+export CODE_PUSH_PLATFORM="${CODE_PUSH_PLATFORM:-android}"
+
+# 原生应用版本号（可选，可通过命令行参数覆盖）
+export CODE_PUSH_VERSION="${CODE_PUSH_VERSION:-1.0.0}"
+
+# 发布描述（可选）
+export CODE_PUSH_DESCRIPTION="${CODE_PUSH_DESCRIPTION:-Development release}"
+
+# 是否强制更新（可选，默认 false）
+# 可选值: true, false, 1, 0
+export CODE_PUSH_MANDATORY="${CODE_PUSH_MANDATORY:-false}"
+
+# 灰度百分比（可选，默认 100）
+# 范围: 1-100
+export CODE_PUSH_ROLLOUT="${CODE_PUSH_ROLLOUT:-0}"
+
+# 是否禁用（可选，默认 false）
+# 可选值: true, false, 1, 0
+export CODE_PUSH_IS_DISABLED="${CODE_PUSH_IS_DISABLED:-false}"
+
+# ============================================
+# 执行发布脚本
+# ============================================
+
+echo "=========================================="
+echo "CodePush Release - Development Environment"
+echo "=========================================="
+echo ""
+echo "环境变量配置:"
+echo "  CODE_PUSH_SERVER_URL: $CODE_PUSH_SERVER_URL"
+echo "  CODE_PUSH_APP: $CODE_PUSH_APP"
+echo "  CODE_PUSH_DEPLOYMENT: $CODE_PUSH_DEPLOYMENT"
+echo "  CODE_PUSH_PLATFORM: $CODE_PUSH_PLATFORM"
+echo "  CODE_PUSH_VERSION: $CODE_PUSH_VERSION"
+echo "  CODE_PUSH_DESCRIPTION: $CODE_PUSH_DESCRIPTION"
+echo "  CODE_PUSH_MANDATORY: $CODE_PUSH_MANDATORY"
+echo "  CODE_PUSH_ROLLOUT: $CODE_PUSH_ROLLOUT"
+echo "  CODE_PUSH_IS_DISABLED: $CODE_PUSH_IS_DISABLED"
+echo ""
+echo "=========================================="
+echo ""
+
+# 检查 Node.js 是否安装
+if ! command -v node &> /dev/null; then
+    echo "错误: 未找到 Node.js，请先安装 Node.js"
+    exit 1
+fi
+
+# 检查 release-codepush.js 是否存在
+if [ ! -f "$SCRIPT_DIR/release-codepush.js" ]; then
+    echo "错误: 未找到 release-codepush.js"
+    exit 1
+fi
+
+# 执行发布脚本，传递所有命令行参数
+node "$SCRIPT_DIR/release-codepush.js" "$@"
+