解决lottie-react-native在iOS构建时的模块依赖问题

问题背景

在使用lottie-react-native库时，许多开发者会遇到iOS平台构建失败的问题。特别是在React Native 0.73.6版本环境下，当添加lottie-react-native 6.7.0依赖后，执行pod install命令会报出模块依赖相关的错误。

错误现象

开发者通常会遇到两个阶段的错误：

1. 首次执行pod install时出现的Swift模块依赖错误，提示glog没有定义模块
2. 添加use_modular_headers!后，构建过程中出现的编译失败问题

根本原因分析

这些问题源于lottie-react-native作为Swift编写的库，与React Native中原有的Objective-C库之间的模块化兼容性问题。特别是glog等基础依赖库最初设计时没有考虑Swift模块化导入的需求。

解决方案

经过社区验证的有效解决方案是使用特定的环境变量来执行pod安装：

USE_FRAMEWORKS=static NO_FLIPPER=1 pod install

这个命令做了两件关键事情：

1. USE_FRAMEWORKS=static：告诉CocoaPods使用静态框架而非动态框架，这解决了Swift和Objective-C混编时的模块化问题
2. NO_FLIPPER=1：禁用Flipper调试工具，避免可能存在的额外冲突

实施步骤

1. 确保项目目录结构正确，已初始化iOS项目
2. 在项目根目录执行：

   cd ios
   USE_FRAMEWORKS=static NO_FLIPPER=1 pod install
   

3. 安装完成后，返回项目根目录执行：

   npx react-native run-ios
   

注意事项

1. 此解决方案适用于React Native 0.73.x版本和lottie-react-native 6.x版本
2. 如果项目需要使用Flipper调试工具，可以尝试只使用USE_FRAMEWORKS=static而不禁用Flipper
3. 对于较新版本的React Native，可能需要检查是否有更新的解决方案

最佳实践建议

1. 在添加lottie-react-native依赖前，先确保基础React Native项目能正常构建
2. 考虑使用较新的lottie-react-native版本，可能已经内置解决了这些问题
3. 定期清理DerivedData目录，避免缓存导致的构建问题

通过以上方法，开发者可以顺利解决lottie-react-native在iOS平台的构建问题，享受这个强大动画库带来的便利。