Callstack/Repack 5.0.0-rc.11版本深度解析：React Native打包工具的重大升级

Callstack/Repack是一个专为React Native应用设计的模块化打包工具，它基于Webpack/Rspack构建，旨在为React Native开发者提供更灵活、更高效的打包体验。该项目通过创新的模块化设计和开发服务器集成，大大简化了大型React Native应用的构建和调试流程。

核心架构变革

5.0.0-rc.11版本对Repack的核心架构进行了重大调整，主要体现在配置系统的重构上。新版本引入了一套严格的配置级联系统，采用"CLI标志 > 配置文件值 > 命令默认值 > Webpack/Rspack默认值"的优先级顺序。这种设计确保了配置解析的一致性和可预测性，开发者现在可以更清晰地理解配置是如何被合并和应用的。

值得注意的是，CLI参数现在具有最高优先级，且不能被配置文件覆盖。这一改变虽然提高了行为一致性，但也意味着开发者需要调整原有的配置习惯，特别是在混合使用CLI和配置文件时。

关键功能改进

1. 简化的插件配置

RepackPlugin的配置得到了大幅简化：

• 移除了context、mode和sourceMaps选项，改为直接从Rspack/webpack配置中获取
• platform和output选项变为可选，现在可以自动推断
• 插件配置对象现在完全可选，最小化配置只需new Repack.RepackPlugin()

这种简化显著降低了新项目的入门门槛，同时也减少了现有项目的配置复杂度。

2. 增强的sourcemap处理

新版本彻底重构了sourcemap的生成机制：

• 使用config.devtool来控制sourcemap行为，移除了原有的devtool: false设置
• 引入了专用的SourceMapPlugin，整合了sourcemap配置
• 开发者现在需要通过设置devtool为有效值(如source-map)来启用sourcemap

这一改变使得sourcemap的生成更加标准化，与其他打包工具的行为更加一致。

3. 开发服务器配置改进

开发服务器相关配置也经历了重大调整：

• 移除了assets-loader中的devServerEnabled选项
• 不再需要手动配置devServer
• 新增了config.devServer字段，支持类型安全的http/https配置
• 支持特殊主机值(local-ip, local-ipv4, local-ipv6)
• 增强了HTTPS配置，完整支持HttpsServerOptions

这些改进使得开发服务器的配置更加直观和安全，特别是在需要HTTPS的复杂场景下。

新增实用工具函数

5.0.0-rc.11版本引入了几个实用的工具函数，进一步简化了开发流程：

1. getAssetTransformRules：简化了在Webpack和Rspack项目中设置资源转换规则的过程
2. getJsTransformRules：为React Native项目在Rspack中设置JavaScript转换规则提供了便利
3. 改进的getResolveOptions：现在可以不传参数调用，自动解析平台扩展

这些工具函数封装了常见的配置模式，减少了样板代码，提高了开发效率。

其他重要变更

1. 路径解析增强：现在支持在config.output.path中使用[platform]和[context]占位符，使得多平台项目的输出路径配置更加灵活。

2. React Refresh加载器统一：在所有配置(Rspack和webpack)中使用自定义的ReactRefreshLoader，确保热更新行为的一致性。

3. 入口文件处理优化：当entry-file在rspack.config.js或webpack.config.js中定义时，不再需要强制指定--entry-file参数。

4. Android脚本加载优化：重构了Android的RemoteScriptLoader.kt以重用scriptsDir，提高了代码效率。

向后兼容性说明

这个版本包含多个破坏性变更，需要开发者注意：

1. getPublicPath工具函数已被弃用，现在是一个空操作，公共路径配置改为自动处理。

2. 多个插件中的entryName配置选项被移除，改为自动从配置中获取。

3. bundleFilename、sourceMapFilename和assetsPath等输出相关配置已从插件配置中移除，现在只能通过CLI标志控制。

4. 开发服务器相关配置必须更新为新的config.devServer格式。

升级建议

对于计划升级到5.0.0-rc.11的团队，建议采取以下步骤：

1. 首先检查项目中是否使用了已弃用的API，特别是getPublicPath函数。

2. 审查所有与sourcemap相关的配置，确保正确设置了devtool选项。

3. 更新开发服务器配置，使用新的config.devServer格式。

4. 简化RepackPlugin的配置，移除现在可以自动推断的选项。

5. 将输出文件名和路径的配置迁移到CLI标志，或依赖新的默认行为。

这个版本虽然包含破坏性变更，但带来的配置简化和功能增强将显著提升开发体验。对于新项目，可以直接采用新版本的配置模式；对于现有项目，建议在测试环境中充分验证后再进行升级。