Add automated iOS build script with version management

* Create scripts/build-ios.sh with comprehensive build automation
* Handle pkgx Ruby/Gem environment configuration issues
* Support command-line version and build number updates
* Add environment validation for macOS and Xcode requirements
* Update BUILDING.md with automated build script documentation

BUILDING.md

@@ -316,6 +316,36 @@ npm run build:electron-prod && npm run electron:start
 
 Prerequisites: macOS with Xcode installed
 
+#### Automated Build Script
+
+The recommended way to build for iOS is using the automated build script:
+
+```bash
+# Standard build and open Xcode
+./scripts/build-ios.sh
+
+# Build with specific version numbers
+./scripts/build-ios.sh --version 1.0.3 --build-number 35
+
+# Build without opening Xcode (for CI/CD)
+./scripts/build-ios.sh --no-xcode
+
+# Show all available options
+./scripts/build-ios.sh --help
+```
+
+The script handles all the necessary steps including:
+- Environment setup and validation
+- Web asset building
+- Capacitor synchronization
+- iOS asset generation
+- Version number updates
+- Xcode project opening
+
+#### Manual Build Process
+
+If you need to build manually or want to understand the individual steps:
+
 #### First-time iOS Configuration
 
 - Generate certificates inside XCode.