React Native DApp 开发全栈实战·从 0 到 1 系列（eas构建自定义客户端）

前言

Expo Go 只能调用官方 SDK；若想在 React Native DApp 里集成任意第三方原生库，就必须「自定义客户端」。下文以 Windows → Android 为例，演示「全程代理」构建的完整流程。

一、前置准备

1. 需要有提前注册一个expo 账号；
2. 本地已搭好 HTTP/SOCKS5 代理（端口示例：7890），关于梯子相关的这里就不赘述。

二、构建前准备工作（本地预检，强烈建议）

说明 ：本身代理就慢，在构建之前本地跑一遍，处理冲突等一些问题，直到全绿为止

# 查看是否冲突 第一次检测
npx expo-doctor@latest
# 任何 **红色 ✖**（依赖冲突 / peer deps 不兼容）→ 一律按提示修复
npx expo install --check 
# 如果有冲突
npx expo install --fix//自动对齐版本
# 解决之后 重新运行
npx expo-doctor@latest --verbose；//修复后，再跑一次，应该是全绿

三、代理构建自定义客户端(以window系统，构建android自定义客户端)

1. 初始化 EAS 配置生成项目id 可以在expo仪表盘上查看项目

# 登录
eas login //输入账号、密码
# EAS 配置
eas init

2. 一次性代理指令（详细步骤）

# cmd终端
set http_proxy=http://127.0.0.1:xxxx(例如：7890) 
set https_proxy=http://127.0.0.1:xxxx(例如：7890)
# or
# powershell终端
$Env:HTTP_PROXY  = "http://127.0.0.1:xxxx(例如：7890)"
$Env:HTTPS_PROXY = "http://127.0.0.1:xxxx(例如：7890)"
# 关于端口号说明：端口取自vpn的端口号
# 测试代理
curl -I https://expo.dev
or
Invoke-WebRequest -Uri https://expo.dev -Method Head//查看StatusCode 200
# 登录账号
eas login//输入账号和密码
# 构建 开发版的自定义客户端
eas build --platform android --profile development

指令汇总

终端	命令
CMD	set http_proxy=http://127.0.0.1:7890
PowerShell	$Env:HTTP_PROXY = "http://127.0.0.1:7890"
网络测试	curl -I https://expo.dev 或 Invoke-WebRequest -Uri https://expo.dev -Method Head

3. eas.json配置 添加代理

  {
    "cli": {
      "version": ">= 16.17.4",
      "appVersionSource": "remote"
    },
    "build": {
      "development": {
        "developmentClient": true,
        "distribution": "internal",
        "android": { "buildType": "apk" },
        "env": {
          "HTTP_PROXY": "http://192.168.1.xxx:aaa",// xxx:通过ipconfig查看 aaa：vpn的代理的端口
          "HTTPS_PROXY": "http://192.168.1.100:7890"//
          // 不使用代理
          // "NO_PROXY": "localhost,127.0.0.1,.local,.internal"
          }
      },
      "preview": {
        "distribution": "internal"
      },
      "production": {
        "autoIncrement": true
      }
    },
    "submit": {
      "production": {}
    }
    }
  ```

4. 在 Windows 终端里重新给 EAS CLI 配代理

# 先清空旧代理
 Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue
 Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue

 # 再写入正确的端口（假设是 7890）
 $Env:HTTP_PROXY  = "http://127.0.0.1:7890"
 $Env:HTTPS_PROXY = "http://127.0.0.1:7890"

 # 测试网络
 irm -Method Head -Uri https://expo.dev | Select-Object StatusCode
 # 返回 200 即可

5. 重新登录

eas logout   # 清掉旧会话
eas login    # 现在会走 7890

6. 再次构建

# 构建 android 开发版
eas build --platform android --profile development

四、关于自定义客户端调试问题

• 真机安装：构建的包通过expo仪表盘下载到手机上，然后安装
• 调试启动 Metro 服务器 ：npx expo start --dev-client

总结

以上即为通过代理构建自定义客户端的完整流程，涵盖常见问题及解决方案。亲测有效，但耗时较长，建议预留充足时间。