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:
- From within a project, right-click the project name and select "Manage NuGet Packages..." from the menu:
Click to enlarge; ESC to exit. - Click "Browse" (if necessary) and enter "EMDK" in the search box. The Symbol.XamarinEMDK package appears:
Click to enlarge; ESC to exit. - Select the package to show its info and Install button.
Then click "Install" button:
Click to enlarge; ESC to exit. - Click the "I Accept" button to accept the license, if necessary.
Click to enlarge; ESC to exit. - 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:
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:
- In the project, select Project -> "Add NuGet Packages..."
Click to enlarge; ESC to exit. - Enter "EMDK" in the search box. The Symbol.XamarinEMDK package appears:
Click to enlarge; ESC to exit. - Select the package and click the "Add Package" button.
Click to enlarge; ESC to exit. - Click "Accept" to accept the license when prompted:
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:
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:
Click to enlarge; ESC to exit.