refactor: centralize version configuration to reduce duplication

- Moved MARKETING_VERSION and CURRENT_PROJECT_VERSION to project-level configs
- Target configurations now inherit from project level (no more duplication)
- Added Version.xcconfig file for documentation
- Updated VERSIONING.md with clear instructions
- Now only need to update 2 places instead of 4 when changing versions

This makes version management less error-prone and easier to maintain.

Author: graycreate

V2er.xcodeproj/project.pbxproj

@@ -1061,12 +1061,14 @@
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
 				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
+				MARKETING_VERSION = 1.1.2;
 				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				ONLY_ACTIVE_ARCH = YES;
 				SDKROOT = iphoneos;
 				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
 				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
+				CURRENT_PROJECT_VERSION = 29;
 			};
 			name = Debug;
 		};
@@ -1116,12 +1118,14 @@
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
 				IPHONEOS_DEPLOYMENT_TARGET = 15.0;
+				MARKETING_VERSION = 1.1.2;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				MTL_FAST_MATH = YES;
 				SDKROOT = iphoneos;
 				SWIFT_COMPILATION_MODE = wholemodule;
 				SWIFT_OPTIMIZATION_LEVEL = "-O";
 				VALIDATE_PRODUCT = YES;
+				CURRENT_PROJECT_VERSION = 29;
 			};
 			name = Release;
 		};
@@ -1131,7 +1135,6 @@
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CODE_SIGN_IDENTITY = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 29;
 				DEVELOPMENT_ASSET_PATHS = "\"V2er/Preview Content\"";
 				DEVELOPMENT_TEAM = DZCZQ4694Z;
 				ENABLE_PREVIEWS = YES;
@@ -1143,7 +1146,6 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 1.1.2;
 				PRODUCT_BUNDLE_IDENTIFIER = v2er.app;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				PROVISIONING_PROFILE_SPECIFIER = "";
@@ -1158,7 +1160,6 @@
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				CODE_SIGN_IDENTITY = "Apple Development";
 				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 29;
 				DEVELOPMENT_ASSET_PATHS = "\"V2er/Preview Content\"";
 				DEVELOPMENT_TEAM = DZCZQ4694Z;
 				ENABLE_PREVIEWS = YES;
@@ -1170,7 +1171,6 @@
 					"$(inherited)",
 					"@executable_path/Frameworks",
 				);
-				MARKETING_VERSION = 1.1.2;
 				PRODUCT_BUNDLE_IDENTIFIER = v2er.app;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				PROVISIONING_PROFILE_SPECIFIER = "";

V2er/Config/Version.xcconfig

@@ -0,0 +1,12 @@
+// Version.xcconfig
+// Centralized version configuration for V2er iOS app
+//
+// To update versions, only modify these two lines:
+// VERSION_NAME: User-facing version (e.g., 1.1.2)
+// VERSION_CODE: Build number (must always increase)
+
+// VERSION_NAME - This is what users see (e.g., 1.1.2)
+MARKETING_VERSION = 1.1.2
+
+// VERSION_CODE - Internal build number (e.g., 29, 30, 31...)
+CURRENT_PROJECT_VERSION = 29

VERSIONING.md

@@ -16,20 +16,32 @@ This project uses two version identifiers:
 - **Format**: Integer that must always increase
 - **When to change**: Every single build uploaded to TestFlight/App Store
 
-## How to Update Versions
+## ✅ Centralized Version Configuration
 
-### Update VERSION_NAME (e.g., 1.1.1 → 1.1.2)
-```bash
-# In V2er.xcodeproj/project.pbxproj, update:
-MARKETING_VERSION = 1.1.2;  # (This is VERSION_NAME)
+**Versions are now defined in ONE place only!**
+
+The version numbers are defined at the project level and automatically inherited by all targets (Debug and Release).
+
+### How to Update Versions
+
+To update versions, you only need to modify **2 locations** in `V2er.xcodeproj/project.pbxproj`:
+
+1. Search for the **Debug** project configuration and update:
+```
+/* Debug project configuration */
+MARKETING_VERSION = 1.1.2;        /* VERSION_NAME */
+CURRENT_PROJECT_VERSION = 29;     /* VERSION_CODE */
 ```
 
-### Update VERSION_CODE (e.g., 28 → 29)
-```bash
-# In V2er.xcodeproj/project.pbxproj, update:
-CURRENT_PROJECT_VERSION = 29;  # (This is VERSION_CODE)
+2. Search for the **Release** project configuration and update:
+```
+/* Release project configuration */
+MARKETING_VERSION = 1.1.2;        /* VERSION_NAME */
+CURRENT_PROJECT_VERSION = 29;     /* VERSION_CODE */
 ```
 
+That's it! The target configurations will automatically inherit these values.
+
 ## Important Notes
 
 1. **Both values must be updated** in both Debug and Release configurations