SuperAPI AI 工具集

react-native-expert

编程与开发

查看项目

更新于 10-16 10:08

技能介绍

用途

React Native Expert 是一个用于构建、优化和调试跨平台移动应用的技能,基于 React Native 与 Expo。它以「资深移动工程师」的角色,帮助完成从环境搭建到性能优化、从导航到存储的生产级实现。

核心工作流

技能给出的工作流程分为五个阶段:

  1. Setup(搭建)——使用 Expo Router 或 React Navigation,配置 TypeScript;运行 npx expo doctor 验证环境与 SDK 兼容性,并在继续之前修复所有报告的问题。
  2. Structure(结构)——采用基于特性的组织方式。
  3. Implement(实现)——编写带平台处理的组件,在 iOS 模拟器和 Android 模拟器上验证,继续前检查 Metro bundler 输出是否有错误。
  4. Optimize(优化)——针对 FlatList、图片、内存进行优化,使用 Flipper 或 React DevTools 进行性能分析。
  5. Test(测试)——在两个平台、真实设备上测试。

错误恢复

技能提供了针对常见问题的排查路径:

  • Metro bundler 错误 → 使用 npx expo start --clear 清除缓存,然后重启。
  • iOS 构建失败 → 检查 Xcode 日志 → 解决原生依赖或 provisioning 问题 → 使用 npx expo run:ios 重新构建。
  • Android 构建失败 → 检查 adb logcat 或 Gradle 输出 → 解决 SDK/NDK 版本不匹配 → 使用 npx expo run:android 重新构建。
  • 找不到原生模块 → 运行 npx expo install <module> 以确保兼容版本,然后重新构建原生层。

参考指南

技能按上下文加载详细指引:

  • Navigation → references/expo-router.md,适用于 Expo Router、标签页、堆栈、深度链接。
  • Platform → references/platform-handling.md,适用于 iOS/Android 代码、SafeArea、键盘。
  • Lists → references/list-optimization.md,适用于 FlatList、性能、memo。
  • Storage → references/storage-hooks.md,适用于 AsyncStorage、MMKV、持久化。
  • Structure → references/project-structure.md,适用于项目搭建、架构。

约束

必须做(MUST DO):列表使用 FlatList/SectionList 而非 ScrollView;为列表项实现 memo + useCallback;处理 SafeAreaView 以适配刘海屏;在 iOS 和 Android 真机上测试;表单使用 KeyboardAvoidingView;在导航中处理 Android 返回键。

禁止做(MUST NOT DO):对大列表使用 ScrollView;大量使用内联样式(会创建新对象);硬编码尺寸(应使用 Dimensions API 或 flex);忽略订阅导致的内存泄漏;跳过平台特定测试;用 waitFor/setTimeout 实现动画(应使用 Reanimated)。

代码示例

技能包含三个代码示例:使用 memo + useCallback 的优化 FlatList、KeyboardAvoidingView 表单、平台特定组件。代码保留原始实现,核心思路如下:

  • FlatList 示例展示 memo 包装列表项、useCallback 缓存 handlePress 与 renderItem,并在 FlatList 上设置 removeClippedSubviews、maxToRenderPerBatch={10}、windowSize={5}。
  • 表单示例组合 SafeAreaView + KeyboardAvoidingView(iOS 用 padding、Android 用 height)+ ScrollView(keyboardShouldPersistTaps="handled")。
  • 平台组件示例使用 Platform.select 分别为 iOS 提供 shadow 属性、为 Android 提供 elevation。

输出格式

实现 React Native 功能时,技能交付以下内容:组件代码(TypeScript,定义 prop 类型);平台处理(Platform.select 或按 .ios.tsx / .android.tsx 拆分);导航集成(路由参数有类型、包含返回键处理);性能说明(memo 边界、key extractor 策略、图片缓存)。

知识参考

涉及 React Native 0.73+、Expo SDK 50+、Expo Router、React Navigation 7、Reanimated 3、Gesture Handler、AsyncStorage、MMKV、React Query、Zustand。

适用场景与限制

该技能适用于使用 React Native 与 Expo 开发跨平台移动应用的场景,尤其是需要导航结构、列表性能优化、平台差异处理与构建问题排查的项目。关于具体收费方式、价格与授权信息,资料中暂未提供。