Windows Bridge for iOS (WinObjC)

This project provides an OpenAL-soft shared library specifically for Windows Store Apps and Windows Phone 8.0+. It is a fork of the standard OpenAL-soft to add support for these platforms. It includes two back-ends:

• Xaudio2: The default back-end.
• WASAPI (Windows Audio Session API): An alternative back-end.

NSInvocation is a Foundation class that provides an object representation of a method call by encapsulating a target, a selector, and a pack of arguments. In the Windows Bridge for iOS, NSInvocation is designed to lay out arguments at runtime based on the Objective-C method signature, ensuring the internal memory layout matches the platform's preferred argument frame (registers, stack, etc.).

This design allows for:

• Efficient argument dispatching with minimal copying.
• Reversible memory layouts, enabling forwardInvocation: to quickly package partially-evaluated method dispatches into a boxed NSInvocation object.

The ObjC2Winmd tool converts Objective-C middleware into WinRT Components (.winmd and .dll). It wraps Objective-C types into WinRT types and vice-versa.

To use the tool, follow these steps:

1. Use VSImporter (from WinObjC.Tools) to import your Objective-C middleware to Islandwood.
2. Configure public headers in the generated .vcxproj file.
3. Add necessary Doxygen-style annotations to your public header files to ensure correct type marshalling.
4. Rebuild the solution. The WinRT wrapper files will be generated under the <Middleware Name>WinRT.vcxproj project, producing the final *.winmd and *.dll files.

To enable automatic session tracking and page view collection, initialize the SessionTracking object in your application's lifecycle.

1. In App.xaml.h, declare a member variable: ApplicationInsights::CX::SessionTracking^ m_session;

2. In App.xaml.cpp, use the ApplicationInsights::CX namespace and initialize the session in the App::App() constructor: m_session = ref new ApplicationInsights::CX::SessionTracking();

3. Once the root Frame is created (typically at the end of App::OnLaunched), initialize the session with your Instrumentation Key: m_session->Initialize(this, rootFrame, iKey);

To ensure the tool processes your headers correctly, you must explicitly mark them in the generated .vcxproj file.

Enable Public Header Exporting

Search for the <Keyword>IslandwoodProj</Keyword> tag in your .vcxproj file. Immediately after it, add the following line:

<ExportPublicHeaders>true</ExportPublicHeaders>

Mark Individual Headers as Private

To mark a specific header as private, find the header's entry in the .vcxproj file and add the <PublicHeader> tag with a false value:

<ClInclude Include="MyHeader.h">
  <PublicHeader>false</PublicHeader>
</ClInclude>

<!-- Example of marking a header as private -->
<ClInclude Include="MyHeader.h">
  <PublicHeader>false</PublicHeader>
</ClInclude>