libHttpClient is still under construction and is not ready to use.
You can review the goals below to see what shape the project will have in its final form. If you want to contribute to the project, please talk to us to avoid overlap.

• libHttpClient provides a platform abstraction layer for HTTP and WebSocket
• Stock implementations that call native platform HTTP / WebSocket APIs on UWP, XDK ERA, iOS, Android
• Caller can add support for other platforms via callback API
• Sample showing off an HTTP implementation via Curl https://github.com/curl/curl via this callback
• Designed around the needs of professional game developers that use Xbox Live
• Will be used by the Microsoft Xbox Live Service API (XSAPI) [https://github.com/Microsoft/xbox-live-api]
• Builds for UWP, XDK ERA, Win32, iOS, and Android
• Public API is a flat C API
• Asynchronous API
• Public API supports simple P/Invoke without needing to use the "C#/.NET P/Invoke Interop SDK" [https://en.wikipedia.org/wiki/Platform_Invocation_Services#C.23.2F.NET_P.2FInvoke_Interop_SDK]
• Public APIs to manage async tasks
• Async data can be returned to a specific game thread so the game doesn't need to marshal the data between threads
• No streams support
• No dependencies on PPL or Boost
• Does not throw exceptions as a means of non-fatal error reporting
• Caller controlled memory allocation via callback API (similar to XDK's XMemAlloc)
• Built-in logging support to either debug output and/or callback
• Built in retry support according to Xbox Live best practices (obey Retry-After header, jitter wait, etc) according to https://developer.microsoft.com/en-us/games/xbox/docs/xboxlive/using-xbox-live/best-practices/best-practices-for-calling-xbox-live
• Xbox Live throttle handling logic
• Built-in API support to switch to mock layer
• Does not require C++/CX to build on UWP or ERA
• Open source project on GitHub
• Binaries eventually on Nuget.org as Nuget packages, and maybe VcPkg
• Unit tests via TAEF
• End to end samples for UWP C++, UWP C# (with P/Invoke layer), XDK ERA, iOS, and Android
• Support for cancellation?

See public header

1. Optionally call HCMemSetFunctions() to control memory allocations
2. Call HCGlobalInitialize()
3. Optionally call HCSettingsSet*()
4. Call HCHttpCallCreate() to create a new HC_CALL_HANDLE
5. Call HCHttpCallRequestSet*() to prepare the HC_CALL_HANDLE
6. Call HCHttpCallPerform() to perform an HTTP call using the HC_CALL_HANDLE. This call is asynchronous, so the work will be done on task thread and it will return via the callback.
7. Call HCHttpCallResponseGet*() to get the HTTP response of the HC_CALL_HANDLE
8. Call HCHttpCallCleanup() to cleanup the HC_CALL_HANDLE
9. Repeat 4-8 for each new HTTP call
10. Call HCGlobalCleanup() at shutdown before your memory manager set in step 1 is shutdown

• On UWP, XDK ERA, iOS, and Android, HCHttpCallPerform() will call native platform APIs
• Optionally call HCGlobalSetHttpCallPerformFunction() to do your own HTTP handling using HCHttpCallRequestGet*(), HCHttpCallResponseSet*(), and HCSettingsGet*()
• See sample CustomHttpImplWithCurl how to use this callback plus Curl https://github.com/curl/curl to make an HTTP implementation using Curl.

Big things that still need to be done in rough priority order:

• [Done] Prototype XSAPI on top of libHttpClient HTTP stack
• [Done] Switch to libHttpClient's task API in https://github.com/Microsoft/xbox-live-unity-plugin/tree/libHttpClient
• [Done] Flush out XML doc comments in header
• [Done] Win32 project & implementation
• [Done] Standalone C++ JSON parser
• [Done] Prototype XSAPI on top of libHttpClient async task stack
• Retry logic
• Throttling logic
• XDK project & XDK implementation calling XDK platform HTTP APIs
• XDK ERA sample
• API for binary request & response data
• Design WebSocket APIs
• Flushout of UWP implementation calling UWP platform WebSocket APIs
• XDK project & XDK implementation calling XDK platform WebSocket APIs
• Prototype XSAPI on top of libHttpClient WebSocket stack
• P/Invoke layer and UWP C# sample
• libHttpClient Unity sample (using P/Invoke layer)
• iOS project & iOS implementation calling iOS platform HTTP APIs
• iOS implementation calling iOS platform WebSocket APIs
• iOS sample
• Android project & Android implementation calling Android platform HTTP APIs
• Android implementation calling Android platform WebSocket APIs
• Android sample
• libHttpClient Unity iOS/Android sample (using P/Invoke layer)

This repo contains submodules. There are two ways to make sure you get submodules.

When initially cloning, make sure you use the "--recursive" option. i.e.:

git clone --recursive https://github.com/Microsoft/libHttpClient.git

If you already cloned the repo, you can initialize submodules with:

git submodule sync
git submodule update --init --recursive

Note that using GitHub's feature to "Download Zip" does not contain the submodules and will not properly build. Please clone recursively instead.

Is there a feature missing that you'd like to see, or have you found a bug that you have a fix for? Or do you have an idea or just interest in helping out in building the library? Let us know and we'd love to work with you. For a good starting point on where we are headed and feature ideas, take a look at our requested features and bugs.

Big or small we'd like to take your contributions back to help improve the Xbox Live Service API for everyone.

We'd love to get your review score, whether good or bad, but even more than that, we want to fix your problem. If you submit your issue as a Review, we won't be able to respond to your problem and ask any follow-up questions that may be necessary. The most efficient way to do that is to open a an issue in our issue tracker.

• Xbox Live Service API for C++
• Xbox Live Samples
• Xbox Live Unity Plugin
• Xbox Live Resiliency Fiddler Plugin
• Xbox Live Trace Analyzer
• Xbox Live Powershell Cmdlets
• libHttpClient

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.