v3 to v4 migration

Current V3 solution

V3 emulator remembers the list of endpoints, appID, pwd as well as default locale information V3 emulator is set up to automatically update to the latest Emulator release and does so using

• The built in auto-update mechanism in Electron
• Emulator checks for update availability on first app launch, if an update is found downloads and queues it up for installation.
• New version is picked up when user restarts the application.

Current V4 solution

V4 also uses auto-updates between V4 versions but does not support V3 -> V4 automatic updates.

V3 -> V4 auto-updates and upgrade paths

Manual upgrade from V3 -> V4

• Users can manually install the V4 emulator and it will sit side-by-side with the V3 Emulator (if the user already has V3 Emulator).

Auto-update from V3 -> V4

• Once V4 hits stable release, the check for updates functionality in V3 Emulator should detect updates availability to V4.
• The update check must always find the latest V4 version available.
• When auto-updating from V3 -> V4, the updater should create
  • A new bot file for each endpoint found in the V3 MRU list
  • Save the bot file(s) under %EMULATOR_INSTALL_PATH%\migration folder
  • Each endpoint is saved file is named as -
    • localhost_portNumber.bot for localhost endpoints
    • remotehostname.bot for remote endpoints
  • Pre-populate the "My bots" section with the list of new bot files with pre-filled endpoint information
  • Present Emulator V4 overview doc page that includes
    • Walkthrough of new features in the V4 Emulator
    • Provide an overview of the .bot files that were automatically created and how developers can consolidate the endpoints into meaningful bot file structure