feat(core): Support SENTRY_ENVIRONMENT in bare React Native builds

Read SENTRY_ENVIRONMENT env variable during the sentry.options.json
copy step in both Gradle and Xcode build scripts, overriding the
environment value in the destination copy without modifying the source.

Closes #5779

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: antonis

packages/core/scripts/sentry-xcode.sh

@@ -100,7 +100,17 @@ if [ "$SENTRY_COPY_OPTIONS_FILE" = true ]; then
   elif [ ! -f "$SENTRY_OPTIONS_FILE_PATH" ]; then
     echo "[Sentry] $SENTRY_OPTIONS_FILE_PATH not found. $SENTRY_OPTIONS_FILE_ERROR_MESSAGE_POSTFIX" 1>&2
   else
-    cp "$SENTRY_OPTIONS_FILE_PATH" "$SENTRY_OPTIONS_FILE_DESTINATION_PATH"
+    if [ -n "$SENTRY_ENVIRONMENT" ]; then
+      "$LOCAL_NODE_BINARY" -e "
+        var fs = require('fs');
+        var opts = JSON.parse(fs.readFileSync('$SENTRY_OPTIONS_FILE_PATH', 'utf8'));
+        opts.environment = process.env.SENTRY_ENVIRONMENT;
+        fs.writeFileSync('$SENTRY_OPTIONS_FILE_DESTINATION_PATH', JSON.stringify(opts));
+      "
+      echo "[Sentry] Overriding 'environment' from SENTRY_ENVIRONMENT environment variable"
+    else
+      cp "$SENTRY_OPTIONS_FILE_PATH" "$SENTRY_OPTIONS_FILE_DESTINATION_PATH"
+    fi
     echo "[Sentry] Copied $SENTRY_OPTIONS_FILE_PATH to $SENTRY_OPTIONS_FILE_DESTINATION_PATH"
   fi
 fi

packages/core/sentry.gradle

@@ -39,10 +39,18 @@ tasks.register("copySentryJsonConfiguration") {
                 androidAssetsDir.mkdirs()
             }
 
-            copy {
-                from sentryOptionsFile
-                into androidAssetsDir
-                rename { String fileName -> configFile }
+            def sentryEnv = System.getenv('SENTRY_ENVIRONMENT')
+            if (sentryEnv) {
+                def content = new groovy.json.JsonSlurper().parseText(sentryOptionsFile.text)
+                content.environment = sentryEnv
+                new File(androidAssetsDir, configFile).text = groovy.json.JsonOutput.toJson(content)
+                logger.lifecycle("Overriding 'environment' from SENTRY_ENVIRONMENT environment variable")
+            } else {
+                copy {
+                    from sentryOptionsFile
+                    into androidAssetsDir
+                    rename { String fileName -> configFile }
+                }
             }
             logger.lifecycle("Copied ${configFile} to Android assets")
         } else {

packages/core/test/scripts/sentry-xcode-scripts.test.ts

@@ -455,6 +455,80 @@ describe('sentry-xcode.sh', () => {
     expect(result.stdout).toContain('skipping sourcemaps upload');
   });
 
+  describe('sentry.options.json SENTRY_ENVIRONMENT override', () => {
+    it('copies file without modification when SENTRY_ENVIRONMENT is not set', () => {
+      const optionsContent = JSON.stringify({ dsn: 'https://key@sentry.io/123', environment: 'production' });
+      const optionsFile = path.join(tempDir, 'sentry.options.json');
+      fs.writeFileSync(optionsFile, optionsContent);
+
+      const buildDir = path.join(tempDir, 'build');
+      const resourcesPath = 'Resources';
+      fs.mkdirSync(path.join(buildDir, resourcesPath), { recursive: true });
+
+      const result = runScript({
+        SENTRY_DISABLE_AUTO_UPLOAD: 'true',
+        SENTRY_COPY_OPTIONS_FILE: 'true',
+        SENTRY_OPTIONS_FILE_PATH: optionsFile,
+        CONFIGURATION_BUILD_DIR: buildDir,
+        UNLOCALIZED_RESOURCES_FOLDER_PATH: resourcesPath,
+      });
+
+      expect(result.exitCode).toBe(0);
+      const destPath = path.join(buildDir, resourcesPath, 'sentry.options.json');
+      const copied = JSON.parse(fs.readFileSync(destPath, 'utf8'));
+      expect(copied.dsn).toBe('https://key@sentry.io/123');
+      expect(copied.environment).toBe('production');
+    });
+
+    it('overrides environment from SENTRY_ENVIRONMENT env var', () => {
+      const optionsContent = JSON.stringify({ dsn: 'https://key@sentry.io/123', environment: 'production' });
+      const optionsFile = path.join(tempDir, 'sentry.options.json');
+      fs.writeFileSync(optionsFile, optionsContent);
+
+      const buildDir = path.join(tempDir, 'build');
+      const resourcesPath = 'Resources';
+      fs.mkdirSync(path.join(buildDir, resourcesPath), { recursive: true });
+
+      const result = runScript({
+        SENTRY_DISABLE_AUTO_UPLOAD: 'true',
+        SENTRY_COPY_OPTIONS_FILE: 'true',
+        SENTRY_OPTIONS_FILE_PATH: optionsFile,
+        CONFIGURATION_BUILD_DIR: buildDir,
+        UNLOCALIZED_RESOURCES_FOLDER_PATH: resourcesPath,
+        SENTRY_ENVIRONMENT: 'staging',
+      });
+
+      expect(result.exitCode).toBe(0);
+      expect(result.stdout).toContain('Overriding');
+      const destPath = path.join(buildDir, resourcesPath, 'sentry.options.json');
+      const copied = JSON.parse(fs.readFileSync(destPath, 'utf8'));
+      expect(copied.environment).toBe('staging');
+      expect(copied.dsn).toBe('https://key@sentry.io/123');
+    });
+
+    it('does not modify the source sentry.options.json', () => {
+      const optionsContent = JSON.stringify({ dsn: 'https://key@sentry.io/123', environment: 'production' });
+      const optionsFile = path.join(tempDir, 'sentry.options.json');
+      fs.writeFileSync(optionsFile, optionsContent);
+
+      const buildDir = path.join(tempDir, 'build');
+      const resourcesPath = 'Resources';
+      fs.mkdirSync(path.join(buildDir, resourcesPath), { recursive: true });
+
+      runScript({
+        SENTRY_DISABLE_AUTO_UPLOAD: 'true',
+        SENTRY_COPY_OPTIONS_FILE: 'true',
+        SENTRY_OPTIONS_FILE_PATH: optionsFile,
+        CONFIGURATION_BUILD_DIR: buildDir,
+        UNLOCALIZED_RESOURCES_FOLDER_PATH: resourcesPath,
+        SENTRY_ENVIRONMENT: 'staging',
+      });
+
+      const source = JSON.parse(fs.readFileSync(optionsFile, 'utf8'));
+      expect(source.environment).toBe('production');
+    });
+  });
+
   describe('SOURCEMAP_FILE path resolution', () => {
     // Returns a mock sentry-cli that prints the SOURCEMAP_FILE env var it received.
     const makeSourcemapEchoScript = (dir: string): string => {