zhoujie/TriloopTem_App

Fork 0

zhoujie a89d23b43c 基本功能完成

2026-06-20 21:43:09 +08:00

9.0 KiB

Raw Blame History

EAS 云构建指南

适用于 TriloopTem App (TEM Receiver) 最后更新：2026-06-20

本文档详细说明如何使用 Expo EAS 云构建服务编译 Android APK 和 iOS IPA，包括所有账号注册和配置步骤。

一、前置准备

1.1 所需账号

账号	用途	费用
Expo 账号	EAS 云构建平台	免费（30 次/月构建额度）
Google 开发者账号	上架 Google Play（可选）	$25 一次性
Apple Developer Program	iOS 签名和分发（必须）	¥688/年

1.2 本地环境

Node.js >= 18
npm >= 9
Git（代码需在 Git 仓库中）

二、注册 Expo 账号

访问 https://expo.dev/signup
填写用户名、邮箱、密码，完成注册
验证邮箱

三、注册 Apple Developer Program（iOS 必须）

3.1 注册 Apple ID

如果没有 Apple ID：

访问 https://appleid.apple.com/account
填写姓名、邮箱、手机号
完成双重认证设置

3.2 加入 Apple Developer Program

访问 https://developer.apple.com/programs/enroll/
点击「开始注册」
选择注册类型：
- 个人 — 适合个人开发者，只需 Apple ID
- 组织 — 需要 DUNS 编号（邓白氏编码），适合公司
填写个人/公司信息
支付年费 ¥688（支持 Visa/MasterCard/银联）
等待审核（通常 24-48 小时）

3.3 审核通过后

登录 https://developer.apple.com 确认会员状态为 Active
记住你的 Team ID（在 Membership 页面可以看到）

四、安装和配置 EAS CLI

4.1 安装

npm install -g eas-cli

4.2 登录 Expo 账号

eas login

输入注册的 Expo 用户名和密码。

4.3 验证登录

eas whoami

显示你的用户名即为成功。

五、项目配置

5.1 确认 app.json

确保 app.json 中以下字段已正确填写：

{
  "expo": {
    "name": "TEM Receiver",
    "slug": "TriloopTem_App",
    "version": "1.0.0",
    "ios": {
      "bundleIdentifier": "com.triloop.temreceiver"
    },
    "android": {
      "package": "com.triloop.temreceiver"
    }
  }
}

5.2 初始化 EAS 配置

cd f:\1_Projects\2026\SixChannelApp\TriloopTem_App
eas build:configure

自动生成 eas.json 文件。手动编辑为以下内容：

{
  "cli": {
    "version": ">= 5.0.0"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "android": {
        "buildType": "apk"
      },
      "ios": {
        "simulator": true
      }
    },
    "preview": {
      "distribution": "internal",
      "android": {
        "buildType": "apk"
      }
    },
    "production": {
      "android": {
        "buildType": "apk"
      }
    }
  },
  "submit": {
    "production": {
      "ios": {
        "appleId": "你的Apple ID邮箱",
        "ascAppId": "App Store Connect中的App ID（上架时填写）"
      }
    }
  }
}

5.3 确保代码在 Git 仓库中

EAS 需要 Git 仓库：

git add -A
git commit -m "准备 EAS 构建"

六、构建 Android

6.1 Preview 版（内部测试用 APK）

eas build --platform android --profile preview

首次构建会提示：

Generate a new Android Keystore? → 选 Yes（EAS 自动管理签名密钥）

构建过程（约 10-20 分钟）：

代码上传到 EAS 云端
云端安装依赖
编译生成 APK
提供下载链接

6.2 Production 版（正式发布用）

eas build --platform android --profile production

6.3 下载 APK

构建完成后终端会显示下载链接，也可以在 https://expo.dev 的项目页面查看。

# 查看构建列表
eas build:list --platform android

七、构建 iOS

7.1 首次构建

eas build --platform ios --profile production

首次构建会依次提示以下内容：

第 1 步：Apple 账号登录

? Do you want to log in to your Apple account? › Yes

? Apple ID: › 输入你的 Apple ID 邮箱
? Password: › 输入密码

如果开启了双重认证，会要求输入 6 位验证码。

第 2 步：选择开发者团队

? Select Team › 
  ❯ XXXXXXXX - 你的名字/公司名 (Team ID)

选择你的开发者团队。

第 3 步：Bundle Identifier 确认

? Bundle Identifier: › com.triloop.temreceiver

直接回车使用默认值。

第 4 步：签名证书管理

? How would you like to manage your credentials? ›
  ❯ Let Expo handle it (Recommended)
    I want to provide my own

选择 "Let Expo handle it"。EAS 会自动：

创建 Distribution Certificate（发布证书）
创建 Provisioning Profile（配置文件）
安全存储在 EAS 服务器上

第 5 步：等待构建

iOS 构建约 15-30 分钟。进度可在终端或 https://expo.dev 查看。

7.2 后续构建

第二次及以后的构建不再需要上述交互，直接运行：

eas build --platform ios --profile production

7.3 下载 IPA

eas build:list --platform ios

或访问 https://expo.dev 项目页面下载。

八、安装到设备

8.1 Android

下载 APK 后直接安装：

adb install app-xxx.apk

或将 APK 发送到手机上点击安装。

8.2 iOS — 内部测试（Ad Hoc）

注意：需要先注册测试设备的 UDID。

注册测试设备

手机 Safari 访问 https://expo.dev/register-device
安装描述文件获取 UDID
在 EAS 中注册设备：

eas device:create

按提示输入设备 UDID 和名称。

构建 Ad Hoc 版本

eas build --platform ios --profile preview

构建完成后生成安装链接，在手机 Safari 中打开即可安装。

8.3 iOS — TestFlight 分发

适合分发给多人测试：

提交到 App Store Connect

eas submit --platform ios

提示：

? Select a build to submit › 选择最近的构建
? Apple ID: › 你的 Apple ID

提交后：

登录 https://appstoreconnect.apple.com
进入「我的 App」→ 选择 App → TestFlight
等待 Apple 审核（通常几分钟到几小时）
审核通过后添加内部/外部测试人员
测试人员在 TestFlight App 中安装

九、上架应用商店（可选）

9.1 Google Play

注册 Google Play 开发者账号（$25 一次性）：https://play.google.com/console/signup
在 Google Play Console 创建应用
构建 AAB 格式：

修改 eas.json 的 production profile：

"production": {
  "android": {
    "buildType": "app-bundle"
  }
}

eas build --platform android --profile production
eas submit --platform android

9.2 App Store

在 App Store Connect 创建 App：https://appstoreconnect.apple.com
填写 App 信息（名称、描述、截图、分类等）
提交构建：

eas build --platform ios --profile production
eas submit --platform ios

在 App Store Connect 中选择构建版本
提交审核（通常 24-48 小时）

十、常用命令速查

# ── 账号 ──
eas login                          # 登录
eas whoami                         # 查看当前账号

# ── 构建 ──
eas build -p android               # 构建 Android（默认 production）
eas build -p ios                   # 构建 iOS
eas build -p all                   # 同时构建双平台
eas build -p android --profile preview  # 指定 profile
eas build:list                     # 查看构建历史
eas build:cancel                   # 取消当前构建

# ── 设备管理（iOS Ad Hoc）──
eas device:create                  # 注册测试设备
eas device:list                    # 查看已注册设备

# ── 提交商店 ──
eas submit -p android              # 提交到 Google Play
eas submit -p ios                  # 提交到 App Store

# ── 证书管理 ──
eas credentials                    # 管理签名证书

十一、常见问题

Q: 构建失败，提示 "Missing credentials"

A: 运行 eas credentials 重新配置签名证书。

Q: iOS 构建提示 "No bundle identifier"

A: 确认 app.json 中 ios.bundleIdentifier 已填写。

Q: 免费额度用完了怎么办

A: 等下个月刷新（每月 30 次），或改用本地构建（Android 用 build-release.bat，iOS 需要 Mac）。

Q: 不想用 EAS 管理证书，可以自己管理吗

A: 可以。首次构建时选 "I want to provide my own"，然后上传你的 .p12 证书和 .mobileprovision 文件。

Q: Android 签名密钥丢了怎么办

A: EAS 自动管理的密钥存储在 Expo 服务器，不会丢失。可以用 eas credentials 随时下载备份。

十二、费用总结

场景	费用
仅构建 Android APK	免费（EAS 免费额度）
构建 iOS + 自己测试	¥688/年（Apple Developer）
上架 Google Play	$25 一次性 + 免费构建
上架 App Store	¥688/年（Apple Developer）
双平台上架	¥688/年 + $25

9.0 KiB Raw Blame History Unescape Escape