sentry-cli 2.57.0__tar.gz → 2.58.0__tar.gz

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/Cargo.lock

@@ -2726,7 +2726,7 @@ dependencies = [
 
 [[package]]
 name = "sentry-cli"
-version = "2.57.0"
+version = "2.58.0"
 dependencies = [
  "anyhow",
  "anylog",

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/Cargo.toml

@@ -2,7 +2,7 @@
 authors = ["Armin Ronacher <armin.ronacher@active-4.com>"]
 build = "build.rs"
 name = "sentry-cli"
-version = "2.57.0"
+version = "2.58.0"
 edition = "2021"
 rust-version = "1.86"
 

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sentry_cli
-Version: 2.57.0
+Version: 2.58.0
 Summary: A command line utility to work with Sentry.
 Home-page: https://github.com/getsentry/sentry-cli
 Author: Sentry

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/apple-catalog-parsing/native/swift/AssetCatalogParser/Sources/AssetCatalogParser/AssetCatalogReader.swift

@@ -38,6 +38,8 @@ struct AssetCatalogEntry: Encodable {
     let height: Int?
     let filename: String?
     let type: AssetType?
+    let idiom: String?
+    let colorspace: String?
 }
 
 enum Error: Swift.Error {
@@ -48,7 +50,40 @@ typealias objectiveCMethodImp = @convention(c) (AnyObject, Selector, UnsafeRawPo
     AnyObject
 >?
 
+private struct MultisizeSetInfo {
+    let name: String
+    let element: UInt
+    let part: UInt
+    let identifier: UInt
+    let sizeIndexes: [(idiom: UInt, subtype: UInt)]
+}
+
 enum AssetUtil {
+    private static func idiomToString(_ idiom: UInt?) -> String? {
+        guard let idiom = idiom else { return nil }
+        switch idiom {
+        case 0: return "universal"
+        case 1: return "phone"
+        case 2: return "pad"
+        case 3: return "tv"
+        case 4: return "carplay"
+        case 5: return "watch"
+        case 6: return "marketing"
+        default: return nil
+        }
+    }
+    
+    private static func colorSpaceIDToString(_ colorSpaceID: UInt?) -> String? {
+        guard let colorSpaceID = colorSpaceID else { return nil }
+        switch colorSpaceID {
+        case 1: return "srgb"
+        case 2: return "gray gamma 22"
+        case 3: return "displayP3"
+        case 4: return "extended srgb"
+        default: return nil
+        }
+    }
+    
     private static func createResultsPath(assetURL: URL, outputURL: URL) throws -> URL {
         var archiveURL = assetURL
         var tailComponents: [String] = []
@@ -78,8 +113,12 @@ enum AssetUtil {
         let (structuredThemeStore, assetKeys) = initializeCatalog(from: file)
 
         var images: [String: (cgImage: CGImage, format: String)] = [:]
-
-        for key in assetKeys {
+        
+        // First pass: Build map of multisize sets and cache renditions for performance
+        var multisizeSets: [MultisizeSetInfo] = []
+        var renditionCache: [Int: NSObject] = [:]
+        
+        for (index, key) in assetKeys.enumerated() {
             let keyList = unsafeBitCast(
                 key.perform(Selector(("keyList"))),
                 to: UnsafeMutableRawPointer.self
@@ -87,6 +126,49 @@ enum AssetUtil {
             guard let rendition = createRendition(from: structuredThemeStore, keyList) else {
                 continue
             }
+            renditionCache[index] = rendition
+            
+            let type = rendition.getUInt(forKey: "type") ?? 0
+            if type == 1010 {  // Multisize image set
+                let renditionTypeName = rendition.perform(Selector(("name"))).takeUnretainedValue() as! String
+                let keyElement = key.getUInt(forKey: "themeElement") ?? 0
+                let keyPart = key.getUInt(forKey: "themePart") ?? 0
+                let keyIdentifier = key.getUInt(forKey: "themeIdentifier") ?? 0
+                
+                // Extract size indexes to identify which images belong to this set
+                var sizeIndexes: [(idiom: UInt, subtype: UInt)] = []
+                if rendition.responds(to: Selector(("sizeIndexes"))),
+                   let sizeIndexesResult = rendition.perform(Selector(("sizeIndexes"))),
+                   let sizeIndexesArray = sizeIndexesResult.takeUnretainedValue() as? NSArray {
+                    for sizeIndexObj in sizeIndexesArray {
+                        if let obj = sizeIndexObj as? NSObject {
+                            let idiom = obj.getUInt(forKey: "idiom") ?? 0
+                            let subtype = obj.getUInt(forKey: "subtype") ?? 0
+                            sizeIndexes.append((idiom: idiom, subtype: subtype))
+                        }
+                    }
+                }
+                
+                multisizeSets.append(MultisizeSetInfo(
+                    name: renditionTypeName,
+                    element: keyElement,
+                    part: keyPart,
+                    identifier: keyIdentifier,
+                    sizeIndexes: sizeIndexes
+                ))
+            }
+        }
+
+        // Second pass: Process all assets using cached renditions
+        for (index, key) in assetKeys.enumerated() {
+            guard let rendition = renditionCache[index] else {
+                continue
+            }
+            
+            let keyList = unsafeBitCast(
+                key.perform(Selector(("keyList"))),
+                to: UnsafeMutableRawPointer.self
+            )
 
             let data = rendition.value(forKey: "_srcData") as! Data
             let length = UInt(data.count)
@@ -126,26 +208,50 @@ enum AssetUtil {
             let type = rendition.getUInt(forKey: "type") ?? 0
 
             let isVector = type == 9
-            let (width, height, unslicedImage) = resolveImageDimensions(rendition, isVector)
+            let isMultisizeImageSet = type == 1010
             let assetType = determineAssetType(key)
             let imageId = UUID().uuidString
-            
             let fileExtension = (renditionTypeName as NSString).pathExtension.lowercased()
             
-            // Skip files without an extension or SVGs
-            if !fileExtension.isEmpty && fileExtension != "svg", let unslicedImage = unslicedImage {
-                images[imageId] = (cgImage: unslicedImage, format: fileExtension)
+            var width: Int?
+            var height: Int?
+            var unslicedImage: CGImage?
+            
+            if isMultisizeImageSet {
+                continue
+            } else {
+                // Get image dimensions from regular rendition
+                (width, height, unslicedImage) = resolveImageDimensions(rendition, isVector)
+                
+                // Skip SVGs, but save images even if they don't have an extension (default to png)
+                if fileExtension != "svg", let unslicedImage = unslicedImage {
+                    let format = fileExtension.isEmpty ? "png" : fileExtension
+                    images[imageId] = (cgImage: unslicedImage, format: format)
+                }
+            }
+            
+            let idiomValue = key.getUInt(forKey: "themeIdiom")
+            let colorSpaceID = rendition.getUInt(forKey: "colorSpaceID")
+            
+            // Include multisize set name in the name field if it exists
+            let finalName: String
+            if let setName = findMultisizeSetName(key, in: multisizeSets) {
+                finalName = "\(setName)/\(name)"
+            } else {
+                finalName = name
             }
 
             let asset = AssetCatalogEntry(
                 imageId: imageId,
                 size: length,
-                name: name,
+                name: finalName,
                 vector: isVector,
                 width: width,
                 height: height,
                 filename: renditionTypeName,
-                type: assetType
+                type: assetType,
+                idiom: idiomToString(idiomValue),
+                colorspace: colorSpaceIDToString(colorSpaceID)
             )
             assets.append(asset)
         }
@@ -158,7 +264,9 @@ enum AssetUtil {
             width: nil,
             height: nil,
             filename: nil,
-            type: nil
+            type: nil,
+            idiom: nil,
+            colorspace: nil
         ))
 
         let data = try! JSONEncoder().encode(assets)
@@ -254,6 +362,30 @@ enum AssetUtil {
         }
         return .image
     }
+    
+    private static func findMultisizeSetName(
+        _ key: NSObject,
+        in multisizeSets: [MultisizeSetInfo]
+    ) -> String? {
+        let element = key.getUInt(forKey: "themeElement") ?? 0
+        let identifier = key.getUInt(forKey: "themeIdentifier") ?? 0
+        let idiom = key.getUInt(forKey: "themeIdiom") ?? 0
+        let subtype = key.getUInt(forKey: "themeSubtype") ?? 0
+        
+        for setInfo in multisizeSets {
+            guard setInfo.element == element,
+                  setInfo.identifier == identifier else {
+                continue
+            }
+            
+            for sizeIndex in setInfo.sizeIndexes {
+                if sizeIndex.idiom == idiom && sizeIndex.subtype == subtype {
+                    return setInfo.name
+                }
+            }
+        }
+        return nil
+    }
 
     private static func resolveRenditionName(
         _ structuredThemeStore: NSObject,

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/sentry_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sentry_cli
-Version: 2.57.0
+Version: 2.58.0
 Summary: A command line utility to work with Sentry.
 Home-page: https://github.com/getsentry/sentry-cli
 Author: Sentry

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/api/data_types/chunking/upload/capability.rs

@@ -36,6 +36,9 @@ pub enum ChunkUploadCapability {
     /// Upload of preprod artifacts
     PreprodArtifacts,
 
+    /// Upload of ProGuard mappings
+    Proguard,
+
     /// Any other unsupported capability (ignored)
     Unknown,
 }
@@ -57,6 +60,7 @@ impl<'de> Deserialize<'de> for ChunkUploadCapability {
             "il2cpp" => ChunkUploadCapability::Il2Cpp,
             "dartsymbolmap" => ChunkUploadCapability::DartSymbolMap,
             "preprod_artifacts" => ChunkUploadCapability::PreprodArtifacts,
+            "proguard" => ChunkUploadCapability::Proguard,
             _ => ChunkUploadCapability::Unknown,
         })
     }

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/api/data_types/chunking/upload/options.rs

@@ -1,3 +1,5 @@
+use std::num::NonZeroUsize;
+
 use serde::Deserialize;
 
 use super::{ChunkCompression, ChunkHashAlgorithm, ChunkUploadCapability};
@@ -17,7 +19,7 @@ pub struct ChunkServerOptions {
     pub max_wait: u64,
     #[expect(dead_code)]
     pub hash_algorithm: ChunkHashAlgorithm,
-    pub chunk_size: u64,
+    pub chunk_size: NonZeroUsize,
     pub concurrency: u8,
     #[serde(default)]
     pub compression: Vec<ChunkCompression>,

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/commands/build/mod.rs

@@ -21,24 +21,16 @@ pub fn make_command(mut command: Command) -> Command {
     }
 
     command = command
-        .about("[EXPERIMENTAL] Manage builds.")
+        .about("Manage builds.")
         .subcommand_required(true)
         .arg_required_else_help(true)
         .org_arg()
-        .project_arg(true)
-        // TODO: Remove this when ready for release
-        .hide(true);
+        .project_arg(true);
     each_subcommand!(add_subcommand);
     command
 }
 
 pub fn execute(matches: &ArgMatches) -> Result<()> {
-    log::warn!(
-        "EXPERIMENTAL: The build subcommand is experimental. \
-        The command is subject to breaking changes and may be removed \
-        without notice in any release."
-    );
-
     macro_rules! execute_subcommand {
         ($name:ident) => {{
             if let Some(sub_matches) =

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/commands/build/upload.rs

@@ -17,7 +17,9 @@ use crate::config::Config;
 use crate::utils::args::ArgExt as _;
 #[cfg(all(target_os = "macos", target_arch = "aarch64"))]
 use crate::utils::build::{handle_asset_catalogs, ipa_to_xcarchive, is_apple_app, is_ipa_file};
-use crate::utils::build::{is_aab_file, is_apk_file, is_zip_file, normalize_directory};
+use crate::utils::build::{
+    is_aab_file, is_apk_file, is_zip_file, normalize_directory, write_version_metadata,
+};
 use crate::utils::chunks::{upload_chunks, Chunk};
 use crate::utils::fs::get_sha1_checksums;
 use crate::utils::fs::TempDir;
@@ -37,7 +39,7 @@ pub fn make_command(command: Command) -> Command {
     const HELP_TEXT: &str =
         "The path to the build to upload. Supported files include Apk, and Aab.";
     command
-        .about("[EXPERIMENTAL] Upload builds to a project.")
+        .about("Upload builds to a project.")
         .org_arg()
         .project_arg(false)
         .arg(
@@ -113,7 +115,7 @@ pub fn execute(matches: &ArgMatches) -> Result<()> {
         .get_one("head_sha")
         .map(String::as_str)
         .map(Cow::Borrowed)
-        .or_else(|| vcs::find_head().ok().map(Cow::Owned));
+        .or_else(|| vcs::find_head_sha().ok().map(Cow::Owned));
 
     let cached_remote = config.get_cached_vcs_remote();
     // Try to open the git repository and find the remote, but handle errors gracefully.
@@ -233,7 +235,7 @@ pub fn execute(matches: &ArgMatches) -> Result<()> {
         .map(String::as_str)
         .map(Cow::Borrowed)
         .or_else(|| {
-            vcs::find_base_sha()
+            vcs::find_base_sha(&cached_remote)
                 .inspect_err(|e| debug!("Error finding base SHA: {e}"))
                 .ok()
                 .flatten()
@@ -455,6 +457,8 @@ fn normalize_file(path: &Path, bytes: &[u8]) -> Result<TempFile> {
     zip.start_file(file_name, options)?;
     zip.write_all(bytes)?;
 
+    write_version_metadata(&mut zip)?;
+
     zip.finish()?;
     debug!("Successfully created normalized zip for file");
     Ok(temp_file)
@@ -507,10 +511,10 @@ fn upload_file(
     pb.enable_steady_tick(100);
     pb.set_style(progress_style);
 
-    let chunk_size = chunk_upload_options.chunk_size as usize;
-    let (checksum, checksums) = get_sha1_checksums(bytes, chunk_size)?;
+    let chunk_size = chunk_upload_options.chunk_size;
+    let (checksum, checksums) = get_sha1_checksums(bytes, chunk_size);
     let mut chunks = bytes
-        .chunks(chunk_size)
+        .chunks(chunk_size.into())
         .zip(checksums.iter())
         .map(|(data, checksum)| Chunk((*checksum, data)))
         .collect::<Vec<_>>();

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/commands/dart_symbol_map/upload.rs

@@ -159,7 +159,7 @@ pub(super) fn execute(args: DartSymbolMapUploadArgs) -> Result<()> {
             let options = ChunkOptions::new(chunk_upload_options, org, project)
                 .with_max_wait(DEFAULT_MAX_WAIT);
 
-            let chunked = Chunked::from(object, options.server_options().chunk_size as usize)?;
+            let chunked = Chunked::from(object, options.server_options().chunk_size);
             let (_uploaded, has_processing_errors) = upload_chunked_objects(&[chunked], options)?;
             if has_processing_errors {
                 bail!("Some symbol maps did not process correctly");

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/commands/debug_files/bundle_jvm.rs

@@ -65,7 +65,6 @@ pub fn execute(matches: &ArgMatches) -> Result<()> {
         note: None,
         wait: true,
         max_wait: DEFAULT_MAX_WAIT,
-        dedupe: false,
         chunk_upload_options: chunk_upload_options.as_ref(),
     };
     let path = matches.get_one::<PathBuf>("path").unwrap();

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/commands/files/upload.rs

@@ -159,7 +159,6 @@ pub fn execute(matches: &ArgMatches) -> Result<()> {
         note: None,
         wait,
         max_wait,
-        dedupe: false,
         chunk_upload_options: chunk_upload_options.as_ref(),
     };
 

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/commands/react_native/appcenter.rs

@@ -202,7 +202,6 @@ pub fn execute(matches: &ArgMatches) -> Result<()> {
                 note: None,
                 wait,
                 max_wait,
-                dedupe: false,
                 chunk_upload_options: chunk_upload_options.as_ref(),
             })?;
         }
@@ -221,7 +220,6 @@ pub fn execute(matches: &ArgMatches) -> Result<()> {
                     note: None,
                     wait,
                     max_wait,
-                    dedupe: false,
                     chunk_upload_options: chunk_upload_options.as_ref(),
                 })?;
             }

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/commands/react_native/gradle.rs

@@ -129,7 +129,6 @@ pub fn execute(matches: &ArgMatches) -> Result<()> {
                 note: None,
                 wait,
                 max_wait,
-                dedupe: false,
                 chunk_upload_options: chunk_upload_options.as_ref(),
             })?;
         }
@@ -143,7 +142,6 @@ pub fn execute(matches: &ArgMatches) -> Result<()> {
             note: None,
             wait,
             max_wait,
-            dedupe: false,
             chunk_upload_options: chunk_upload_options.as_ref(),
         })?;
     }

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/commands/react_native/xcode.rs

@@ -351,7 +351,6 @@ pub fn execute(matches: &ArgMatches) -> Result<()> {
             note: None,
             wait,
             max_wait,
-            dedupe: false,
             chunk_upload_options: chunk_upload_options.as_ref(),
         })?;
     } else {
@@ -387,7 +386,6 @@ pub fn execute(matches: &ArgMatches) -> Result<()> {
                     note: None,
                     wait,
                     max_wait,
-                    dedupe: false,
                     chunk_upload_options: chunk_upload_options.as_ref(),
                 })?;
             }
@@ -401,7 +399,6 @@ pub fn execute(matches: &ArgMatches) -> Result<()> {
                         note: None,
                         wait,
                         max_wait,
-                        dedupe: false,
                         chunk_upload_options: chunk_upload_options.as_ref(),
                     })?;
                 }

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/commands/sourcemaps/upload.rs

@@ -193,11 +193,8 @@ pub fn make_command(command: Command) -> Command {
             Arg::new("no_dedupe")
                 .long("no-dedupe")
                 .action(ArgAction::SetTrue)
-                .help(
-                    "Skip artifacts deduplication prior to uploading. \
-                    This will force all artifacts to be uploaded, \
-                    no matter whether they are already present on the server.",
-                ),
+                .hide(true)
+                .help("[DEPRECATED] This flag has no effect and is scheduled for removal."),
         )
         .arg(
             Arg::new("extensions")
@@ -419,6 +416,13 @@ fn process_sources_from_paths(
 }
 
 pub fn execute(matches: &ArgMatches) -> Result<()> {
+    if matches.get_flag("no_dedupe") {
+        log::warn!(
+            "[DEPRECATION NOTICE] The --no-dedupe flag is deprecated and has no \
+            effect. It will be removed in the next major version."
+        );
+    }
+
     let config = Config::current();
     let version = config.get_release_with_legacy_fallback(matches).ok();
     let org = config.get_org(matches)?;
@@ -457,7 +461,6 @@ pub fn execute(matches: &ArgMatches) -> Result<()> {
         note: matches.get_one::<String>("note").map(String::as_str),
         wait,
         max_wait,
-        dedupe: !matches.get_flag("no_dedupe"),
         chunk_upload_options: chunk_upload_options.as_ref(),
     };
 

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/commands/upload_proguard.rs

@@ -85,12 +85,13 @@ pub fn make_command(command: Command) -> Command {
         )
         .arg(
             Arg::new("platform")
+                .hide(true)
                 .long("platform")
                 .value_name("PLATFORM")
                 .requires("app_id")
                 .help(
-                    "Optionally defines the platform for the app association. \
-                     [defaults to 'android']",
+                    "[DEPRECATED] This flag is a no-op, scheduled \
+                    for removal in Sentry CLI 3.0.0.",
                 ),
         )
         .arg(
@@ -110,7 +111,10 @@ pub fn make_command(command: Command) -> Command {
                 .value_name("PATH")
                 .conflicts_with("app_id")
                 .hide(true)
-                .help("Read version and version code from an Android manifest file."),
+                .help(
+                    "[DEPRECATED] This flag is a no-op, scheduled \
+                    for removal in Sentry CLI 3.0.0.",
+                ),
         )
         .arg(
             Arg::new("write_properties")
@@ -145,6 +149,22 @@ pub fn make_command(command: Command) -> Command {
 }
 
 pub fn execute(matches: &ArgMatches) -> Result<()> {
+    if matches.get_one::<String>("platform").is_some() {
+        log::warn!(
+            "[DEPRECATION NOTICE] The --platform argument is deprecated, \
+            and is scheduled for removal in Sentry CLI 3.0.0. \
+            The argument is a no-op."
+        );
+    }
+
+    if matches.get_one::<String>("android_manifest").is_some() {
+        log::warn!(
+            "[DEPRECATION NOTICE] The --android-manifest argument is deprecated, \
+            and is scheduled for removal in Sentry CLI 3.0.0. \
+            The argument is a no-op."
+        );
+    }
+
     let paths: Vec<_> = match matches.get_many::<String>("paths") {
         Some(paths) => paths.collect(),
         None => {
@@ -194,6 +214,9 @@ pub fn execute(matches: &ArgMatches) -> Result<()> {
         }
     }
 
+    // We are done constructing the mappings, redeclare as immutable.
+    let mappings = mappings;
+
     let api = Api::current();
     let config = Config::current();
 

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/utils/build/mod.rs

@@ -5,7 +5,7 @@ mod validation;
 
 #[cfg(all(target_os = "macos", target_arch = "aarch64"))]
 pub use self::apple::{handle_asset_catalogs, ipa_to_xcarchive};
-pub use self::normalize::normalize_directory;
+pub use self::normalize::{normalize_directory, write_version_metadata};
 pub use self::validation::{is_aab_file, is_apk_file, is_zip_file};
 #[cfg(all(target_os = "macos", target_arch = "aarch64"))]
 pub use self::validation::{is_apple_app, is_ipa_file};

{sentry_cli-2.57.0 → sentry_cli-2.58.0}/src/utils/build/normalize.rs

@@ -1,3 +1,4 @@
+use std::borrow::Cow;
 #[cfg(not(windows))]
 use std::fs;
 use std::fs::File;
@@ -6,8 +7,9 @@ use std::io::Write as _;
 use std::os::unix::fs::PermissionsExt as _;
 use std::path::{Path, PathBuf};
 
+use crate::constants::VERSION;
 use crate::utils::fs::TempFile;
-use anyhow::Result;
+use anyhow::{Context as _, Result};
 use itertools::Itertools as _;
 use log::debug;
 use symbolic::common::ByteView;
@@ -15,6 +17,14 @@ use walkdir::WalkDir;
 use zip::write::SimpleFileOptions;
 use zip::{DateTime, ZipWriter};
 
+fn get_version() -> Cow<'static, str> {
+    // Integration tests can override the version for consistent test results.
+    // This ensures deterministic checksums in test fixtures by using a fixed version.
+    std::env::var("SENTRY_CLI_INTEGRATION_TEST_VERSION_OVERRIDE")
+        .map(Cow::Owned)
+        .unwrap_or(Cow::Borrowed(VERSION))
+}
+
 fn sort_entries(path: &Path) -> Result<impl Iterator<Item = (PathBuf, PathBuf)>> {
     Ok(WalkDir::new(path)
         .into_iter()
@@ -61,10 +71,12 @@ fn add_entries_to_zip(
             let target_str = target.to_string_lossy();
 
             // Create a symlink entry in the zip
-            zip.add_symlink(zip_path, &target_str, options)?;
+            zip.add_symlink(zip_path.as_str(), &target_str, options)
+                .with_context(|| format!("Failed to add symlink '{zip_path}' to zip archive"))?;
         } else {
             // Handle regular files
-            zip.start_file(zip_path, options)?;
+            zip.start_file(zip_path.as_str(), options)
+                .with_context(|| format!("Failed to add file '{zip_path}' to zip archive"))?;
             let file_byteview = ByteView::open(&entry_path)?;
             zip.write_all(file_byteview.as_slice())?;
         }
@@ -74,6 +86,21 @@ fn add_entries_to_zip(
     Ok(file_count)
 }
 
+fn metadata_file_options() -> SimpleFileOptions {
+    SimpleFileOptions::default()
+        .compression_method(zip::CompressionMethod::Deflated)
+        .last_modified_time(DateTime::default())
+}
+
+pub fn write_version_metadata<W: std::io::Write + std::io::Seek>(
+    zip: &mut ZipWriter<W>,
+) -> Result<()> {
+    let version = get_version();
+    zip.start_file(".sentry-cli-metadata.txt", metadata_file_options())?;
+    writeln!(zip, "sentry-cli-version: {version}")?;
+    Ok(())
+}
+
 // For XCArchive directories, we'll zip the entire directory
 // It's important to not change the contents of the directory or the size
 // analysis will be wrong and the code signature will break.
@@ -106,6 +133,8 @@ pub fn normalize_directory(path: &Path, parsed_assets_path: &Path) -> Result<Tem
         )?;
     }
 
+    write_version_metadata(&mut zip)?;
+
     zip.finish()?;
     debug!("Successfully created normalized zip for directory with {file_count} files");
     Ok(temp_file)