用途
React Native Expert 是一个用于构建、优化和调试跨平台移动应用的技能,基于 React Native 与 Expo。它以「资深移动工程师」的角色,帮助完成从环境搭建到性能优化、从导航到存储的生产级实现。
核心工作流
技能给出的工作流程分为五个阶段:
- Setup(搭建)——使用 Expo Router 或 React Navigation,配置 TypeScript;运行
npx expo doctor验证环境与 SDK 兼容性,并在继续之前修复所有报告的问题。 - Structure(结构)——采用基于特性的组织方式。
- Implement(实现)——编写带平台处理的组件,在 iOS 模拟器和 Android 模拟器上验证,继续前检查 Metro bundler 输出是否有错误。
- Optimize(优化)——针对 FlatList、图片、内存进行优化,使用 Flipper 或 React DevTools 进行性能分析。
- 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 开发跨平台移动应用的场景,尤其是需要导航结构、列表性能优化、平台差异处理与构建问题排查的项目。关于具体收费方式、价格与授权信息,资料中暂未提供。