EAS 中的环境变量

关于如何在构建、更新和工作流中使用 Expo Application Services (EAS) 环境变量的概述。

For the complete documentation index, see llms.txt. Use this Use this file to discover all available pages.

本指南说明了如何在 Expo Application Services（EAS）中使用环境变量：Build、Updates、Workflows 和 Hosting。有关环境变量在 Expo 框架中如何工作的通用信息，请参阅 Expo 中的环境变量。

在本地开发期间，环境变量会从本地 .env 或 .env.local 文件中加载。此类文件通常会被排除在项目的版本控制之外（也就是说，如果它们被列在 .gitignore 文件中，或者没有提交），因此对于在远程服务器上运行的任务不可用，例如 EAS Build 和 EAS Workflows。此外，大多数项目都有多个应用变体，并且需要多组环境变量（例如开发环境和生产环境）。

为什么使用 EAS 环境变量

如果你需要以下功能，可能会想使用 EAS 环境变量：

• 将云构建、更新和工作流的配置集中在一个地方，而无需提交 .env 文件。
• 按环境（development、preview、production）分离值，同时复用名称。
• 控制可见性（明文、敏感、密钥），以便只有正确的范围可以读取每个值。
• 通过 eas env:pull 或在 CI/CD 中本地应用相同的一组变量。

这些正是 EAS 环境变量要解决的问题。使用 EAS 环境变量时，变量可通过 EAS CLI 或直接在 expo.dev 控制台中配置，并且 EAS Build 和 EAS Workflows 以及你的本地机器都可以通过 EAS CLI 访问这些变量。

快速开始

{
  "build": {
    "production": {
      "environment": "production"
    }
  }
}

关键概念

可用环境

默认情况下，EAS 为环境变量支持三个环境：development、preview 和 production。自定义环境名称适用于 Enterprise 和 Production 套餐。

每个环境都是一组独立的变量，可用于在不同场景下自定义你的应用。例如，你可以为开发和生产使用不同的 API 密钥，或者为应用商店发布使用不同的 bundle 标识符。

每个 EAS Build 和 Workflows 任务都会使用某个可用环境中的环境变量运行。你也可以将环境用于更新，从而允许你为构建任务使用同一组环境变量。在发布更新时，请使用所需的 --environment 标志指定环境。

环境变量可以分配到多个环境中，并在所有环境中保持相同的值，也可以只为单个环境创建。

作用域

• 项目范围：仅属于单个 EAS 项目。你可以在项目控制台中导航到 Environment variables 页面来创建、查看和管理它们。这些环境变量可用于在 EAS 服务器上运行的任何任务，以及此项目的更新。如果其可见性设置允许，也可以将它们拉取到本地用于开发。
• 账户范围：在你的 EAS 账户中的所有项目中都可用。你可以在账户控制台中导航到 Environment variables 页面来创建、查看和管理它们。这些环境变量可与某个项目的项目范围变量一起，供在 EAS 服务器上运行的任务和更新使用。如果其 可见性设置 允许，也可以将它们拉取到本地或在 EAS 服务器之外读取。

变量类型

• 字符串：标准键值对，可用于构建、更新、工作流和托管。
• 文件：作为文件上传的值（例如 google-services.json 或证书），会在构建运行器上作为文件路径提供给任务使用。

环境变量的可见性设置

每个环境变量都有三种不同的可见性设置可用：

请注意，任何包含在客户端代码中的内容都应被视为公开内容，并且任何能够运行你应用的人都可以读取。

密钥类型的环境变量 旨在为 EAS Build 或 Workflows 任务提供值，以便它们可用于改变任务的运行方式。例如，设置 NPM_TOKEN 用于从 npm 安装私有包，或者设置 Sentry API 密钥用于创建发布并上传源映射。对于最终嵌入到应用本身中的值，密钥并不会提供任何额外的安全性。

接下来去哪里