feat(windows): background updates go from downloading to waiting for a restart except if the apply now flag is set

[rc-swag]

Only go to the installing state if apply now has been set. Otherwise go to WaitingRestart. This can be Revistied in Stage 2 #8993
Fixes: #13155

User Testing

TEST_IDLE_KMSHELL_UPDATEDS_KBDS_ONLY

To Test this PR we need it so there are no newer updates available. If there are let me know and
I will merge in the lastest master again.

1. Download the Keyman attached to this PR
2. Start Keyman.
3. Open the Keyman Configuration dialog.
4. Install the euro latin keyboard attached to this PR 3.0.0 sil_euro_latin.zip
5. In Options tab under General, check "Automatically check for updates and download"
6. Open Regedit WinR type regedit
7. Go to the current user key update state found at (Computer\HKEY_CURRENT_USER\SOFTWARE\Keyman\Keyman Engine).
8. If required set the state back to usIdle
9. Open Windows explorer at "C:\Users"yourusername"\AppData\Local\Keyman\UpdateCache" folder.
10. Delete cache.json, any *.kmp and *.exe files.
11. Open a command prompt (kbd>WinR type cmd)
12. Change to the directory where kmshell is installed
    cd "c:\Program Files (x86)\Keyman\Keyman Desktop"
13. Type kmshell.exe -buc
14. In the Regedit window verify the update state has advanced to usUpdateAvailable then usDownloading and finally usWaitngRestart. Press F5 to refresh the view.

TEST_IDLE_KMSHELL_UPDATEDS_KBDS_ONLY_APPLY_NOW

To Test this PR we need it so there are no newer updates available. If there are let me know and
I will merge in the lastest master again.

1. Download the Keyman attached to this PR
2. Start Keyman.
3. Open the Keyman Configuration dialog.
4. Install the euro latin keyboard attached to this PR 3.0.0 sil_euro_latin.zip
5. In Options tab under General, check "Automatically check for updates and download"
6. Open Regedit WinR type regedit
7. Go to the current user key update state found at (Computer\HKEY_CURRENT_USER\SOFTWARE\Keyman\Keyman Engine).
8. If required set the state back to usIdle
9. Open Windows explorer at "C:\Users"yourusername"\AppData\Local\Keyman\UpdateCache" folder.
10. Delete cache.json, any *.kmp and *.exe files.
11. Open the Update Tab in Keyman Configuration Click the check for updates
12. Once the table updates press the Apply Now button.
13. With the pop click the update button
14. If elevate permissions prompt comes up click allow
15. Check in Keyman Configuration the Keyboard has been updated to the latest version
16. Check the update state in the regedit window is back usIdle

[keymanapp-test-bot]

User Test Results

Test specification and instructions

• ✅ TEST_IDLE_KMSHELL_UPDATEDS_KBDS_ONLY (PASSED) (notes)
• ✅ TEST_IDLE_KMSHELL_UPDATEDS_KBDS_ONLY_APPLY_NOW (PASSED) (notes)

Test Artifacts

• Windows
  • Keyman for Windows
  • FirstVoices Keyboards for Windows
  • Text Editor (32 bit)
  • Text Editor (64 bit)

[dinakaranr]

Test Results

I tested this issue with the attached Keyman"18.0.184-alpha-test-13159" build(08/02/2025) on Windows 10. Here I am sharing my observation.

• TEST_IDLE_KMSHELL_UPDATEDS_KBDS_ONLY (Passed):

1. Installed the Keyman-18.0.184.exe file which is attached to this PR
2. Start Keyman.
3. Open the Keyman Configuration dialog.
4. Install the Euro Latin keyboard attached to this PR 3.0.0 sil_euro_latin.zip
5. In the Options tab under General, check "Automatically check for updates and download"
6. Open Regedit WinR type regedit
7. Go to the current user key update state found at (Computer\HKEY_CURRENT_USER\SOFTWARE\Keyman\Keyman Engine).
8. If required set the state back to usIdle
9. Open Windows explorer at "C:\Users"yourusername"\AppData\Local\Keyman\UpdateCache" folder.
10. Delete cache.json, any *.kmp and *.exe files.
11. Open a command prompt (kbd>WinR type cmd)
12. Change to the directory where kmshell is installed (cd "c:\Program Files (x86)\Keyman\Keyman Desktop")
13. Type kmshell.exe -buc
14. In the Regedit window.
15. Verified that the "update state" has changed to "usUpdateAvailable" --> "usDownloading" --> usWaitngRestart.(Press F5 to refresh the view.)
    It works well. Thank you.

• TEST_IDLE_KMSHELL_UPDATEDS_KBDS_ONLY_APPLY_NOW (Passed):

1. Installed the Keyman-18.0.184.exe file which is attached to this PR
2. Start Keyman.
3. Open the Keyman Configuration dialog.
4. Install the Euro Latin keyboard attached to this PR 3.0.0 sil_euro_latin.zip
5. In the Options tab under General, check "Automatically check for updates and download"
6. Open Regedit WinR type regedit
7. Go to the current user key update state found at (Computer\HKEY_CURRENT_USER\SOFTWARE\Keyman\Keyman Engine).
8. If required set the state back to usIdle
9. Open Windows Explorer at "C:\Users"yourusername"\AppData\Local\Keyman\UpdateCache" folder.
10. Delete cache.json, any *.kmp and *.exe files.
11. Open the Update Tab in Keyman Configuration. Click the "Check for new updates"
12. Once the table updates press the "Apply update now" button.
13. With the pop click the update button.
14. If the elevate permissions prompt comes up click allow
15. Verified that the table is empty on the Update tab.
16. Navigate to the "Keyboard Layouts" tab.
17. Verified that the Keyboard updated to the latest version.
18. In the Regedit window.
19. Verified that the "update state" has changed to "usIdle"
    It works well. Thank you.

[keyman-server]

Changes in this pull request will be available for download in Keyman version 18.0.188-alpha