EMDK Setup

EMDK for Xamarin 8.0

Starting with version 3.0, EMDK for Xamarin development tools are installed from NuGet packages and updated using the NuGet package management system. The EMDK-X NuGet package adds to Microsoft Visual Studio the API libraries required for building Android applications with Xamarin. The package must be added to any Android project before the APIs are available for use.

These instructions apply to:

  • Visual Studio 2022 for Windows (incl. Community Edition) NEW!!
  • Visual Studio 2019 for Windows and MacOS
  • Visual Studio 2017 for MacOS

EMDK-X no longer supports Visual Studio 2017 for Windows


Prerequisites

The following software is required to use EMDK for Xamarin:

Windows:

  • Visual Studio 2022 or 2019 for Windows
  • Windows 7, 8, 8.1, 10 (32- or 64-bit)
  • Java Development Kit (JDK) v7u45 or newer

MacOS:

  • Visual Studio 2019 or 2017 for MacOS
    (Xamarin Studio no longer supported)
  • MacOS X 10.11 (El Capitan) or newer
  • Java for OS X 2014-10x or newer
  • Java Development Kit (JDK) v7u75 or newer

Targeting Android 11

Due to package visibility restrictions imposed by Android 11 (API 30), EMDK apps targeting A-11 (or later) must include the following <queries> element in their AndroidManifest.xml file:

  
  <queries>
     ...
     <package android:name="com.symbol.emdk.emdkservice" />
     ...
  </queries>

Apps targeting API 29 (or earlier) have no such restriction; no change to the <queries> element is required.


Install EMDK Plug-in

Windows

The following instructions apply to Visual Studio 2019 (or later). A supported version of Visual Studio must be installed to complete the steps below. If necessary, install Visual Studio before proceeding.

To install the NuGet package in Visual Studio for Windows:

  1. From within a project, right-click the project name and select "Manage NuGet Packages..." from the menu: image Click to enlarge; ESC to exit.

  2. Click "Browse" (if necessary) and enter "EMDK" in the search box. The Symbol.XamarinEMDK package appears: image Click to enlarge; ESC to exit.

  3. Select the package to show its info and Install button.
    Then click "Install" button: image Click to enlarge; ESC to exit.

  4. Click the "I Accept" button to accept the license, if necessary. image Click to enlarge; ESC to exit.

  5. Repeat Steps 1–4 for each project that uses EMDK for Xamarin APIs.

The project is ready to use EMDK for Xamarin APIs.


Note for Visual Studio 2019 users:

In Visual Studio 2019, an EMDK sub-menu is displayed in the "Extensions" menu similar to the image below: image Click to enlarge; ESC to exit.


MacOS

The following instructions apply to supported versions of Visual Studio, which must be installed to complete the steps below. If necessary, install Visual Studio before proceeding.

To install the NuGet package in Visual Studio 2017 for Mac:

  1. In the project, select Project -> "Add NuGet Packages..." image Click to enlarge; ESC to exit.

  2. Enter "EMDK" in the search box. The Symbol.XamarinEMDK package appears: image Click to enlarge; ESC to exit.

  3. Select the package and click the "Add Package" button. image Click to enlarge; ESC to exit.

  4. Click "Accept" to accept the license when prompted: image Click to enlarge; ESC to exit.

The project is ready to use EMDK for Xamarin APIs.


Remove EMDK Plug-in

Windows

To remove the EMDK for Xamarin NuGet package from a Windows project:

From within a project, right-click the Symbol.XamarinEMDK package and select "Remove" as below: img


MacOS

To remove the EMDK for Xamarin NuGet package from a MacOS project:

From within a project, right-click the Symbol.XamarinEMDK package and select "Remove" as below: image Click to enlarge; ESC to exit.