README-winrt.txt 2.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. ================================================================================
  2. Simple DirectMedia Layer for WinRT
  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. * Windows 8.x
  10. * Windows RT 8.x (aka. Windows 8.x for ARM processors)
  11. * Windows Phone 8.x
  12. To note, WinRT applications that run on Windows 8.x and/or Windows RT are often
  13. called "Windows Store" apps.
  14. --------------------------------------------------------------------------------
  15. Requirements
  16. --------------------------------------------------------------------------------
  17. - Microsoft Visual C++ 2012 -- Free, "Express" editions may be used, so long
  18. as they include support for either "Windows Store" or "Windows Phone" apps.
  19. (NOTE: MSVC 2013 support is pending. 2012 projects may be converted to 2013
  20. projects by MSVC, in the meantime.)
  21. - A valid Microsoft account -- This requirement is not imposed by SDL, but
  22. rather by Microsoft's Visual C++ toolchain.
  23. --------------------------------------------------------------------------------
  24. TODO
  25. --------------------------------------------------------------------------------
  26. - Finish adding support for MSVC 2013, and "Universal" WinRT apps, which
  27. support Windows 8.1, Windows Phone 8.1, and in the future, Xbox One and
  28. Windows Desktop.
  29. - Finish adding support for the SDL satellite libraries (SDL_image, SDL_mixer,
  30. SDL_ttf, etc.)
  31. - Create templates for both MSVC 2012 and MSVC 2013, and have the corresponding
  32. VSIX packages either include pre-built copies of SDL, or reference binaries
  33. available via MSVC's NuGet servers
  34. - Write setup instructions that use MSVC 201x templates
  35. - Write setup instructions that don't use MSVC 201x templates, and use
  36. MSVC project-to-project references, rather than pre-built binaries
  37. - Write a list of caveats found in SDL/WinRT, such as APIs that don't work due
  38. to platform restrictions, or things that need further work