3.4 KiB
项目简介
本项目为 Expo/React Native 应用,支持 EAS 构建。
常用命令
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)
eas build --profile development --platform android
预览版构建(preview profile)
eas build --profile preview --platform android
发布版构建(production profile)
eas build --profile production --platform android
eas build:dev --platform android
IOS
eas build --platform ios --profile production
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() 判断是否可以返回上一页,返回布尔值。