React Native出现<RNCViewPager>未实现报错问题咨询

React Native开发过程中接入react-native-tab-view实现Material风格顶部标签导航，应用可成功启动，但模拟器界面弹出报错：

REACT-NATIVE Unimplemented component :

对应业务实现代码如下：

import { createNativeStackNavigator } from '@react-navigation/native-stack'
import { createMaterialTopTabNavigator } from '@react-navigation/material-top-tabs'

import type { FC } from 'react'

import { HomeScreen, ProfileScreen } from '~screens'
import { TCommonRoutes } from '~types'

export const CommonRoutes: FC = () => {
  const Stack = createNativeStackNavigator<TCommonRoutes>()
  const Tab = createMaterialTopTabNavigator<TCommonRoutes>()

  return (
    <Tab.Navigator>
      <Tab.Screen
        name="Home"
        component={HomeScreen}
        options={{ title: 'Welcome' }}
      />
      <Tab.Screen
        name="Profile"
        component={ProfileScreen}
      />
    </Tab.Navigator>
  )
}

• 执行yarn add @react-navigation/material-top-tabs react-native-tab-view安装导航相关依赖
• 执行yarn add react-native-pager-view安装分页视图原生依赖
• 进入ios目录执行pod install完成iOS端原生依赖关联安装

• React native Invariant Violation: requireNativeComponent: "RNCViewPager" was not found in the UIManager
• Android: Invariant Violation requireNativeComponent: "RNCViewPager" was not found in the UIManager

缓存清理优先排查 #

• 完全关闭当前运行的Metro打包进程，执行yarn start --reset-cache清除打包缓存后重启服务
• 卸载模拟器/测试机上已安装的旧应用包，重新执行yarn ios或yarn android全量编译安装，避免热更新未加载新原生模块的问题

iOS端专项检查 #

• 确认pod install执行过程无报错，检查ios/Podfile.lock文件中是否存在react-native-pager-view条目；若不存在，删除Podfile.lock、Pods文件夹后执行pod install --repo-update重新安装依赖
• React Native 0.60以下版本需手动执行react-native link react-native-pager-view完成原生关联；0.60+版本若autolink失效，需检查项目autolink配置是否排除了该依赖

Android端专项检查 #

• 检查android/app/build.gradle的dependencies块中是否存在pager-view依赖，缺失则手动添加implementation project(':react-native-pager-view')
• 检查MainApplication.java的getPackages方法中是否注册PagerViewPackage，未注册则手动添加该包到注册列表

版本兼容排查 #

• 确认react-native-pager-view版本与当前React Native版本匹配：React Native 0.60+需搭配5.x及以上版本的react-native-pager-view，版本过低会出现原生组件无法识别的问题
• 若使用Expo托管工作流，不可直接通过yarn安装原生依赖，需执行expo install react-native-pager-view安装Expo适配版本

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