## 项目简介 本项目为 Expo/React Native 应用,支持 EAS 构建。 ### 常用命令 ```bash eas build --platform android --profile development ``` --- ## 项目文件结构 ``` ├── app/ # 页面与路由 ├── assets/ # 静态资源(图片、字体等) ├── components/ # 复用组件 ├── constants/ # 常量(如颜色) ├── hooks/ # 自定义 hooks ├── scripts/ # 脚本工具 ├── app.json # Expo 配置 ├── package.json # 项目依赖 ├── tsconfig.json # TypeScript 配置 ``` ### 目录说明及功能 - **app/**: - 存放应用的页面(Screen)和路由配置。 - 每个文件/文件夹通常对应一个页面或导航结构。 - 例如:主界面、Tab 导航、404 页面等。 - **assets/**: - 存放项目用到的静态资源,如图片、字体等。 - 例如:logo、icon、启动图、字体文件等。 - **components/**: - 存放可复用的 UI 组件。 - 例如:按钮、卡片、列表项、主题文本、Tab 栏等。 - 便于在不同页面间复用,提高开发效率。 - **constants/**: - 存放全局常量配置。 - 例如:`Colors.ts` 统一管理全局颜色值,方便主题切换和维护。 - **hooks/**: - 存放自定义 React Hooks。 - React Hooks 是 React 16.8 及以上版本引入的函数,允许在函数组件中使用 state、生命周期等特性。 - 例如:主题切换、颜色方案、系统偏好、数据获取等逻辑的复用。 - **scripts/**: - 存放自动化脚本或开发辅助工具。 - 例如:重置项目、批量处理文件等脚本。 - **app.json**: - Expo 项目的全局配置文件。 - 包含应用名称、图标、启动页、平台相关设置等。 - **package.json**: - Node.js 项目的依赖、脚本、元数据配置文件。 - 管理依赖包、项目脚本、版本等。 - **tsconfig.json**: - TypeScript 的编译配置文件。 - 配置编译选项、包含/排除的文件等。 --- 如需构建 Android APK 包,可根据不同环境选择以下命令: #### 开发版构建(development profile) ```bash eas build --profile development --platform android ``` #### 预览版构建(preview profile) ```bash eas build --profile preview --platform android ``` #### 发布版构建(production profile) ```bash eas build --profile production --platform android ``` eas build:dev --platform android # IOS ```bash eas build --platform ios --profile production ``` ```bash eas submit --platform ios ``` # expo-updates 推送到预览版 eas update --branch preview 推送到生产版 eas update --branch production # 渠道判断 获取当前的发布渠道 const channel = Updates.channel || "development"; if (channel === "production") { ToastAndroid.show("欢迎使用生产版本", ToastAndroid.SHORT); } else if (channel === "preview") { ToastAndroid.show("欢迎使用预览版本", ToastAndroid.SHORT); } else { ToastAndroid.show("欢迎使用开发版本", ToastAndroid.SHORT); } Expo Router 的常用方法有: router.push(path) 跳转到新页面,保留历史,可返回。 router.replace(path) 替换当前页面,不保留历史,常用于登录/登出。 router.back() 返回上一页,类似浏览器的后退。 router.prefetch(path) 预加载某个页面,提高跳转速度。 router.canGoBack() 判断是否可以返回上一页,返回布尔值。