Upgrade
📝 Description
The upgrade command updates all packages in your Flutter project to their latest compatible versions. It intelligently manages version constraints, resolves conflicts, and ensures your project remains stable while benefiting from the latest improvements.
⚙️ Usage
gexd upgrade [package_name] [options]
gexd upgrade [options]📋 Basic Examples:
# Upgrade all packages
gexd upgrade
# Upgrade specific package
gexd upgrade http
# Upgrade multiple specific packages
gexd upgrade http dio shared_preferences
# Preview upgrades without applying
gexd upgrade --dry-run
# Major version upgrades
gexd upgrade --major-versions
# Upgrade dev dependencies only
gexd upgrade --dev-dependencies🚩 Flags
--dry-run
Show available upgrades without applying changes
--major-versions
Allow major version upgrades
--dev-dependencies
Upgrade dev dependencies only
--no-dev-dependencies
Skip dev dependencies
--force
Force upgrade without compatibility checks
--precompile
Precompile executables after upgrade
🎯 Upgrade Process:
📊 Dependency Analysis - Analyzes current package versions
🔍 Version Discovery - Finds latest compatible versions
⚠️ Conflict Detection - Identifies potential breaking changes
📋 Upgrade Plan - Shows what will be changed
✅ User Confirmation - Asks for approval before applying
⬇️ Package Update - Downloads and installs new versions
📊 Examples by Scope:
Full Project Upgrade:
# Upgrade everything safely
gexd upgrade
# Preview all available upgrades
gexd upgrade --dry-run
# Upgrade with major versions (risky)
gexd upgrade --major-versionsTargeted Upgrades:
# Upgrade specific package
gexd upgrade flutter_svg
# Upgrade state management packages
gexd upgrade get riverpod bloc
# Upgrade dev tools only
gexd upgrade --dev-dependenciesSafe Upgrades:
# Minor and patch updates only
gexd upgrade --no-major-versions
# With compatibility verification
gexd upgrade --verify-compatibility✅ What It Does:
📋 Version Analysis - Compares current vs available versions
🔍 Compatibility Check - Ensures version compatibility
📝 pubspec.yaml Update - Updates version constraints
⬇️ Package Resolution - Resolves and downloads packages
🧪 Build Test - Optionally tests build after upgrade
📊 Upgrade Report - Shows summary of changes
🛡️ Safety Features:
⚠️ Breaking Change Detection: Warns about major version changes
🔄 Dependency Resolution: Solves version conflicts automatically
💾 Backup Creation: Backs up pubspec.yaml before changes
🧪 Build Verification: Tests compilation after upgrade
📋 Detailed Reporting: Shows exactly what changed
📊 Upgrade Strategies:
Conservative (Recommended):
# Minor and patch updates only
gexd upgradeModerate:
# Include compatible minor versions
gexd upgrade --minor-versionsAggressive (Risky):
# Allow major version updates
gexd upgrade --major-versions🔧 Advanced Options:
Selective Upgrades:
# Upgrade specific categories
gexd upgrade --category ui # UI packages
gexd upgrade --category networking # Network packages
gexd upgrade --category testing # Test packagesConstraint Management:
# Update constraints in pubspec.yaml
gexd upgrade --update-constraints
# Lock to exact versions
gexd upgrade --lock-versions⚠️ Potential Issues:
Breaking Changes:
🔍 API Changes: New versions might have different APIs
⚡ Performance Impact: New versions might affect performance
🧩 Dependency Conflicts: Packages might have conflicting requirements
Recovery:
# Restore from backup
gexd upgrade --restore-backup
# Downgrade specific package
gexd downgrade package_name version
# Reset to working state
git checkout pubspec.yaml pubspec.lock
dart pub get📅 Best Practices:
🧪 Test Before Committing: Run tests after upgrade
📦 Incremental Upgrades: Update few packages at a time
📋 Read Release Notes: Check changelog for breaking changes
💾 Version Control: Commit before upgrading
🔄 CI/CD Verification: Ensure pipeline still passes
⚠️ Notes:
📊 Semantic Versioning: Follows semver for safe upgrades
🔍 Pub.dev Integration: Fetches latest versions from pub.dev
⚡ Performance Impact: Larger projects take longer to analyze
🔒 Network Required: Needs internet to check for updates
Generated automatically by gexd_doc
Last updated