annotate deploy/win64/store-notes.txt @ 2596:04d381f0d89a tip

Default branch is now named default on git as well as hg, in case we ever want to switch to mirroring in the other direction
author Chris Cannam
date Thu, 27 Aug 2020 15:58:56 +0100
parents c6dfd1684316
children
rev   line source
Chris@1744 1
Chris@1744 2 Notes on the Desktop Bridge for Windows Store packaging
Chris@1744 3 =======================================================
Chris@1744 4
Chris@1744 5 * Main page
Chris@1744 6
Chris@1744 7 https://developer.microsoft.com/en-us/windows/bridges/desktop
Chris@1744 8
Chris@1744 9 * Introductory tutorial
Chris@1744 10
Chris@1744 11 https://docs.microsoft.com/en-us/windows/uwp/porting/desktop-to-uwp-run-desktop-app-converter
Chris@1744 12
Chris@1744 13 * Desktop App Converter is the helper application that does the
Chris@1744 14 conversion; Desktop Bridge is, apparently, the technology, which can
Chris@1744 15 be used without using the Desktop App Converter. Here's a page about
Chris@1744 16 doing the conversion manually:
Chris@1744 17
Chris@1744 18 https://docs.microsoft.com/en-us/windows/uwp/porting/desktop-to-uwp-manual-conversion
Chris@1744 19
Chris@1744 20 * Note about C++ runtime dependency
Chris@1744 21
Chris@1744 22 https://support.microsoft.com/en-gb/help/3176696/c-runtime-framework-packages-for-desktop-bridge
Chris@1744 23
Chris@1744 24 but see also
Chris@1744 25
Chris@1744 26 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 27
Chris@1744 28 "If you submit the app to the store, customers downloading it from the
Chris@1744 29 store will automatically also download the framework package.
Chris@1744 30
Chris@1744 31 "If you want your customers to sideload the app, then yes, they'll
Chris@1744 32 first have to install the framework package."
Chris@1744 33
Chris@1744 34
Chris@1744 35 Preparation
Chris@1744 36 -----------
Chris@1744 37
Chris@1744 38 * 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 39 * 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 40 * Start PowerShell as administrator
Chris@1744 41 * cd C:\Program Files (x86)\Microsoft SDKs\Windows Kits\10\ExtensionSDKs\Microsoft.VCLibs.Desktop\14.0\Appx\Retail\x64
Chris@1744 42 * Run Add-AppxPackage on the one package in that dir
Chris@1744 43
Chris@1744 44 Invocation
Chris@1744 45 ----------
Chris@1744 46
Chris@1744 47 * Start PowerShell as administrator
Chris@1744 48 * 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 49 * 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 50 * Double click on SonicVisualiser.appx to install
Chris@1744 51
Chris@1744 52 Command based on actual Store data:
Chris@1744 53
Chris@1744 54 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 55
Chris@1744 56 NB the last digit (revision) of the version number must be 0 for store
Chris@1744 57 submission.
Chris@1744 58
Chris@1744 59 Can't submit Desktop Bridge apps through just any store account -- it
Chris@1744 60 has to be approved first via form at
Chris@1744 61 https://developer.microsoft.com/en-us/windows/projects/campaigns/desktop-bridge
Chris@1744 62 -- still waiting for this.