Hacktoberfest 2026：维护者为十月标记出来的 issue，仍然开放、适合新手。 浏览 Hacktoberfest issue

Add `scope.SetEnvironment`

未关闭
  • 哪里不对？
#5,769 1 条评论 0 个 reaction 已指派 1 人 在 GitHub 查看

维护者通常 1 天内回复

@bitsandfoxes 已经在做这个了。

开始于 2026年7月20日。

评估

这个 Issue 还没有评估数据。

描述

Feature Java Platform: Java

Proposal: Allow setting Environment on the Scope

Unblocks

Summary

Add getEnvironment() / setEnvironment(String) to sentry-java's IScope, so other SDKs (hybrid SDKs like .NET, Godot, Unity, Unreal, React Native?) and end users can set the Environment on the scope at runtime. This lifts the restriction of having to provide it strictly at init via SentryOptions.setEnvironment(...).

This brings sentry-java to parity with sentry-cocoa and sentry-native. These already expose a scope-/runtime-level environment setter.

Motivation

Today environment in sentry-java lives only on SentryOptions, fixed at init time. Any hybrid SDKs layered on top either manage their own environment or provide a way for users to modify it at runtime. This creates the need to sync it into the Java layer at runtime. That way events, and persisted (background/ANR/NDK) events, carry the correct value.

Both reference SDKs already support this:

SDK API Level Getter?
cocoa - (void)setEnvironment:(NSString *)environment on Scope scope no
native sentry_set_environment(const char *environment) (+ _n) global scope no
java (proposed) IScope.setEnvironment(String) + getEnvironment() scope yes

Proposed API (sentry-java)

public interface IScope {
  // ...
  @Nullable String getEnvironment();

  /**
   * Sets the Scope's environment. Takes precedence over SentryOptions#getEnvironment()
   * when applied to events. Mainly used by hybrid SDKs to sync their environment.
   */
  void setEnvironment(@Nullable String environment);
}

Reached by users/hybrid SDKs the same way as other scope mutations:

Sentry.configureScope(scope -> scope.setEnvironment("staging"));

Unlike cocoa, we could also add a getter, consistent with other Java scope fields like getTransactionName, and getUser e.t.c. and required by the combined-scope view.

API References

sentry-cocoa

  • SentryScope.h - (void)setEnvironment:(NSString *_Nullable)environment;
  • SentryScope.m - sets environmentString, then notifies scope observers.
  • SentryScope::applyToEvent - odering & backfill
  • Usage: SentrySDK.configureScope { $0.setEnvironment("staging") }

sentry-native

Precedence of application

Effective order from top to bottom: "environment set on the event itself" > scope > options**

  • SentryClient.applyScope: applies scope environment to the event only when the event has none.
  • MainEventProcessor.setEnvironment: later fallback to options.getEnvironment() when still unset

This matches the precedence used by cocoa and native.

Known gap / suggested follow-up

The Android AEI/ANR backfill processor reads environment only from the options cache, not the scope cache:

So a scope-set environment is persisted (via the new PersistingScopeObserver file) but is not picked up when backfilling exit-info events.
This could be resolved by reading the scope file first?

主要语言
Kotlin
星标
1.4k
派生
478
平均合并
2 天 15 小时
30 天内合并 PR
65

环境准备

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

getsentry/sentry-java 的其他 Issue

查看 getsentry/sentry-java 的全部 Issue

相似的 Issue

更多 Kotlin Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。