Readium Test App for Windows 8.1

This is a Windows Store test app that exists to determine if/how we can get Readium working on Windows 8.1. NOTE: there is no chance this will work on Windows 8.0.

Table of Contents

• Dependencies
• Linking to the Readium SDK
• Passing Cert
• Copying Readium Web Content
• Displaying an ePub in a WebView

Dependencies

• Readium SDK, use the win8 branch.
• Visual Studio 2013.
• Windows 8.1 SDK.
• Patience.

Linking to the Readium SDK

There are to ways to link to the Readium SDK: a direct reference to the .winmd file, or using the system-installed version of the SDK (after running the VSIX installer).

Linking directly to .winmd file

As we're linking the .winmd files rather than including the Readium SDK project in the app solution you must change the .winmd reference to the proper build type (i.e., if you're making a Release build you must link to the Release version of the .winmd).

Change which .winmd file is being referenced by right-clicking the ReadiumApp.Window project in the Solution Explorer then selecting Properties.... In the left-hand pane select References under Common Properties, then click the Add New Reference... button to link to the correct .winmd file as described earlier.

Linking to VSIX SDK

Go to Add New Reference... as above, but select Windows 8.1 > Extensions > Readium SDK instead of selecting the .winmd file directly.

Passing Cert

All Windows Store apps must pass all the tests in the Windows App Cert Kit v3.4 (this should be installed along either the Windows SDK or Visual Studio).

Only the Release build of the app will pass cert as Debug builds are not allowed on the Store.

Copying Readium Web Content

In the Assets folder of the Windows project there is a sub-folder called readium-js that is required to load web content. Currently this folder is not part of the project (and I'm unable to add it for some reason or another) and must be manually copied to the output folder which is in the root of the repo and called Debug or Release depending on how you're building.

Displaying an ePub in a WebView

To display an ePub we use WebView's NavigateToLocalStreamUri. This allows us to provide a stream resolver which effectively acts as an HTTP server (HTTP servers are what all the other launcher apps use but there is no off-the-shelf HTTP server for WinRT). Microsoft's explanation and documentation of the functionality is somewhat..lacking...but this helpful article does a good job of explaing how NavigateToLocalStreamUri works with examples.