Chris@1744: 
Chris@1744: Notes on the Desktop Bridge for Windows Store packaging
Chris@1744: =======================================================
Chris@1744: 
Chris@1744: * Main page
Chris@1744: 
Chris@1744:   https://developer.microsoft.com/en-us/windows/bridges/desktop
Chris@1744: 
Chris@1744: * Introductory tutorial
Chris@1744: 
Chris@1744:   https://docs.microsoft.com/en-us/windows/uwp/porting/desktop-to-uwp-run-desktop-app-converter
Chris@1744: 
Chris@1744: * Desktop App Converter is the helper application that does the
Chris@1744:   conversion; Desktop Bridge is, apparently, the technology, which can
Chris@1744:   be used without using the Desktop App Converter. Here's a page about
Chris@1744:   doing the conversion manually:
Chris@1744: 
Chris@1744:   https://docs.microsoft.com/en-us/windows/uwp/porting/desktop-to-uwp-manual-conversion
Chris@1744: 
Chris@1744: * Note about C++ runtime dependency
Chris@1744: 
Chris@1744:   https://support.microsoft.com/en-gb/help/3176696/c-runtime-framework-packages-for-desktop-bridge
Chris@1744: 
Chris@1744:   but see also
Chris@1744: 
Chris@1744:   https://social.msdn.microsoft.com/Forums/windowsapps/en-US/3f1d9bdd-2fa0-463f-b4f9-02e9bf33ed1a/uwp-desktop-bridge-cant-install-app-even-after-signing-the-certificates-with-signtool?forum=wpdevelop
Chris@1744: 
Chris@1744:   "If you submit the app to the store, customers downloading it from the
Chris@1744:   store will automatically also download the framework package.
Chris@1744: 
Chris@1744:   "If you want your customers to sideload the app, then yes, they'll
Chris@1744:   first have to install the framework package."
Chris@1744: 
Chris@1744: 
Chris@1744: Preparation
Chris@1744: -----------
Chris@1744: 
Chris@1744: * Set up Desktop App Converter as described in https://docs.microsoft.com/en-us/windows/uwp/porting/desktop-to-uwp-run-desktop-app-converter
Chris@1744: * Install VC140 runtime dependency (for developer installation of package) from link at https://blogs.msdn.microsoft.com/vcblog/2016/07/07/using-visual-c-runtime-in-centennial-project/
Chris@1744: * Start PowerShell as administrator
Chris@1744: * cd C:\Program Files (x86)\Microsoft SDKs\Windows Kits\10\ExtensionSDKs\Microsoft.VCLibs.Desktop\14.0\Appx\Retail\x64
Chris@1744: * Run Add-AppxPackage on the one package in that dir
Chris@1744: 
Chris@1744: Invocation
Chris@1744: ----------
Chris@1744: 
Chris@1744: * Start PowerShell as administrator
Chris@1744: * Run e.g.: DesktopAppConverter.exe -Installer C:\Users\Chris\Documents\sonic-visualiser\deploy\win64\sonic-visualiser.msi -Destination . -PackageName "SonicVisualiser" -Publisher CN="sonicvisualiser.org" -Version 3.0.3.0 -MakeAppx -Sign -Verify -Verbose
Chris@1744: * Locate the self-signed certificate file "auto-generated.cer" in Explorer, double-click, Install Certificate, pick Local Machine and the Trusted People store
Chris@1744: * Double click on SonicVisualiser.appx to install
Chris@1744: 
Chris@1744: Command based on actual Store data:
Chris@1744: 
Chris@1744: DesktopAppConverter.exe -Installer C:\Users\Chris\Documents\sonic-visualiser\deploy\win64\sonic-visualiser-3.0.3-win64.msi -Destination . -PackageName "27750sonicvisualiser.org.SonicVisualiser" -AppId "SonicVisualiser" -AppDisplayName "Sonic Visualiser" -PackageDisplayName "Sonic Visualiser" -Publisher CN="55F5913E-18B3-470B-9056-D601FF241EB2" -PackagePublisherDisplayName "sonicvisualiser.org" -Version 3.0.3.0 -AppFileTypes "'.sv','.svl','.wav'" -MakeAppx -Sign -Verify -Verbose
Chris@1744: 
Chris@1744: NB the last digit (revision) of the version number must be 0 for store
Chris@1744: submission.
Chris@1744: 
Chris@1744: Can't submit Desktop Bridge apps through just any store account -- it
Chris@1744: has to be approved first via form at
Chris@1744: https://developer.microsoft.com/en-us/windows/projects/campaigns/desktop-bridge
Chris@1744: -- still waiting for this.