当前位置：首页 > news >正文

EAS CLI 入门教程：从零开始配置你的第一个 Expo 项目

news 2026/8/26 14:26:27

EAS CLI 入门教程：从零开始配置你的第一个 Expo 项目

【免费下载链接】eas-cliFastest way to build, submit, and update iOS and Android apps项目地址: https://gitcode.com/gh_mirrors/ea/eas-cli

Expo Application Services (EAS) CLI 是 Expo 生态系统中最强大的命令行工具，专门用于构建、提交和更新 iOS 和 Android 应用程序。这个完整的指南将带你从零开始，轻松掌握 EAS CLI 的核心功能和使用方法。无论你是 React Native 新手还是有经验的开发者，这篇教程都将帮助你快速上手 EAS CLI 并配置你的第一个 Expo 项目。

📦 EAS CLI 是什么？

EAS CLI 是 Expo Application Services 的命令行界面，它让你能够在云端构建原生应用二进制文件、管理应用更新、处理应用商店提交等复杂任务。相比传统的本地构建方式，EAS CLI 提供了更快速、更可靠的构建体验，大大简化了移动应用开发的部署流程。

主要功能亮点 ✨

云端构建：在 Expo 的服务器上构建 iOS 和 Android 应用
自动化提交：一键提交应用到 App Store 和 Google Play
实时更新：无需重新构建即可推送代码更新
凭证管理：自动处理代码签名和证书管理
环境变量：安全地管理敏感配置信息
工作流自动化：定义自定义构建和部署流程

🚀 快速安装指南

安装 EAS CLI 非常简单，只需要一个命令：

npm install -g eas-cli # 或者使用 yarn yarn global add eas-cli

安装完成后，验证安装是否成功：

eas --version

如果看到版本号输出，说明安装成功！🎉

🔐 登录与账户配置

开始使用 EAS CLI 前，你需要登录你的 Expo 账户：

eas login

这个命令会打开浏览器让你登录 Expo 账户。如果你更喜欢命令行登录，可以使用：

eas login --sso

登录后，你可以查看当前账户信息：

eas account:view

📁 初始化你的第一个项目

步骤 1：创建 Expo 项目

如果你还没有 Expo 项目，先创建一个：

npx create-expo-app my-app cd my-app

步骤 2：初始化 EAS 配置

在项目根目录运行：

eas init

这个命令会创建一个eas.json配置文件，这是 EAS CLI 的核心配置文件。让我们看看它的基本结构：

{ "cli": { "version": ">=1.0.0" }, "build": { "development": { "developmentClient": true, "distribution": "internal" }, "preview": { "distribution": "internal" }, "production": { "autoIncrement": true } }, "submit": { "production": {} } }

⚙️ 配置构建配置文件

EAS CLI 的强大之处在于其灵活的构建配置。在eas.json中，你可以定义多个构建配置文件：

基础构建配置示例

{ "build": { "development": { "developmentClient": true, "distribution": "internal", "android": { "buildType": "apk" }, "ios": { "simulator": true } }, "preview": { "distribution": "internal", "android": { "buildType": "apk" } }, "production": { "autoIncrement": true, "android": { "buildType": "app-bundle" }, "ios": { "enterpriseProvisioning": "universal" } } } }

关键配置选项说明

developmentClient：启用开发客户端构建
distribution：设置分发类型（internal、simulator、store）
autoIncrement：自动递增版本号
buildType：Android 构建类型（apk或app-bundle）
simulator：iOS 模拟器构建

🏗️ 构建你的第一个应用

开发构建（快速测试）

eas build --platform android --profile development # 或 eas build --platform ios --profile development

预览构建（内部测试）

eas build --platform all --profile preview

生产构建（应用商店）

eas build --platform all --profile production

🔄 管理应用更新

EAS Update 是 EAS CLI 最强大的功能之一，允许你无需重新构建应用即可推送更新。

发布更新

eas update --auto

创建发布渠道

eas channel:create production eas channel:create staging

配置渠道映射

eas channel:edit production --branch main eas channel:edit staging --branch develop

📱 应用商店提交

EAS CLI 简化了应用商店提交流程：

提交到 TestFlight (iOS)

eas submit --platform ios --profile production

提交到 Google Play (Android)

eas submit --platform android --profile production

🔐 凭证管理

EAS CLI 自动处理复杂的凭证管理：

配置构建凭证

eas credentials:configure-build

查看当前凭证状态

eas credentials

🌐 环境变量管理

安全地管理敏感配置：

设置环境变量

eas env:create production

推送环境变量

eas env:push production

拉取环境变量

eas env:pull production

🛠️ 高级功能探索

1. 工作流自动化

EAS CLI 支持自定义工作流，位于eas.json的workflow部分：

{ "workflow": { "my-workflow": { "steps": [ { "type": "command", "command": "npm test" }, { "type": "eas/build", "profile": "production" }, { "type": "eas/submit", "profile": "production" } ] } } }

2. 构建缓存优化

{ "build": { "production": { "cache": { "paths": [ "node_modules/**", ".yarn/**", "android/.gradle/**" ] } } } }

3. 自定义构建环境

{ "build": { "production": { "env": { "NODE_ENV": "production", "API_URL": "https://api.example.com" }, "node": "18.0.0", "yarn": "3.2.0", "npm": "8.0.0" } } }

🐛 故障排除技巧

常见问题解决

构建失败：检查eas build --verbose获取详细日志
凭证问题：运行eas credentials验证凭证状态
配置错误：使用eas config验证当前配置
网络问题：确保网络连接正常，特别是访问 Expo 服务

调试命令

# 查看详细构建日志 eas build --verbose # 验证项目配置 eas config # 运行诊断 eas diagnostics

📈 最佳实践建议

1. 版本控制策略

{ "cli": { "version": ">=18.0.0", "requireCommit": true } }

2. 多环境配置

{ "build": { "development": { "extends": "base", "env": { "ENVIRONMENT": "development" } }, "staging": { "extends": "base", "env": { "ENVIRONMENT": "staging" } }, "production": { "extends": "base", "env": { "ENVIRONMENT": "production" } } } }

3. 自动化部署流水线

结合 CI/CD 工具如 GitHub Actions：

name: EAS Build and Submit on: push: branches: [main] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - uses: actions/setup-node@v3 - run: npm install -g eas-cli - run: eas build --platform all --profile production --non-interactive --wait - run: eas submit --platform all --profile production --non-interactive --wait