咨询Viro AR库兼容的React Native版本及相关配置要求

我之前也踩过Viro AR版本兼容的坑，给你整理下经过社区验证的稳定组合和配置要点：

一、稳定兼容版本组合 #

目前社区里验证最多、问题最少的配对是：

• Viro React Native 版本：2.21.0
• React Native 版本：0.64.4
  这个版本组合能避开大部分peer依赖冲突和编译失败的问题，亲测可以正常完成AR组件渲染和运行。

二、必要的依赖版本匹配 #

除了RN和Viro的核心版本，这些依赖也需要对应调整，避免版本错位：

• react 版本：17.0.2（和RN 0.64.4官方配套）
• react-dom 版本：17.0.2
• metro-react-native-babel-preset 版本：0.64.0

三、关键配置步骤 #

1. 初始化项目时直接指定RN版本，从源头避免版本混乱：

   npx react-native init MyARApp --version 0.64.4
   

2. 安装Viro AR库，指定对应稳定版本：

   npm install @viro-community/react-viro@2.21.0 --save
   

3. iOS端额外配置：
   • 打开Xcode，在项目的Info.plist中添加相机、位置权限描述（苹果审核必备）：

     <key>NSCameraUsageDescription</key>
     <string>需要使用相机进行AR体验</string>
     <key>NSLocationWhenInUseUsageDescription</key>
     <string>需要使用位置信息进行AR空间定位</string>
     

   • 确保Xcode版本在13.0以上，CocoaPods版本不低于1.11.0
4. Android端额外配置：
   • 在android/build.gradle中把minSdkVersion设置为24
   • 在AndroidManifest.xml中添加相机、AR硬件权限声明：

     <uses-permission android:name="android.permission.CAMERA" />
     <uses-feature android:name="android.hardware.camera.ar" android:required="true" />
     

四、常见问题快速排查 #

• 安装时出现peer依赖警告：直接用npm install --legacy-peer-deps替代普通安装命令，这是RN旧版本处理依赖冲突的常用方案
• Android编译失败：检查android/app/build.gradle中的compileSdkVersion是否为31（和RN 0.64.4适配）
• iOS编译报错：尝试删除Pods文件夹和Podfile.lock，重新执行pod install

内容来源于stack exchange