Skip to content
This repository was archived by the owner on Feb 19, 2026. It is now read-only.

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 

#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

  1. Download or clone The Interop REST Mail Calendar Android App.

  2. Start Android Studio

  3. Click on Open an existing Android Studio project and select the folder that contains the app, then open the "MeetingManagerAndroid" folder then the "Android" folder and select the build.gradle file.

Open the App in Android Studio

App file location

  1. 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.

Run the app

  1. 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. Add ARM emulator

Click Create Virtual Device on the next menu. Create virtual device

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

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

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

  1. 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

Start the emulator

  1. 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.

  2. 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 the three vertical dots Click Settings Enter your "CLIENT ID" and "REDIRECT URI"
  1. Click CONNECT TO OFFICE 365 and the app will start.

  1. 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

launch visual studio android emulator

####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

launch visual studio


  1. Once the emulator has started, choose a device by clicking the green triangle next to your choice.

choose a device

  1. 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.

  2. 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.

choose the vs emulator

  1. 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.