|
| 1 | +# MoliTodo v1.1.4 Release Notes |
| 2 | + |
| 3 | +*Released: September 27, 2025* |
| 4 | + |
| 5 | +## 🔧 Critical Windows Compatibility Fix |
| 6 | + |
| 7 | +### 🐛 Major Bug Fixes |
| 8 | + |
| 9 | +#### Windows SQLite Database Issues |
| 10 | +- **Fixed `getLastUpdatedTime is not a function` Error**: Resolved critical error that prevented Windows users from using the application |
| 11 | +- **Database Initialization Order**: Fixed initialization sequence where migrations were attempted before base tables were created |
| 12 | +- **SQLite Compatibility**: Enhanced SQLite initialization with Windows-specific configurations and optimizations |
| 13 | +- **Cross-Platform Path Handling**: Implemented proper path normalization for Windows file system compatibility |
| 14 | + |
| 15 | +#### Database Performance & Reliability |
| 16 | +- **Enhanced Error Handling**: Added comprehensive error diagnostics and logging for database operations |
| 17 | +- **Windows-Specific Optimizations**: Applied Windows-specific SQLite parameters for better performance and stability |
| 18 | +- **File System Operations**: Improved file system operations with proper Windows path handling and permissions |
| 19 | +- **Data Integrity**: Strengthened database validation and consistency checks across all platforms |
| 20 | + |
| 21 | +## 🛠️ Technical Improvements |
| 22 | + |
| 23 | +### Database Infrastructure |
| 24 | +- **SQLite Repository Enhancement**: Updated `sqlite-task-repository.js` with improved initialization logic |
| 25 | +- **Migration System**: Fixed database migration sequence to prevent `ALTER TABLE` operations on non-existent tables |
| 26 | +- **Path Normalization**: Added `normalizePath()` method for consistent cross-platform file path handling |
| 27 | +- **Error Diagnostics**: Enhanced error reporting with detailed database operation logging |
| 28 | + |
| 29 | +### Cross-Platform Support |
| 30 | +- **Windows File Locking**: Implemented Windows-specific file locking and permission checks |
| 31 | +- **Path Separator Handling**: Proper handling of Windows vs Unix path separators |
| 32 | +- **Database Configuration**: Platform-specific SQLite configuration for optimal performance |
| 33 | +- **Compatibility Testing**: Added comprehensive Windows compatibility testing framework |
| 34 | + |
| 35 | +## 🎯 User Impact |
| 36 | + |
| 37 | +### Windows Users |
| 38 | +- **Application Functionality Restored**: Windows users can now use MoliTodo without database errors |
| 39 | +- **Improved Performance**: Enhanced database operations with Windows-specific optimizations |
| 40 | +- **Reliable Data Storage**: Consistent and reliable task data persistence across all operations |
| 41 | +- **Error-Free Experience**: Eliminated critical startup and operation errors on Windows systems |
| 42 | + |
| 43 | +### All Platforms |
| 44 | +- **Enhanced Stability**: Improved database reliability and error handling across macOS, Windows, and Linux |
| 45 | +- **Better Performance**: Optimized SQLite operations for faster task management |
| 46 | +- **Robust Error Handling**: Comprehensive error diagnostics and recovery mechanisms |
| 47 | +- **Data Integrity**: Strengthened data validation and consistency checks |
| 48 | + |
| 49 | +## 🔄 Technical Details |
| 50 | + |
| 51 | +### Root Cause Analysis |
| 52 | +The issue was caused by incomplete SQLite initialization on Windows systems, where the application attempted to call database methods before the repository was fully initialized. This was particularly problematic on Windows due to: |
| 53 | + |
| 54 | +1. **File System Differences**: Windows file locking and permission handling differs from Unix systems |
| 55 | +2. **Path Handling**: Windows path separators and file system operations required special handling |
| 56 | +3. **SQLite Configuration**: Windows-specific SQLite parameters were needed for optimal performance |
| 57 | +4. **Initialization Order**: Database migrations were attempted before base table creation |
| 58 | + |
| 59 | +### Solution Implementation |
| 60 | +- **Enhanced Initialization**: Restructured database initialization to ensure proper order of operations |
| 61 | +- **Windows-Specific Code**: Added Windows-specific file system and SQLite handling |
| 62 | +- **Path Normalization**: Implemented cross-platform path handling with proper separator conversion |
| 63 | +- **Error Recovery**: Added comprehensive error handling and recovery mechanisms |
| 64 | + |
| 65 | +## 🔄 Migration Notes |
| 66 | + |
| 67 | +### Automatic Updates |
| 68 | +- **Seamless Upgrade**: All existing data and settings are automatically preserved |
| 69 | +- **No Configuration Required**: Fixes are applied automatically without user intervention |
| 70 | +- **Backward Compatibility**: Full compatibility with existing task data and application settings |
| 71 | +- **Instant Relief**: Windows users will immediately experience error-free operation |
| 72 | + |
| 73 | +### Data Safety |
| 74 | +- **Zero Data Loss**: All existing tasks, lists, and settings remain intact |
| 75 | +- **Database Integrity**: Enhanced validation ensures data consistency during and after upgrade |
| 76 | +- **Backup Compatibility**: Existing backup and restore functionality remains unchanged |
| 77 | + |
| 78 | +## 🚀 Installation Notes |
| 79 | + |
| 80 | +### Windows Users |
| 81 | +- **Immediate Fix**: This release specifically addresses Windows compatibility issues |
| 82 | +- **Standard Installation**: No special installation steps required |
| 83 | +- **Performance Improvement**: Noticeable improvement in application startup and operation speed |
| 84 | + |
| 85 | +### macOS Users |
| 86 | +Due to unsigned code, macOS users still need to run this command after installation: |
| 87 | + |
| 88 | +```bash |
| 89 | +sudo xattr -rd com.apple.quarantine /Applications/MoliTodo.app |
| 90 | +``` |
| 91 | + |
| 92 | +## 📊 Quality Assurance |
| 93 | + |
| 94 | +### Testing Coverage |
| 95 | +- **Windows Compatibility**: Comprehensive testing on Windows 10 and Windows 11 |
| 96 | +- **Database Operations**: Full CRUD operation testing across all platforms |
| 97 | +- **Migration Testing**: Verified database migration and initialization processes |
| 98 | +- **Performance Testing**: Confirmed improved performance metrics on Windows systems |
| 99 | + |
| 100 | +### Validation |
| 101 | +- **Error Resolution**: Confirmed elimination of `getLastUpdatedTime is not a function` error |
| 102 | +- **Cross-Platform**: Verified functionality across Windows, macOS, and Linux |
| 103 | +- **Data Integrity**: Validated data consistency and reliability across all operations |
| 104 | +- **Performance**: Measured and confirmed performance improvements on Windows |
| 105 | + |
| 106 | +--- |
| 107 | + |
| 108 | +**Priority**: Critical Fix - Recommended for all Windows users |
| 109 | +**Compatibility**: Windows 10+, macOS 10.14+, Linux (Ubuntu 18.04+) |
| 110 | +**Download**: [GitHub Releases](https://github.com/gusi/MoliTodo/releases/tag/v1.1.4) |
0 commit comments