After much trial and error and combing the internet, here is what I have found you need to get a minimal hello world console app with cmake:
- Three image files in an "Assets" directory under your project directroy -- logo-44x44.png, logo-150x150.png, and a 50x50 StoreLogo.png.
- A TemporaryKey.pfx certificate. I "borrowed" one from a WinRT console app Visual Studio created.
- A Package.appxmanifest file. This is the application configuration. An example is below.
- main.cpp. The hello world source. See below.
- CMakeLists.txt. See below.
Package.appxmanifest looks like this:
<?xml version="1.0" encoding="utf-8"?>
<Package
xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
xmlns:uap5="http://schemas.microsoft.com/appx/manifest/uap/windows10/5"
xmlns:desktop4="http://schemas.microsoft.com/appx/manifest/desktop/windows10/4"
xmlns:iot2="http://schemas.microsoft.com/appx/manifest/iot/windows10/2"
IgnorableNamespaces="uap mp uap5 iot2 desktop4">
<Identity
Name="sandbox-uwp"
Publisher="CN=YourNameHere"
Version="1.0.0.0" />
<mp:PhoneIdentity PhoneProductId="00000000-0000-0000-0000-000000000000" PhonePublisherId="00000000-0000-0000-0000-000000000000"/>
<Properties>
<DisplayName>sandbox-uwp</DisplayName>
<PublisherDisplayName>YourNameHere</PublisherDisplayName>
<Logo>Assets\StoreLogo.png</Logo>
</Properties>
<Dependencies>
<TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.0.0" MaxVersionTested="10.0.0.0" />
</Dependencies>
<Resources>
<Resource Language="x-generate"/>
</Resources>
<Applications>
<Application Id="App"
Executable="$targetnametoken$.exe"
EntryPoint="sandbox-uwp.App"
desktop4:Subsystem="console"
desktop4:SupportsMultipleInstances="true"
iot2:Subsystem="console"
iot2:SupportsMultipleInstances="true"
>
<uap:VisualElements
DisplayName="sandbox-uwp"
Square150x150Logo="Assets\logo-150x150.png"
Square44x44Logo="Assets\logo-44x44.png"
Description="whatever"
BackgroundColor="transparent">
</uap:VisualElements>
<Extensions>
<uap5:Extension
Category="windows.appExecutionAlias"
Executable="sandbox-uwp.exe"
EntryPoint="sandbox-uwp.App">
<uap5:AppExecutionAlias desktop4:Subsystem="console" iot2:Subsystem="console">
<uap5:ExecutionAlias Alias="sandbox-uwp.exe" />
</uap5:AppExecutionAlias>
</uap5:Extension>
</Extensions>
</Application>
</Applications>
</Package>
main.cpp looks like this:
#include "winrt/Windows.ApplicationModel.Core.h"
#include <stdio>
int main()
{
printf("Hello, world.\n");
return 0;
}
And the all-important CMakeLists.txt looks like this:
#
# Minimal configuration for building a UWP-Console app.
#
cmake_minimum_required(VERSION 3.12)
# Configure CMake for UWP. You can do this on the command line with
# -D<variable>=<value>, which may be better for cross-platform builds, but gets
# tedious when you are only building for a single platform. If you are doing
# it this way, in the CMAKE file, you have to set it before the project
# declaration!
set(CMAKE_SYSTEM_NAME "WindowsStore")
set(CMAKE_SYSTEM_VERSION "10.0")
project(sandbox VERSION 0.0.1 LANGUAGES CXX)
# Target files.
set(source main.cpp)
set(
assets
Assets/logo-44x44.png
Assets/logo-150x150.png
Assets/StoreLogo.png
)
set(resources ${assets} TemporaryKey.pfx Package.appxmanifest)
# Assets have to be marked as deployment content, and given a location, so they
# will be packaged into the built app.
set_source_files_properties(
${assets}
PROPERTIES
VS_DEPLOYMENT_CONTENT 1
)
set_source_files_properties(
${assets}
PROPERTIES
VS_DEPLOYMENT_LOCATION "Assets"
)
# Target application settings.
add_executable(sandbox-uwp ${source} ${resources})
set_property(TARGET sandbox-uwp PROPERTY CXX_STANDARD 17)
set_property(
TARGET sandbox-uwp
PROPERTY VS_WINDOWS_TARGET_PLATFORM_MIN_VERSION
10.0.17134.0
)
With that, you should be able to create a Visual Studio solution with `cmake <path to project>`, and build from the command line with `cmake --build .`.
Once the application is built, you need to install it. Do this from Power Shell.
PS > Add-AppxPackage
And follow the prompts.
Once the application is installed, you should be able to run it from the command line, or from the start menu.
PS > sandbox-uwp
Hello world.
To remove the application, use Get-AppxPackage to find the PackageFullName of the application.
PS > Get-AppxPackage -Name sandbox-uwp*
Name : sandbox-uwp
...
PackageFullName : sandbox-uwp_1.0.0.0_x86__xxxxxxxxxxxxx
...
Then remove the application with Remove-AppxPackage.
PS > Remove-AppxPackage -Package sandbox-uwp_1.0.0.0_x86__xxxxxxxxxxxxx
I hope I transcribed everything correctly, and that this saves someone some time.
