🎮 Match Mania

🔄 Changed

• Website Consistency: Testing page redesigned to match main site
• Build Info: Updated copyright sections and build information

🔧 Technical

• Updated About page with current build date
• Website URL consistency across all pages
• Build date: October 5, 2025

🎯 Fixed

• Phone Layout: Fixed player cards appearing below screen on phones
• Flexible Layout: Changed HorizontalScrollView to use 0dp with weight=1
• Better Constraints: Improved layout constraints for all phone sizes

✨ Added

• Screen Rotation Support: Full rotation support (portrait/landscape)
• Landscape Layout: Dedicated landscape layout with 40/60 split
• State Preservation: Game state preserved during rotation

🔧 Technical

• Removed portrait-only restriction from AndroidManifest
• Added automatic rotation based on device sensors
• Enabled all orientations: portrait, landscape, reverse portrait, reverse landscape
• Player card area now uses flexible 0dp height with weight distribution

🎯 Fixed - Perfect Player Card Display!

• Player Cards Fully Visible: Cards now show complete height without cutting!
• Top Card Optimized: Reduced from 180dp to 150dp (still clearly visible)
• Space Reallocation: Saved 66dp from top area, gave to player cards
• Guaranteed Height: Player card area now fixed 500dp (no more squishing)
• Perfect Sizing: Cards display at ideal 240dp×360dp on tablets

🔍 Root Cause Fixed

• Problem Identified: Top card (180dp) was hogging vertical space
• Space Analysis: Top area was using 220dp, leaving little for player cards
• Priority Issue: UI prioritized top card over player hand
• Tablet Fit: Layout needed 1012dp but tablets only had 600-800dp

✨ Improvements

• Top Area: 220dp → 154dp (30% more efficient!)
• Player Cards: Now guaranteed 500dp height area
• Total Layout: 1012dp → 942dp (fits tablets better!)
• Better Prioritization: Player cards get the space they deserve
• Compact UI: Reduced padding throughout for cleaner look
• Works on 7-8" Tablets: Now fits landscape mode properly

🎮 User Benefits

• Cards WIDE: 240dp width (33% wider than v2.3.10)
• Cards TALL: 360dp height guaranteed (no cutting!)
• Easy to Read: All card details clearly visible
• Professional Look: Cards look like real playing cards
• Smooth Gameplay: No more fighting with cut-off cards

🔧 Technical

• Top card size: 120×180dp → 100×150dp
• Player card area: weight-based → fixed 500dp
• Padding reductions: -36dp throughout layout
• Build date: Updated to October 5, 2025
• About page: Updated website URL and build info

🎯 Fixed - Perfect Tablet Card Display!

• Card Width: Increased from 180dp to 240dp (+33% wider!)
• Card Height: Added 400dp minimum height guarantee (no more squishing!)
• Proper Proportions: Cards now display at full 240dp×360dp size
• Better Visibility: Much easier to read numbers and symbols

✨ Improvements

• Optimal Screen Usage: Cards use ~40% of screen width each
• Fewer But Wider: Shows 2-3 wide cards instead of 3-4 narrow ones
• Professional Look: Cards look like real playing cards now
• Perfect Aspect Ratio: Maintains standard 2:3 card ratio
• No Distortion: Cards never compressed or squished

🔧 Technical

• Increased tablet maxCardWidth from 180dp to 240dp
• Reduced tablet cardDivider from 3 to 2
• Added minHeight=400dp to player card HorizontalScrollView
• Guarantees sufficient vertical space for full-height cards
• Phone display unchanged (still optimal)

📱 Impact

• Width: 180dp → 240dp (+33% wider)
• Height: Variable → 360dp (guaranteed)
• Result: Perfect card display on tablets!

✨ Added

• User Choice Dialog: Update dialog now appears BEFORE download starts
• Clear Options: Download, Skip, or Close buttons for user control
• Auto-Install: Package manager launches automatically after download completes

🔄 Changed

• OTA Flow: Removed automatic download - user must click "Download" button
• Update Dialog: Changed "Install Now" to "Download", removed "Details" button, added "Close" button
• Download Behavior: Background download starts only after user approval
• Install Flow: Package manager opens automatically when download completes (no intermediate dialog)

✅ Improved

• User Experience: Clear choice before any download happens
• Transparency: User knows update will download and install automatically
• Control: Users can skip updates or close dialog to decide later
• Efficiency: Direct flow from download → package manager (fewer steps)

🔧 Technical

• Removed automatic download on update detection
• Always show dialog first for user consent
• Auto-launch installApk() after successful download
• Removed showInstallDialog() intermediate step
• Simplified update flow with fewer code paths

🐛 Fixed

• Tablet Card Display: Significantly wider cards on tablets (180dp max, divider=3)
• Screen Utilization: Cards now properly utilize tablet screen width
• Card Readability: Improved readability with larger card display on tablets
• Cards on tablets now show 3-4 wide cards instead of 4-5 narrow cards

🔄 Changed

• About Page: Updated to show v2.3.17 and current build information
• Website Link: Added clickable website URL (matchmaina.ssfdre38.xyz) to About page
• Support Info: Website now listed as primary support channel
• Build Date: Updated to October 2025

🔧 Technical

• Increased tablet max card width from 140dp to 180dp (29% wider)
• Changed tablet card divider from 4 to 3 for better screen usage
• Increased minimum card width from 70dp to 80dp
• Updated About page with dynamic version display and website integration
• Phone card display remains unchanged (optimized for smaller screens)

✨ Added

• Always Auto-Download: OTA updates now auto-download even on manual checks
• Enhanced Website Priority: Website is now the primary download source with GitHub as fallback
• Improved Update Experience: Background downloads work for both automatic and manual update checks

🔄 Changed

• OTA System: Manual "Check for Updates" now triggers automatic background download
• Download Validation: Enhanced URL validation to prevent empty download URLs
• Details Button: Now properly opens GitHub release page when available
• Release Process: Automated release script enhanced with proper API JSON generation

🐛 Fixed

• Download URL Priority: Website downloads now properly prioritized over GitHub
• Manual Check Flow: Manual update checks now behave same as automatic checks
• API Format: Website API now includes github_url for proper navigation

🔧 Technical

• Removed !forceCheck condition from auto-download logic
• Added .isEmpty() validation for download URL checking
• Enhanced checkWebsiteAPI() to parse github_url field
• Updated release script to generate complete API JSON format
• Improved GitHub release notes to emphasize website as primary source

📚 Documentation

• Added comprehensive OTA system documentation
• Created priority and fallback flow diagrams
• Added release process integration guide
• Created quick reference cards for developers

🐛 Fixed

• Tablet Card Width Fix: Fixed card width calculation for tablets in landscape mode
• Cards on tablets now divide screen by 4 instead of 6, allowing for wider, more visually appealing cards
• Improved card display on 7-10 inch tablets, especially in landscape orientation
• Better utilization of available screen space on tablets

🔧 Technical

• Updated card width calculation to use different divider for tablets (4) vs phones (6)
• Tablets now show 4-5 cards across screen width (wider cards) vs 5-6 cards on phones
• Maintains proper 2:3 aspect ratio for all screen sizes
• Maximum card width remains 140dp for tablets, 100dp for phones

🐛 Fixed

• Android 13+ OTA Update Fix: Fixed RECEIVER_EXPORTED error when downloading updates
• Properly registered BroadcastReceiver with RECEIVER_NOT_EXPORTED flag for Android 13+ (API 33+)
• Maintained backward compatibility with older Android versions
• Update downloads now work correctly on Android 13 and newer devices

🔧 Technical

• Added conditional receiver registration based on Android version
• Used Context.RECEIVER_NOT_EXPORTED for Android 13+ (TIRAMISU and above)
• Fixed security warning for dynamically registered BroadcastReceivers
• Improved OTA update reliability across all Android versions

🐛 Fixed

• Tablet Card Display: Fixed narrow card display on tablets in landscape mode
• Cards now properly scale to fill screen on tablets (up to 140dp instead of 100dp)
• Improved card sizing detection using smallestScreenWidthDp for tablets (>=600dp)
• Better visual appearance on 7-10 inch tablets

🔧 Technical

• Enhanced card width calculation to detect tablet devices
• Maximum card width increased from 100dp to 140dp for tablets
• Maintains proper 2:3 aspect ratio for all screen sizes
• Phone card sizes remain unchanged (100dp max)

✨ Added

• Website-First OTA Updates: App now checks official website API first for updates
• Automatic Fallback: If website unavailable, automatically falls back to GitHub API
• Faster Update Checks: Website API responds faster with 5-second timeout
• Dual-Source Reliability: No single point of failure for update distribution
• Automated Release System: Complete build and deployment script for streamlined releases

🔧 Changed

• OTA update system now prioritizes website (https://matchmaina.ssfdre38.xyz/api/latest-version.json)
• GitHub API serves as reliable backup for update checks
• Improved error handling and logging for update sources

🐛 Fixed

• OTA update system build issues resolved (correct method placement)
• Method structure corrected for proper Java compilation

🔧 Technical

• Added checkWebsiteAPI() method for primary update source
• Added checkGitHubAPI() method for backup update source
• Website timeout: 5 seconds (fast response)
• GitHub timeout: 10 seconds (reliable fallback)
• Comprehensive logging for update source tracking

✨ Added

• Automatic Background Download: Updates now download silently in background when detected
• Smart Update Detection: Checks if update already downloaded before re-downloading
• APK Verification: Validates downloaded APK file integrity (magic bytes check)
• SHA-256 Hash Calculation: Stores file hash for security verification
• Install Ready Dialog: Shows when update is downloaded and ready to install

🔧 Changed

• Two-Step Process: Updates download automatically, then prompt user to install
• Better User Experience: Download happens in background, installation requires explicit approval
• Improved Security: File verification before installation

✨ Added

• Auto-Download & Install: OTA system now automatically downloads and installs updates
• Progress Dialog: Visual progress bar during APK download
• Smart Permissions: Automatically requests install permission on Android 8+
• FileProvider Integration: Secure APK installation via FileProvider

✨ Added

• OTA Update System: Automatic update checking using GitHub releases
• Check for Updates button in Settings for manual checks
• Update notification dialog with version information
• Smart update detection using version codes

🔧 Changed

• Alphabetized game play settings for easier navigation
• Improved settings organization and usability

✨ Added

• Smooth Animations System: Comprehensive animation framework throughout the game
• Card Play Animation: Cards scale up, fade out, and move when played
• Card Draw Animation: New cards appear with fade-in and scale effect
• Card Flip Animation: Top card flips smoothly when changed (3D effect)
• Invalid Move Shake: Cards shake when trying to play illegal moves
• Playable Card Bounce: Subtle bounce effect on cards that can be played

✨ Added

• Official App Name: Rebranded as "Match Mania"
• Signed APKs: Production-ready signed release builds
• About Page: Added proper licensing and copyright information
• Enhanced UI: Improved card design with better visual consistency

✨ Added

• Player Statistics System: Track games, wins, losses, and win rate
• Player Customization: Custom names and 48 avatar options
• Match History: View your last 50 games with details
• Time Tracking: Total play time, average game duration

✨ Added

• Initial Release: First public version of Match Mania
• 4-Player Gameplay: Human player vs 3 AI opponents
• True Randomness: Cryptographically secure card shuffling
• Beautiful UI: Dark theme interface with color-coded cards