#Interop REST Mail Contacts Calendar App Android Configuration
Before you configure your app, you need to register your app with an Office 365 Developer account. The directions for registering are in the README.md file in the root of this repo. Once your app is registered, install the Android SDK and you're ready to get started configuring your app for Android.
##Table of Contents
###Install Android SDK
The Android SDK can be downloaded from the Android Developer site here. You may also need to install JDK (Java SE Development Kit). If you have questions about installing JDK, you can refer to this tutorial.
For the full installation instructions visit the Android Developer Website.
###Android Configuration
-
Download or clone The Interop REST Mail Calendar Android App.
-
Start Android Studio
- Click Run > Run 'app' or click the green triangle play button. Please note, it can take several minutes to start the emulator and the app.
- The first time you run the app you will need to add an ARM device to the emulator. To do this:
Click on the ellipsis (three dots in a row) next to the down arrow.

Click Create Virtual Device on the next menu.

Choose a device with a resolution higher than 1200 X 800 and click Next

Check Show downloadable system images and select an option with armeabi-v7a for ABI and click next.

Select the device you created and click the green arrow at the end of the line

- The next time you start the app, you can skip step 5 and select a device by clicking the down arrow next to "Android virtual device:". To add more devices simply repeat step 5 for as many devices as you want to add.
If you get the error message:
emulator: ERROR: x86 emulation currently requires hardware acceleration!
Please ensure Intel HAXM is properly installed and usable.
CPU acceleration status: HAX kernel module is not installed!
Refer to this Stackoverflow question for how to install HAXM
-
Your app will now start in the emulator. But in order to connect the app to an account, you first have to Register the app with Office 365 and copy your "CLIENT ID" and "REDIRECT URI". The directions for registering are in the README.md file in the root of this repo.
-
You can enter your "CLIENT ID" and "REDIRECT URI" by clicking on the three vertical dots in the upper right of the emulator screen and click settings and enter them there or navigate to app > src/main > java > com/microsoft/office365/meetingmgr > Constants.java and paste your "CLIENT ID" and "REDIRECT URI" as strings and save the file.
![]() |
![]() |
![]() |
|---|
- Click CONNECT TO OFFICE 365 and the app will start.
- Your app is now ready for you to build with. Go create something awesome!
##Visual Studio Emulator Configuration
Android Studio comes with its own Android emulator, but Microsoft has designed an emulator focused on performance, speed, and efficiency that can be used independently or in conjunction with Visual Studio 2015. You can learn more about the Visual Studio Emulator for Android here.
###Install Visual Studio Android Emulator
You can download and install the Visual Studio Emulator for Android from this page. Then you can use it as a stand-alone emulator or in conjunction with Visual Studio.
The Visual Studio Emulator for Android does not require you to download and/or use Visual Studio, but if you would like to use the free (Community) or paid (Enterprise) Visual Studio, you can download and install either version from the Visual Studio Website. Whichever version you choose, it must be Visual Studio 2015 in order to run the emulator.
###Launch the App in Visual Studio Android Emulator
There are two ways to launch the Visual Studio Android Emulator, as a stand-alone emulator and through Visual Studio. Which way you want to use the emulator determines how you start it, but after that the steps are the same.
####As a Stand-Alone Emulator
To launch the Visual Studio Android Emulator as a stand-alone emulator, click on the Start menu and search for "emulator" and select Visual Studio Emulator for Android
####As Part of Visual Studio
To launch the Visual Studio Android Emulator as part of Visual Studio, click on the Start menu and search for "Visual Studio" and click on Visual Studio 2015
- Once the emulator has started, choose a device by clicking the green triangle next to your choice.
-
When you have chosen a device, open your project in Android Studio and start your app using steps 3 - 4 in the Android Configuration section above.
-
After running your app, instead of choosing to launch the emulator, select Choose a running device and then select a device using the VS Emulator then click OK.
- Your app will now open the connect page in the Visual Studio Emulator for Android. To login and use the app, complete steps 7 - 10 in the Android Configuration section.
###Copyright
Copyright (c) 2016 Microsoft. All rights reserved.











