求助：Reanimated原生模块未初始化问题排查

ERROR 错误：[Reanimated] Reanimated的原生部分似乎未初始化。js引擎：hermes

可能原因及对应解决办法 #

• 安装或升级Reanimated后未重新构建应用
  执行以下命令完成清理与重建：

  # 删除依赖并重新安装
  rm -rf node_modules && npm install
  # iOS项目清理Pod并重新安装
  cd ios && pod deintegrate && pod install && cd ..
  # Android项目清理构建缓存
  ./gradlew clean -p android
  # 重置Metro缓存并重启服务
  npx react-native start --reset-cache
  

• 尝试在不支持的平台上运行Reanimated
  Reanimated v2及以上版本仅支持iOS、Android，Web端为有限支持。确认运行平台在支持范围内，非支持平台需更换动画方案。

• Brownfield应用中未手动初始化原生库

  • iOS端初始化：
    在AppDelegate.m（Objective-C）中添加：

    #import <Reanimated/REAInitializer.h>
    
    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
        // 原有代码
        [REAInitializer initialize];
        return YES;
    }
    

    或AppDelegate.swift（Swift）中添加：

    import Reanimated
    
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // 原有代码
        REAInitializer.initialize()
        return true
    }
    

  • Android端初始化：
    在MainApplication.java（Java）中添加：

    import com.swmansion.reanimated.ReanimatedPackage;
    
    @Override
    protected List<ReactPackage> getPackages() {
        return Arrays.asList(
                // 原有包
                new ReanimatedPackage()
        );
    }
    

    或MainApplication.kt（Kotlin）中添加：

    import com.swmansion.reanimated.ReanimatedPackage
    
    override fun getPackages(): List<ReactPackage> = listOf(
            // 原有包
            ReanimatedPackage()
    )
    

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