docs/README-winrt.md
author David Ludwig <dludwig@pobox.com>
Sun, 14 Sep 2014 10:29:54 -0400
changeset 9137 b0b056a7b932
parent 9025 d09d4b578e77
child 9138 b513dc1f7dd5
permissions -rw-r--r--
WinRT: cleaned up section headers
     1 WinRT
     2 =====
     3 
     4 SDL/WinRT layer allows SDL2-based applications to run on many of Microsoft's
     5 platforms that utilize the "Windows Runtime" (aka "WinRT") APIs.  WinRT apps
     6 are currently always full-screen apps, run in what Microsoft calls their
     7 "Modern" environment (aka. "Metro"), and are distributed via Microsoft-run
     8 online stores.  Some of the operating systems that support such apps include:
     9 
    10 * Windows 8.x
    11 * Windows RT 8.x (aka. Windows 8.x for ARM processors)
    12 * Windows Phone 8.x
    13 
    14 To note, WinRT applications that run on Windows 8.x and/or Windows RT are often
    15 called "Windows Store" apps.
    16 
    17 
    18 Requirements
    19 ------------
    20 
    21 - Microsoft Visual C++ 2012 -- Free, "Express" editions may be used, so long
    22   as they include support for either "Windows Store" or "Windows Phone" apps.
    23   (NOTE: MSVC 2013 support is pending.  2012 projects may be converted to 2013
    24   projects by MSVC, in the meantime.)
    25 - A valid Microsoft account -- This requirement is not imposed by SDL, but
    26   rather by Microsoft's Visual C++ toolchain.
    27 
    28 
    29 TODO
    30 ----
    31 
    32 - Finish adding support for MSVC 2013, and "Universal" WinRT apps, which
    33   support Windows 8.1, Windows Phone 8.1, and in the future, Xbox One and
    34   Windows Desktop.
    35 - Finish adding support for the SDL satellite libraries (SDL_image, SDL_mixer,
    36   SDL_ttf, etc.)
    37 - Create templates for both MSVC 2012 and MSVC 2013, and have the corresponding
    38   VSIX packages either include pre-built copies of SDL, or reference binaries
    39   available via MSVC's NuGet servers
    40 - Write setup instructions that use MSVC 201x templates
    41 - Write setup instructions that don't use MSVC 201x templates, and use
    42   MSVC project-to-project references, rather than pre-built binaries
    43 - Write a list of caveats found in SDL/WinRT, such as APIs that don't work due
    44   to platform restrictions, or things that need further work