抢先体验仅限邀请,SDK 尚未发布。申请邀请
跳到正文
文档

环境

Debug 构建、TestFlight 和 App Store 发往同一个项目,每个事件都会注明来自哪个环境。

每个事件都带有 environment,因此一个项目可以同时容纳开发、测试和生产环境的事件,而不会混在一起。 控制台一次显示一个环境,或者全部环境。

名称

每个 SDK 用自己的方式命名环境(见下文)。如果你自己设置,任何其他名称也都可以:小写字母、数字、- 和 _, 最多 32 个字符,以字母或数字开头(staging、internal、staging-eu)。

各 SDK 如何检测环境

SDK检测方式
SwiftDebug 构建或模拟器上的任何构建为 development,从 TestFlight 安装的构建为 testflight,其他情况(App Store)为 production
Android应用可调试时(所有 debug 构建)为 development,否则为 production
React Native、Flutter沿用底层原生 SDK 的规则:iOS 上同 Swift,Android 上同 Android
JavaScript,浏览器主机为 localhost、127.0.0.1、[::1] 或 *.localhost 时为 development,其他任何地方为 production
JavaScript,NodeNODE_ENV=production 时为 production,否则为 development
Python、Go、JVM环境变量 LYRELOG_ENVIRONMENT,未设置时为 production

覆盖检测结果

在 SDK 的配置中设置 environment。在 Swift 中,nil 表示保留自动检测(Android 和 Flutter 中为 null, React Native 中为 undefined),因此你可以把它和自己的规则结合起来:

Lyrelog.start(Configuration(
    endpoint: URL(string: "https://ingest.lyrelog.com")!,
    apiKey: "lyr_ing_...",
    environment: isInternalTester ? "internal" : nil   // nil = detected
))

Lyrelog.detectedEnvironment 返回 Swift SDK 自行检测会选出的环境。

你自己运行的构建属于 development

从 Xcode 运行的构建、模拟器上的任何构建、Android debug 构建(包括通过 React Native 或 flutter run 运行的), 以及 localhost 上的网页,发送的都是 development。控制台默认打开 production,所以要看到你的第一批事件, 请在顶栏中选择 development(或 All environments)。

TestFlight 的检测读取的是构建的 App Store 收据:TestFlight 构建带有 sandbox 收据。你自己安装的 Release 构建 (ad hoc,或直接从 Xcode 以 Release 配置安装)没有收据,因此算作 production。如果这一点对你很重要,请自己设置 environment。

通过 HTTP 发送时,设置 resource.environment。未带环境的事件会按 production 存储。

在控制台中

顶栏中的选择器列出最近 30 天出现过的环境及各自的事件数,另外还有 All environments。你的选择按项目记在浏览器中。 在你选择之前,控制台会打开项目的默认环境:默认是 production,除非所有者在 Settings 中更改了它,也可以设为 All。所有与事件相关的页面都跟随这个选择器。参见 环境与平台。

Settings 中的 Environments 部分还会显示项目所含各平台的环境是如何确定的。