Upgrading Your App โ
Simple guide to update your MartFury app to the latest version.
๐จ Before You Start โ
โ ๏ธ Important: Make a Backup! โ
Save your current app first:
- Copy your entire app folder to a safe place
- Name it something like "martfury-backup-old-version"
- This way you can go back if something goes wrong
Save your settings:
- Copy your
.env
file - Save any color/logo changes you made
- Write down your website URL
โ Check if You Need to Upgrade โ
You should upgrade if:
- You want new features
- You have bugs that are fixed in the new version
- Your website was updated and needs a newer app
You might NOT need to upgrade if:
- Your current app works perfectly
- You haven't changed anything on your website
- You're not comfortable with technical changes
๐ฑ Simple Upgrade Steps โ
Step 1: Download New Version โ
- Download the latest app version
- Extract it to a new folder
- Don't delete your old version yet!
Step 2: Copy Your Settings โ
- Copy your
.env
file from old app to new app - Copy your changes:
- If you changed colors: copy your theme files
- If you changed logo: copy your logo files
- If you added translations: copy your translation files
Step 3: Update the App โ
- Open terminal/command prompt
- Go to your new app folder
- Run these commands:bash
flutter clean flutter pub get flutter run
Step 4: Test Everything โ
Test basic features:
- Login/logout
- Browse products
- Add to cart
- Search
Test your customizations:
- Check if your colors are right
- Check if your logo shows
- Test your website connection
If something is wrong:
- Go back to your backup
- Contact support for help
- Don't panic - your backup is safe!
๐ง If You Have Problems โ
App Won't Start โ
bash
flutter clean
flutter pub get
flutter run
Your Changes Are Missing โ
- Make sure you copied all your files correctly
- Check the setup guides (01-15) to redo your changes
- Compare your old and new app folders
Website Won't Connect โ
- Copy your
.env
file again - Make sure your website URL is correct
- Test your website in a browser first
๐ After Upgrading โ
Update Your App Stores โ
If everything works well:
Build new version:
bash# For Google Play Store flutter build appbundle --release # For Apple App Store flutter build ios --release
Upload to stores:
- Follow guide 09_deploying_app.md
- Update version numbers
- Write what's new in the update
Keep Your Backup โ
- Don't delete your old app folder yet
- Keep it for at least a month
- Only delete it when you're sure everything works
๐ก Tips for Success โ
Before Upgrading โ
- โ Read what's new in the update
- โ Make sure you have time to fix problems
- โ Don't upgrade right before important deadlines
- โ Test on a copy first if possible
During Upgrading โ
- ๐ Write down what you're doing
- ๐ Go slowly and carefully
- ๐งช Test after each step
- ๐ Ask for help if you're stuck
After Upgrading โ
- ๐ฑ Test on real phones, not just computer
- ๐ฅ Ask other people to test the app
- ๐ Monitor for any problems
- ๐ Be ready to go back to old version if needed
๐ When Things Go Wrong โ
If Upgrade Fails โ
- Don't panic! Your backup is safe
- Go back to your backup folder
- Use your old app while you figure out the problem
- Contact support with details about what went wrong
Common Problems โ
"Flutter not found" error:
- Make sure Flutter is installed
- Try restarting your computer
"Build failed" error:
bash
flutter clean
flutter pub get
flutter run
App looks different:
- Check if you copied your theme files correctly
- Redo your customizations using the setup guides (01-15)
Website won't connect:
- Make sure you copied your
.env
file - Check your website URL is correct
๐ค Do You Really Need to Upgrade? โ
Upgrade if: โ
- โ You want new features
- โ You have bugs that are fixed
- โ Your website was updated
- โ You're comfortable with technical changes
Don't upgrade if: โ
- โ Your current app works perfectly
- โ You're about to launch something important
- โ You don't have time to fix problems
- โ You're not comfortable with technical changes
๐ Getting Help โ
Before Asking for Help โ
- Try the "magic fix":
flutter clean
thenflutter pub get
- Check if your backup still works
- Read the error message carefully
- Try the troubleshooting guide
When Contacting Support โ
Tell us:
- What version you're upgrading from and to
- What step you were on when it failed
- What error message you saw (screenshot helps)
- What you already tried
- Your website URL
Remember: Upgrading is optional! If your current app works well, you might not need to upgrade at all. Only upgrade when you really need new features or bug fixes.