C# SDK
Last Modified: 11/23/21
The EdgeXR Client Library enables an application to register and then locate the nearest edge cloudlet backend server for use. The client library also allows verification of a device's location for all location-specific tasks. Because these APIs involve networking, most functions will run asynchronously, and in a background thread.
The Matching Engine C# SDK provides everything required to create applications for your devices.
Note: If you are want to develop Apps using Unity, please see the Unity C# SDK documentation, here.
Prerequisites
Visual Studio Community 8.4 or later.
.Net Standard 2.0
Nuget
A running AppInst on your edge server
An Android or iOS device to test with
A SIM card from a supported carrier for initial application development is recommended; alternatively, if a supported carrier is not available, Wifi may be utilized
Download the C# SDK and libraries
Step 1: Create a login and an Organization on the Console. The creation of a login will automatically generate a user account and allows for access to Artifactory, giving you access to the C# Nuget repository.
Note: With a login, you can download the C# SDK library as well as upload a server image to install on the edge network.
Step 2: Access the C# MatchingEngine library using Nuget.
Step 2a: Type nuget sources Add -Name EdgeXR -Source https://console.cloud.edgexr.org/storage/v1/artifacts/artifactory/api/nuget/nuget-releases -username <yourUserName> -password <yourPassword>
.
Step 2b: Type nuget list -Source "EdgeXR"
.
Step 2c: Type nuget install EdgeXR.MatchingEngineSDKRestLibrary
. This will retrieve the latest version automatically.
Step 3: Locate the pre-extracted MatchingEngineSDKRestLibrary.dll file in the home directory.
~/.nuget/packages/mobiledgex.matchingenginesdkrestlibrary
cd ~/.nuget/packages/mobiledgex.matchingenginesdkrestlibrary/<newest_version>/lib/netstandard2.0/
cp MatchingEngineSDKRestLibrary.dll <unity project>/Assets/Plugins
Optional Step
If you prefer to add the Nuget package using the Visual Studio Community IDE instead, follow these steps.
Step 1: Right-click on your project dependencies folder.
Step 2: Select Manage Nuget Packages.
Step 3: Add the same source repository provided in Step 2 above.
Step 4: Select the most recent library version.
Where to Go from Here
Access the EdgeXR C# Library for examples and sample code, here.