v3.0.0

[amir-zr]

🚀 Flutter V2Ray Client v3.0.0

We're thrilled to announce Flutter V2Ray Client v3.0.0, packed with major stability improvements, critical bug fixes, and enhanced user experience. This release focuses on reliability, performance, and better error handling.

---

🔄 Xray Core v25.10.15

• Updated to the latest stable version with security patches
• Includes all upstream bug fixes and performance improvements
• Ensures compatibility with the latest V2Ray protocols

---

🛠️ Major Improvements

• Build System Modernization

  • Updated to Gradle 8.14 and Kotlin 2.1.0
  • Android Gradle Plugin upgraded to 8.13.0
  • Compiled SDK version bumped to 35
  • Full compatibility with the latest Flutter versions

• Core Stability Enhancements

  • Complete null safety implementation across the codebase
  • Robust error handling for service lifecycle management
  • Improved service reliability with proper cleanup procedures

• Connection Management

  • Fixed race conditions in VPN permission handling
  • Reliable mode switching between VPN and proxy
  • Enhanced connection stability with proper error recovery

---

🐛 Key Fixes

• Critical Bug Fixes

  • Fixed multiple NullPointerException scenarios
  • Resolved service crashes during permission flows
  • Addressed race conditions in VPN permission requests
  • Fixed notification-related crashes when permissions are denied

• Service Reliability

  • Added comprehensive null checks for Intents and command extras
  • Implemented silent VPN mode when notification permissions are denied
  • Prevented service restart loops with START_NOT_STICKY for error cases

• Performance Optimizations

  • Improved broadcast receiver registration with proper error handling
  • Optimized service cleanup procedures
  • Reduced memory leaks with better activity reference management

---

✨ New Features

• Enhanced Logging System

  • New V2Ray log viewer with filtering capabilities
  • In-app log management (view and clear logs)
  • Improved debugging information for troubleshooting

• User Experience

  • Better error messages and status reporting
  • Improved notification handling
  • More reliable connection state management

---

🔄 Compatibility Notes

• Minimum Requirements

  • Android API level 21+ (Android 5.0+)
  • Latest Flutter stable version recommended
  • Requires Android Gradle Plugin 8.1.0 or higher

• Migration Guide

  • Update your project's Gradle wrapper to 8.14
  • Ensure all native dependencies are rebuilt
  • Test VPN and proxy functionality thoroughly
  • Verify notification permissions handling

---

📝 Testing Recommendations

• Test VPN and proxy mode switching
• Verify log viewer functionality
• Check behavior with notification permissions denied
• Test service stability across configuration changes
• Validate connection reliability in various network conditions

---

🙏 Acknowledgments

Special thanks to all contributors and users who reported issues and helped improve this release. Your feedback is invaluable in making Flutter V2Ray Client more stable and reliable.

Report Issues |
View Documentation |
Changelog

---

This discussion was created from the release v3.0.0.