Esper Android Studio Plugin
(Preview Release Version)
Esper Plugin for Android Studio
The Esper Plugin for Android Studio enables developers to upload APKs directly from Android Studio to an Esper Endpoint. Once uploaded to Esper you can use the Esper APIs, SDK, or CLI from Android Studio Terminal to provision devices with the APK for testing or deployment purposes. Or you can go to the Esper Console and work with your APK from there. This guide describes the steps to take to install the Esper Plugin into Android Studio.
Before you start with this guide, make sure you have Android Studio installed, version 181 or greater. To verify your Android Studio go to Help → About. The version number is circled below:
In case you have a version before 181, simply upgrade your Android Studio to the latest version. The latest available version can be installed by clicking on Help → Check for Updates and then following the subsequent prompts. You will also need an account on an Esper Endpoint. Have your Endpoint name, username, and password available. If your company doesn’t have an Esper Endpoint, sign up for an Esper Trial account here.
Next, you will find the Esper Plugin from the Plugin Marketplace; go ahead and install it. Go to File → Settings and then click on Plugins (or Android Studio → Preferences for Mac). Then click on Marketplace:
In the new window that displays, type Esper in the Search plugins in marketplace input field and hit Enter. Click on Install to start the installation process.
The Plugin will then download and install, and you’ll need to restart the IDE to activate the change to your Plugins. If this is the first time you are installing a 3rd-party plugin, Android Studio will show you the following warning:
Click on Accept to proceed. If you have installed third-party plugins before, you will not see this prompt, and you can proceed to the next step. Once Android Studio restarts, check the Event Log in the lower right corner to verify the Plugin successfully installed.
Setup and Use
The setup for the Esper Plugin is Project specific for the currently open Project. If you wish to use the Esper Plugin for other Projects, be sure to perform the setup for each. With your desired Project open, go to File → Settings (or Android Studio → Preferences for Mac). Click on the drop down for Other Settings, and the click on Esper from the resulting list. In the Esper window, type in the relevant credentials for your Endpoint Name, Username, and Password. Hit Apply and then OK.
The Plugin is now configured to your Endpoint for this Project.
Now once you are ready to upload an .apk file to your Endpoint, simply go to Build → Upload APK to Esper:
In the dialog that appears, choose the .apk to upload to your Endpoint, and then hit OK:
You’ll see a dialog box showing the status of the upload process. If the upload succeeds, you will see the following message:
If there's any error, you'll see an error as shown below:
Note that trying to upload the same version of the .apk you already have on your Endpoint will produce an error. You currently cannot overwrite it using the Plugin, you will have to delete it using the Esper Console or from the CLI.
Esper Android Virtual Device
Esper AVD allows the users to experience the Esper Device Policy Controller (DPC) for Android Devices.
When android studio is started, plugin notifies the user about newly avaiable AVDs or updates available for the installed AVDs.
To create or update Esper AVDs, navigate to Tools Menu > Esper AVD Manager.
Click on "Esper AVD Manager".
Click on "Create" or "Update". User will be informed that AVD will be created in background.
Click on "Ok" button. Esper AVD creation happens in background.
After the AVD is created, user will be prompted to restart Android Studio.
Click on Restart. Android Studio will be restarted. After restarted, navigate to Esper Toos Menu > Esper AVD Manager. Esper AVD Manager shows that AVD is up-to-date.
AVD can be launched from Android Studio like other AVDs.
By clicking run app
From AVD Manager
Esper AVD is up.
Experience the amazing DPC by Esper.
To uninstall the Esper Plugin Go to File → Settings (or Android Studio → Preferences for Mac), click on Plugins ensuring you are displaying Installed Plugins. Then click on the Esper bolded Plugin name:
This will bring up the Esper Plugin detail. Go over to the dropdown that is displaying Disable, Click the dropdown and then select Uninstall.
Confirm you wish to uninstall the Plugin by clicking on Yes:
Now click on the Restart IDE button:
Then click Restart to remove the Plugin:
That's it. The Esper Plugin should now be uninstalled.