annotate deploy/win64/store-notes.txt @ 1861:8c4df1f3fef7

Merge from branch plugin-path-config
author Chris Cannam
date Mon, 11 Jun 2018 14:42: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.