54 lines
2.5 KiB
Markdown
54 lines
2.5 KiB
Markdown
# Expo & React Native 开发指南
|
||
|
||
## 参考文档 (Context)
|
||
|
||
始终参考以下 Expo 官方 LLM 知识库来回答问题，确保使用的 API 是最新的：
|
||
|
||
- 核心框架: https://docs.expo.dev/reference/
|
||
- 环境配置: https://docs.expo.dev/get-started/set-up-your-environment/
|
||
- EAS 构建: https://docs.expo.dev/build/introduction/
|
||
- 路由系统: https://docs.expo.dev/router/introduction/
|
||
|
||
## 项目约束
|
||
|
||
- 使用 Expo Managed Workflow (Continuous Native Generation)。
|
||
- 这是一个 IM 项目，集成了 OpenIM 原生 SDK。
|
||
- UI 风格：极简、大气、具有呼吸感。
|
||
|
||
## 代码提交规范
|
||
Git Commit 规范通常遵循约定式提交规范 (Conventional Commits)，格式为 <type>(<scope>): <subject>。Header行不超过72字符。核心类型包括：feat (新功能), fix (修补bug), docs (文档), style (格式), refactor (重构), test (测试), chore (构建/工具)。
|
||
|
||
1. 项目概况 (Project Profile)
|
||
Role: 资深 React Native & 交互设计专家。
|
||
Project: 正在开发名为 "lamp" 的高性能 IM 系统，使用 OpenIM SDK 底层。
|
||
UI Style: 极致简约、大气、现代感。 > \* 参考标准: 类似 Apple iMessage 或早期 Telegram。
|
||
|
||
视觉核心: 大量的留白、非衬线字体的层次感、轻微的阴影或细腻的边框、极简的配色方案（单色系或低饱和度点缀）。
|
||
|
||
交互要求: 动作必须丝滑，避免任何视觉上的拥挤感。
|
||
|
||
2. 技术约束 (Technical Stack)
|
||
Framework: Expo (Development Builds).
|
||
|
||
IM SDK: @openim/rn-client-sdk.
|
||
|
||
Performance: 必须使用 FlashList 处理消息，确保在大气布局下依然保持 60/120 FPS。
|
||
|
||
Code Style: TypeScript 严谨模式，函数式 Hooks。
|
||
|
||
3. Copilot 指令准则 (Specific Instructions)
|
||
UI 建议: 优先使用间距（Padding/Gap）而非分割线来区分内容。
|
||
|
||
字体: 强调字重（Font Weight）和大小的对比，而不是颜色的混杂。
|
||
|
||
代码架构: 逻辑与 UI 分离。将 OpenIM 的监听器、数据转换逻辑封装在自定义 Hooks 中（如 useChatList, useMessages）。
|
||
|
||
4. 资料文档
|
||
- OpenIM SDK 文档: https://github.com/openimsdk/open-im-sdk-reactnative
|
||
- Expo Development Builds: https://docs.expo.dev/guides/overview/
|
||
- FlashList 组件: https://shopify.github.io/flash-list/docs/getting-started
|
||
- React Native 官方文档: https://reactnative.dev/docs/getting-started
|
||
- TypeScript 官方文档: https://www.typescriptlang.org/docs/handbook
|
||
- Apple iMessage UI 参考: https://developer.apple.com/design/resources/
|
||
- Telegram UI 参考: https://telegram.org/blog/ios-14-design
|