Skip to main content



Before you start, you should have the recommended Tools and Libraries installed. You will also need to install:

  1. Visual Studio 2022
  2. .NET 7 (latest)
    • Note: Even if you have an M1 Mac with ARM 64 architecture, you can install all x64 SDKs to run android
  3. Xamarin (Android)
  4. Android SDK 33

To make sure you have the Android SDK and Emulator installed:

  1. Open Visual Studio

  2. Click Tools > SDK Manager (under the Android subheading)

  3. Click the Tools tab

  4. Make sure the following items are installed:

    • Android SDK tools (at least one version of the command-line tools)
    • Android SDK Platform-Tools
    • Android SDK Build Tools (at least one version)
    • Android Emulator
  5. Click Apply Changes if you've marked anything for installation

If you've missed anything, Visual Studio should prompt you anyway.

Android Development Setup

To set up a new virtual Android device for debugging:

  1. Click Tools > Device Manager (under the Android subheading)
  2. Click New Device
  3. Set up the device you want to emulate - you can just choose the Base Device and leave the default settings if you're unsure
  4. Visual Studio will then download the image for that device. The download progress is shown in the progress in the Android Device Manager dialog.
  5. Once this has completed, the emulated Android device will be available as a build target under Android > Debug > (name of device)

M1 Macs

  1. Install and open Android Studio
  2. In the top navbar, click on Android Studio > Settings > Appearance & Behavior (tab) > System Settings > Android SDK
  3. In the SDK Platforms tab, ensure the "Show Package Details" checkbox is checked (located in the bottom-right)
  4. Bellow each Android API you'll see several System Images, pick one of the ARM 64 v8a and wait for it to download
  5. Go to View > Tool Windows > Device Manager
  6. Inside Device Manager, create a device using the previously downloaded system image

Android SDK configuration

Testing and Debugging

Using the Android Emulator

In order to access localhost:<port> resources in the Android Emulator when debugging using Xamarin studio on your Mac natively, you'll need to configure the endpoint addresses using <<port>> in order to access localhost, which maps the Android proxy by design.

Using Server Tunneling

Instead of configuring your device or emulator, you can instead use a proxy tunnel to your local server and have your app connect to it directly.

Push Notifications

The default configuration for the Android app is to register itself to the same environment as Bitwarden's QA Cloud. This means that if you try to debug the app using the production endpoints you won't be able to receive Live Sync updates or Passwordless login requests.

Testing Passwordless Locally

Before you can start testing and debugging passwordless logins, make sure your local server setup is running correctly (server setup). You should also be able to deploy your Android app to your device or emulator.


Debugging and testing passwordless authentication is limited by push notifications.

Testing passwordless notifications:

  1. Start your local server (Api, Identity, Notifications)
  2. Make sure your mobile device can connect to your local server
  3. Start the web client, as you will need it to make login requests
  4. Deploy the Android app to your device or emulator
  5. After deployment, open the app, login to your QA account and activate passwordless login requests in settings
  6. Open the web vault using your preferred browser (ex: http://localhost:8080)
  7. Enter the email address of an account that has previously authenticated on that device (i.e. is a "known device") and click Continue. When presented with the login options, click click Login with Device.
  8. Check mobile device for the notification