xPlatAppx
Copyright (c) 2017 Microsoft Corp.
All rights reserved.
DESCRIPTION
The xPlatAppx project is an effort to enable developers on a variety of platforms to package and unpackage
application packages for the purposes of distribution from either the Microsoft Windows Apps Store, or
2nd/3rd party stores. To that end, the file format of these packages need to be in a format that is easily
digestible to through the Microsoft Windows Apps Store back-end ingestion processes; which means that the
file format for these packages will be an .AppX package.
OVERVIEW
The xPlatAppx project includes:
xPlatAppx - A shared library (DLL on Win32, dylib on MacOs, SO on Linux) that exports a subset
of the functionality contained within appxpackaging.dll on Windows. See:
https://msdn.microsoft.com/en-us/library/windows/desktop/hh446766(v=vs.85).aspx
for additional details.
On platforms that do not support COM (e.g. anything _other_ than Windows) instead of
CoCreating IAppxFactory, a c-style export: CoCreateAppxFactory is provided instead.
See sample folder at root of package for cross platform consumption examples
Finally, there are two additional exports: 'Pack' and 'Unpack' that provide
simplified package and unpackage implementations respectively.
MakeXplatAppx - A command line wrapper over the Pack and Unpack implementations. This tool exists
primarily as a means of validating the implementation of xPlatAppx internal routines
and is compiled for Win32, MacOS, and Linux platforms.
PREREQUISITES
Make sure that you have CMAKE installed on your machine
* https://cmake.org/download/
VS 2017 clients:
----------------
Open Visual Studio 2017
File->Open Folder->navigate to project root and select "CMakeLists.txt"
See: https://blogs.msdn.microsoft.com/vcblog/2016/10/05/cmake-support-in-visual-studio/
for details regarding how to configure your environment.
Xcode clients:
--------------
open terminal, from project root:
mkdir build && cd build && cmake -DMACOS=on -G"Xcode" ..
open xcode
File->Open->navigate to project root/build and select "Project.xcodeproj"
See: https://www.johnlamp.net/cmake-tutorial-2-ide-integration.html#section-Xcode for additional details
BUILD
On Windows using Visual Studio 2017 nmake:
makewin32.cmd
On Mac using make:
./makemac
SUPPORT
TODO: write stuffs here
HOW TO CONTRIBUTE TO xPlatAppx
TODO: write stuffs here