Skip to content
MSIX SDK
Branch: master
Clone or download
wcheng-msft Split Extractor into extractor and VirtualFileHandler (#180)
* in progress, tryng to figure out how to best handle different error modes

* Revert "in progress, tryng to figure out how to best handle different error modes"

This reverts commit e9ab631.

* split in progress

* moved vfs changes over to  virtualfilehandler, unverified

* Split VFS handling from Extractor into a separate handler--VirtualFileHandler
Fixed start menu shortcut to write to per-machine instead of per-user (unintentionally missed when we switched back to per-machine)
Fixed the executable path pointed by the start menu shortcut and other paths to point to the devirtualized location rather than the copy inside the VFS directory.
Fixed issue where extra empty directories were left behind during removal.
Tests currently pass
Latest commit 8f8901f Jul 18, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates (#64) Mar 13, 2019
cmake Fix VS2019 build (#138) May 20, 2019
lib Allow explicit selection of crypto library; fixes and improvements fo… Apr 8, 2019
pipelines msixtest - use catch2 as our test infrastructure for all supported pl… May 30, 2019
preview/MsixCore Split Extractor into extractor and VirtualFileHandler (#180) Jul 18, 2019
resources Add 19H1 schemas and enable manifest schema validation for Xerces (#82) Apr 10, 2019
sample msixtest - use catch2 as our test infrastructure for all supported pl… May 30, 2019
src Create def file for windows (#156) Jun 19, 2019
.gitattributes Git lfs test (#145) May 29, 2019
.gitignore msixtest - use catch2 as our test infrastructure for all supported pl… May 30, 2019
CMakeLists.txt msixtest - use catch2 as our test infrastructure for all supported pl… May 30, 2019
CMakeSettings.json Add VS 2019 direct CMakeCache config (#98) Apr 25, 2019
CODEOWNERS Update Readme.md and CODEOWNERS (#147) May 29, 2019
LICENSE update Sep 21, 2018
Microsoft.MSIX.Packaging.targets Merged PR 2853269: Provide platform-specific nuget packages for msix Feb 9, 2019
Package.nuspec.cmakein Prepare for 1.6 Feb 9, 2019
ProjectIcon.png Merged PR 1028022: Merge xerces to feature Oct 27, 2017
README.md Update Readme.md and CODEOWNERS (#147) May 29, 2019
THIRD PARTY CODE NOTICE msixtest - use catch2 as our test infrastructure for all supported pl… May 30, 2019
makeaosp.sh Add 19H1 schemas and enable manifest schema validation for Xerces (#82) Apr 10, 2019
makeaosponwinx86.cmd Merged PR 2342853: [MSIX SDK] reduce binary size on android by switch… Oct 9, 2018
makeios.sh Add 19H1 schemas and enable manifest schema validation for Xerces (#82) Apr 10, 2019
makelinux.sh Add 19H1 schemas and enable manifest schema validation for Xerces (#82) Apr 10, 2019
makemac.sh Add 19H1 schemas and enable manifest schema validation for Xerces (#82) Apr 10, 2019
makewin.cmd Allow explicit selection of crypto library; fixes and improvements fo… Apr 8, 2019
manifest.cmakein Implement Windows8+ Applicability PAL Sep 21, 2018
release_master.cmd Fix release break due to CMakeList.txt dependency on description cont… Oct 27, 2017
release_master.ps1 Fix release break due to CMakeList.txt dependency on description cont… Oct 27, 2017
tdf-guidance.md Merged PR 2161980: referring to MSIX Packaging SDK as MSIX SDK Sep 21, 2018

README.md

MSIX SDK

Copyright (c) 2019 Microsoft Corp. All rights reserved.

Description

The MSIX SDK project is an effort to enable developers on a variety of platforms to unpack packages for the purposes of distribution from either the Microsoft Store, or their own content distribution networks.

The MSIX Packaging APIs that a client app would use to interact with .msix/.appx packages are a subset of those documented here.

Overview

The MSIX SDK project includes cross platform API support for unpacking of .msix/.appx packages

msix A shared library (DLL on Win32, dylib on macOS, SO on Linux and Android) that exports a subset of the functionality contained within appxpackaging.dll on Windows. See here for additional details.
On all platforms instead of CoCreating IAppxFactory, a C-style export: CoCreateAppxFactory is provided. Similarly, the CoCreateAppxBundleFactory export is equivalent as CoCreating IAppxBundleFactory.

The 'UnpackPackage' and 'UnpackBundle' exports that provide a simplified unpackage implementation. See the samples directory for usage of the SDK.
makemsix A command line wrapper over the UnpackPackage and UnpackBundle implementations. This tool exists primarily as a means of validating the implementation of the MSIX SDK internal routines and is compiled for Win32, macOS, and Linux platforms.

Guidance on how to package your app contents and construct your app manifest such that it can take advantage of the cross platform support of this SDK is here.

Release Notes

Release notes on the latest features and performance improvements made to the SDK are listed here

Setup Instructions

  1. Clone the repository: git clone [URL]

Issues

If you are using Visual Studio 2017 and you run into errors about not being able to find the v140 toolset:

  1. Install the Microsoft Build Tools (https://chocolatey.org/packages/microsoft-build-tools)
  2. Start -> visual studio installer -> Visual Studio Build Tools 2017 -> Modify the 2014 toolset -> individual components
  3. Make sure that VC++ 2015.3 v140 toolset for desktop is selected and then unselect VC++ 2017 141 toolset
  4. Close, then re-open the solution.

Dependencies

Depending on the platform for which the MSIX shared library (MSIX.DLL | libmsix.dylib | libmsix.so) is compiled, one or more of the following dependencies may be statically linked into the binary:

For convinience, Zlib, Xerces-C and OpenSSL are git-subtrees that are mapped in under the lib folder of this project. Edits on top of these subtrees for build related optimizations are tracked within this repository. OpenSSL is only used on non-Windows platforms

The Android NDK is only required for targeting the Android platform.

Prerequisites

The project uses git-lfs to store some large binary test files. You can find out more and install it from here:

https://git-lfs.github.com/

Make sure that you have CMAKE installed on your machine

One or more of the following prerequisites may also be required on your machine:

Ninja-build:

https://github.com/ninja-build/ninja/releases

Android NDK:

https://developer.android.com/ndk/downloads/index.html

Clang/LLVM:

http://releases.llvm.org/download.html

VS 2017 clients:

Open Visual Studio 2017 File->Open Folder->navigate to project root and select "CMakeLists.txt"

See cmake-support-vs 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 cmake-Xcode-integration for additional details

Build

On Windows using Visual Studio nmake:

   makewin.cmd <x86|x64> -mt

   This will start MSVC environment calling vcvarsall.bat <arch>, clean the output directory, call cmake and nmake. The latest Visual Studio version is obtained by calling vswhere.exe 

On Mac using make:

   ./makemac
   ./makeios

On Linux using make:

   ./makelinux
   ./makeaosp

How to compile for Android on Windows:

  • Unpack the latest Android NDK to c:\android-ndk
  • Unpack Ninja-build to c:\ninja
  • Add c:\ninja to the path environment variable
  • Create a folder under the root of the enlistment called "android", cd into that folder, then run the following command to create ninja build files:
    cmake -DCMAKE_ANDROID_NDK=c:/android-ndk ^
        -DCMAKE_ANDROID_NDK_TOOLCHAIN_VERSION=clang ^
        -DCMAKE_SYSTEM_NAME=Android ^
        -DCMAKE_SYSTEM_VERSION=19 ^
        -DCMAKE_ANDROID_ARCH_ABI=x86 ^
        -DCMAKE_ANDROID_STL_TYPE=c++_shared ^
        -DCMAKE_BUILD_TYPE=Release ^
        -DAOSP=on ^
        -G"Ninja" ..

To compile, run the following command from the android folder:

    ninja

Build Status

The following native platforms are in development now:

Windows

master
Debug x32 Build Status
Debug x64 Build Status
Release x32 Build Status
Release x64 Build Status
Release x32 Validation Parser Build Status
Release x64 Validation Parser Build Status
Release x32 Xerces Build Status
Release x64 Xerces Build Status

Built in the Azure Pipelines Hosted VS2017 pool. See specifications here

macOS

master
Debug Build Status
Release Build Status

Built in the Azure Pipelines macOS pool. See specification here

iOS

master
Debug emulator Build Status
Release emulator Build Status
Release arm64 Build Status

Built in the Azure Pipelines macOS pool. See specification here

Android

master
Debug emulator Build Status
Release emulator Build Status
Release arm Build Status

Built in the Azure Pipelines macOS pool. See specification here

Linux

master
Debug Build Status
Release Build Status
Release Validation Parser Build Status

Built in the Azure Pipelines Hosted Ubuntu 1604. See specification here

Windows 7 support

The MSIX SDK is fully supported and tested on Windows 7. However, an Application Manifest MUST be included to any executable that is expected to run on Windows 7 and uses msix.dll. Specifically, the Application Manifest MUST include the supportedOS flags for Windows 7. The manifest is not included on msix.dll because the compat manifest doesn't matter on DLLs. See the manifest that is used for makemsix and samples of this project as example. The Windows 7 machine might also require the Microsoft Visual C++ Redistributable binaries installed to run properly.

Android support

The MSIX SDK minimum supported for Android is API Level 19.

We also produce msix-jni.jar which acts as a helper to get the languages from the Android device. Because of it, we expect either a -DANDROID_SDK and -DANDROID_SDK_VERSION on the cmake command and, if not present, we default to $ANDROID_HOME and 24 respectively. The default level for the SDK level is 24 because we use the Configuration class and, depending on the version of the device, we either use the locale attribute (deprecated as of API level 24) or getLocales. We recommend using the makeaosp script to build for Android on non-Windows devices.

Testing

Unit tests should be run on builds that have the "Release" or "RelWithDebug" CMAKE switch.

First build the project, then:

On Windows: From within powershell, navigate to test\Win32, and run ".\Win32.ps1"

On Mac & Linux: From within bash, navigate to test/MacOS-Linux, and run "./MacOS-Linux-Etc.sh [Apple|Linux]"

Testing on mobile platforms:

On iOS : First build the project for iOS, then launch xCode and load test/mobile/iOSBVT.xcworkspace, compile the test app, and then launch the iPhone simulator. You can also run "./testios.sh" from test/MacOS-Linux.

On Android: From within bash, navigate to test/MacOS-Linux, and run "./testaosponmac.sh". The test assumes there's an Android emulator named Nexus_5X_API_19_x86 and the build output is on a .vs directory at the root of the project.

Releasing

If you are the current maintainer of this project:

  1. Pull latest payload to release in master
  2. Confirm that all platforms/architectures/flavors build and all BVTs pass
  3. From a windows cmd prompt: release_master.cmd
  4. Confirm that new branch called "release_v1.xxx" where "xxx" is the next incremental version is created

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repositories using our CLA.

If you have any questions or comments, you can send them our team directly!

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Report a Computer Security Vulnerability

If you are a security researcher and believe you have found a security vulnerability that meets the definition of a security vulnerability that is not resolved by the 10 Immutable Laws of Security, please send e-mail to us at secure@microsoft.com. To help us to better understand the nature and scope of the possible issue, please include as much of the below information as possible.

  • Type of issue (buffer overflow, SQL injection, cross-site scripting, etc.)
  • Product and version that contains the bug, or URL if for an online service
  • Service packs, security updates, or other updates for the product you have installed
  • Any special configuration required to reproduce the issue
  • Step-by-step instructions to reproduce the issue on a fresh install
  • Proof-of-concept or exploit code
  • Impact of the issue, including how an attacker could exploit the issue

Microsoft follows Coordinated Vulnerability Disclosure (CVD) and, to protect the ecosystem, we request that those reporting to us do the same. To encrypt your message to our PGP key, please download it from the Microsoft Security Response Center PGP Key. You should receive a response within 24 hours. If for some reason you do not, please follow up with us to ensure we received your original message. For further information, please visit the Microsoft Security Response Policy and Practices page and read the Acknowledgment Policy for Microsoft Security Bulletins.

For additional details, see Report a Computer Security Vulnerability on Technet

You can’t perform that action at this time.