FeedHenry native .NET SDK for Windows Phone 8+ and Xamarin platform. It supports Portable Class Library (PCL) projects as well.

You can install the SDK to your project either automatically (using NuGet) or manually.

FH SDK is available on NuGet: https://www.nuget.org/packages/FH.SDK/. If you are using the NuGet plugin on Visual Studio or Xamarin Studio, please search for FH.SDK. NuGet will install dependecy libraries automatically.

The .dll assembly files can be found in the Distribution directory. Please use the .dll files inside the folder that is corresponding to your project's target platform. The SDK is depending on Json.Net and Microsoft HTTP Client Libraries. You need to install the assemblies of those libraries as well if they are not available in your project.

Initialise the SDK. Normally it should be called immediately after the app finish initialising. FHClient is available in the following namespaces:

• FHSDK.Phone - For WP8
• FHSDK.Droid - For Android
• FHSDK.Touch - For iOS

Depending on your app's build target, only one of these name spaces should be available to your app.

The main reason for having the same FHClient class defined in different name spaces is to ensure that the platform-specific assembly file is loaded correctly.

try {
  bool inited = await FHClient.Init();
  if(inited) {
    //Initialisation is successful
  }
}
catch(FHException e) {
  //Initialisation failed, handle exception
}

Invoke a cloud function. Can be used in PCL projects.

FHResponse response = await FH.Cloud("api/echo", "GET", null, null);
if(null == response.Error)
{
  //no error occured, the request is successful 
  string rawResponseData = response.RawResponse;
  //you can get it as JSONObject (require Json.Net library)
  JObject resJson = response.GetResponseAsJObject();
  //process response data
}
else
{
  //error occured during the request, deal with it. 
  //More infomation can be access from response.Error.InnerException
}

Call the FeedHenry Authentication API with the given policyId. This is normally used for OAuth type authentications. The user will be prompted for login details and the the login result will be returned. Can be used in PCL projects.

string authPolicy = "TestGooglePolicy";
FHResponse res = await FH.Auth(authPolicy);
if (null == res.Error)
{
    //auth is successful
}
else
{
    //auth failed
}

Return the url of the cloud host the app is communicating with. Can be used in PCL projects.

Invoke a cloud function which you have defined in cloud/main.js (the old way). Can be used in PCL projects.

For full list of APIs, please check FH .NET SDK API References.

See Sync Client Usage Guide.

The complete FH .NET SDK contains four projects:

• FHSDK

  A PCL library contains core code. It is required by all the other three projects. Most the the APIs are implemented here. It contains a few interface definitions which are implemented in each platform's project. Another important function of this library is to automatically figure out the correct implementions for the inferfaces when running on devices (see code in FHSDK/Adaptation). The assembly file built by the project can be used by other PCL projects.

• FHSDKPhone

  A WP8 library project. Contains implementaion details for WP8 platform.

• FHXamarinAndroidSDK

  A Xamarin Android library project. Contains implementaion details for Android platform.

• FHXamarinIOSSDK

  A Xamarin IOS library project. Contains implementaion details for iOS platform.

There are 3 test projects ceated for each platform:

• FHSDKAndroidTest (NUnit Lite for Android)
• FHSDKIOSTest (NUnit Lite for IOS)
• FHSDKWindowsPhoneTestNative (WindowsPhoneUnitTest)

They all link to the test files in FHSDKTestShared project.

Before running the test, make sure the TestCloudApp is running somewhere, and update the following files to point them to the cloud app:

• fhconfig.local.properties
• fhconfiglocal.plist
• fhconfig.local.json

Then you can deploy the test projects to the emulators or devices and run the tests (For Windows Phone, just run the tests using Visual Studio).

Open FHSDK.sln solution in Visual Studio and build for Xamarin open FHSDK.sln in xamarin folder

To generate and publish the API docs, please do the following:

• Build the FHDotNetSDKDoc project
• Commit changes
• Checkout gh-pages branch
• Merge the branch which contains the latests docs
• Push gh-pages to remote repo

• Make sure FHSDK, FHSDKPhone, FHXamarinAndroidSDK and FHXamarinIOSSDK projects are building correctly.
• Run copyLibs.bat
• Bump version in Dist/FHSDK.nuspec file
• Make sure nuget.exe is installed and on the PATH. Download From here
• Run

nuget setApiKey <api key>
nuget pack FHSDK.nuspec
nuget push FH.SDK.<VERSION>.nupkg