Removing previous EMDK installations
Note: Before upgrading, previous versions of the EMDK for Android should be removed.
Removing SDK add-ons
- Navigate to the /Users/[user]/Library/Android/sdk/add-ons directory.
- Remove addon-symbol_emdk-symbol-XX folders.
Removing Wizard Core
- Navigate to /Users/Shared directory.
- Remove Symbol EMDK for Android folder.
Removing Wizard plug-in
- Launch Finder and go to Applications (on the left side panel)
- Locate Android Studio.app right click and select Show Package Contents.
- Locate the Contents\plugins directory.
- Remove the com.symbol.emdk.wizard.intellijIdea_3.1.xx folder.
Installing Android Studio
Go to https://developer.android.com/sdk/index.html.
Click on the "Download Android Studio for Mac" button.
Accept the License Agreement and click the "Download Android Studio for Mac" button.
Launch the .dmg file you just downloaded (ex: android-studio-ide-
.dmg). Drag and drop Android Studio into the Applications folder. Open Android Studio and follow the setup wizard to install any necessary SDK tools.
Depending on your security settings, when you attempt to open Android Studio, you might see a warning that says the package is damaged and should be moved to the trash.
If that error occurs:
- Go to System Preferences / Security & Privacy
- Click the padlock icon in the bottom left corner, and login to allow changes in this screen.
- Under Allow applications downloaded from, select Anywhere
- Then open Android Studio again.
If you need to use the Android SDK tools from a command line, you can access them at:
/Users/<user>/Library/Android/sdk/
Configuring Android Studio for EMDK development
In order to develop EMDK apps on Android Studio, API's 16 and 19 Android platforms and Android SDK Build-tools revision 21.1.x or newer must be downloaded and installed.
How to determine which the installed APIs platforms in Android Studio
Launch Android Studio from Applications
Go to Tools / Android / SDK Manager
Then click Launch Standalone SDK Manager link at the bottom of the Android SDK settings page
Check that the status of Android API 19 SDK Platform is "Installed".
If either SDK platform is not installed check the SDK check mark, click Install Packages, and follow the on-screen instructions. When the install is complete, restart Android Studio.
How to determine the Build-tools version installed in Android Studio
Launch Android Studio from Applications
Go to Tools / Android / SDK Manager
Check the status of Android SDK Build-tools 21.1.x or newer is "Installed".
If Android SDK Build-tools 21.1.x or newer is not installed check the SDK check mark, click Install Packages, and follow the on screen instructions. When the install is complete, restart Android Studio.
Installing EMDK
Prerequisites
- Android Studio 1.1.x or newer
- Android API 16, API 19 platforms
- Android SDK Build-tools 21.1.x or newer
Download the EMDK for Android MAC install files
- Download the EMDK for Android MAC install files
- Extract the downloaded zip file and make note of the path to the extracted files. This path will be refered to as EMDK_FILES for the rest of this guide.
The extracted folder will contain the following files
- EMDK add-ons (“
\SDK\addon-symbol_emdk-symbol-16/ “addon-symbol_emdk-symbol-19”) - EMDK Wizard core components (“
\Symbol EMDK for Android”) - EMDK Wizard plug-in for Android Studio (“
\Android Studio\ com.symbol.emdk.wizard.intellijIdea”) - EMDK device runtime (“
\Device Update\ EmdkOSUpdateApp_vX.X.X.apk”)
NOTE: Instructions for installing EmdkOSUpdate on Mac can be found in the Device Setup guide.
EMDK SDK add-on Integration
Add EMDK APIs to the Android SDK
Navigate to the /Users/username/Library/Android/sdk/add-ons directory.
Copy the following EMDK sdk addon folders from EMDK_FILES/SDK/ into the add-ons directory.
- addon-symbol-emdk_vX.X_API-16
- addon-symbol-emdk_vX.X_API-19
Exit & Launch Android Studio
Go to Tools > Android > SDK Manager
Now the integrated EMDK add-ons should appear in the SDK Manager
EMDK Wizard plug-in Integration
Configuring Mac OS X with EMDK Wizard core components
Locate the /Users/Shared folder.
Copy EMDK_FILES/Symbol EMDK for Android folder into the /Users/Shared folder.
Integrate the EMDK Wizard plug-in into Android Studio
Launch Finder and go to the Applications folder.
Locate Android Studio.app, right click and select Show Package Contents.
Locate the Contents\plugins directory.
Copy com.symbol.emdk.wizard.intellijIdea_x.x.xx folder from EMDK_FILES/Andoid Studio into the plugins directory.
Exit & Launch Android Studio.
Now the “EMDK” menu should appear in the Android Studio menu bar:
- Launch EMDK -> About to see installed EMDK Wizard components.
Uninstalling EMDK for Android
To uninstall the EMDK for android perform the following steps:
Note: It is recommended that you close all Android Studio IDE windows before proceeding with uninstallation.
Remove the EMDK SDK add-on by deleting the following folders from
/Users/**username**/Library/Android/sdk/add-ons
- addon-symbol-emdk_vX.X_API-16
- addon-symbol-emdk_vX.X_API-19
Locate the /Users/Shared folder then delete the Symbol EMDK for Android folder.
Remove the EMDK for Andrdoid IDE plugin:
Locate Android Studio.app in your Applications folder, right click and select Show Package Contents.
Locate the Contents\plugins directory.
Delete com.symbol.emdk.wizard.intellijIdea_x.x.xx folder from the plugins directory.
Configuring ADB connectivity with Symbol Android devices on Mac OSX
The ADB connectivity on Mac OS X for Symbol Android devices will not be successful by default. Therefore the Symbol Vendor ID needs to be specified under third party USB Vendor ID list to get the device connected on Mac OS X.
NOTE: The Google Mobile Service (GMS) devices (ex: TC 55 GMS) will be connected without any change to the USB Vendor ID list.
To add the Symbol Vendor ID to ADB:
- Enter the following command using a terminal:
echo 0x05e0 >> ~/.android/adb_usb.ini
- Next, navigate to the ADB directory:
cd /Users/<user>/Library/Android/sdk/platform-tools/
- Stop the the adb service if it is running:
./adb kill-server
- Connect a Symbol Android device and enter the following command verify the list of attached devices:
./adb devices