To add the Home APIs to an Android app, you'll need to meet a few prerequisites.

## Prerequisites

For development, you'll need a computer with the following tools installed on
it:

- Android Studio, version 2024.2.1 ("Ladybug") or later.
  Note that versions earlier than this may not work properly with the Home
  APIs SDK.

  [Download Android Studio](https://developer.android.com/studio)
- The Android debugger (`adb`).

  Install
  [`adb`](https://developer.android.com/studio/command-line/adb).

  This can be done with the [SDK
  Manager](https://developer.android.com/studio/intro/update#sdk-manager).

And to test the Home APIs, you'll need:

- An Android device running Android 10 or later set up with a Google Account you intend to use for development. Make sure an up-to-date version of the Android Studio is installed and signed into with this development account.
- A Wi-Fi network.
- To access and control Matter devices, you also need a [Google hub that supports the Home APIs](https://developers.home.google.com/apis/android/sdk#supported_hubs). See [Connectivity on Android](https://developers.home.google.com/apis/android/connectivity) for details.
- At least one supported device in the home. If this device (or any other you
  want to test) uses Thread, the hub must also be a Thread border router. The
  following device types and traits are supported by the Android Sample App:

  <br />

  - Color Temperature Light (on and off, brightness)
  - Contact Sensor (boolean state)
  - Dimmable Light (on and off, brightness)
  - Extended Color Light (on and off, brightness)
  - Generic Switch
  - Google Camera
  - Occupancy Sensor (occupancy sensing)
  - On/Off Light (on and off, brightness)
  - On/Off Light Switch
  - On/Off Plug-in Unit (on and off)
  - On/Off Sensor

  <br />

### Supported hubs

Only certain Google Nest hubs feature support for the Home APIs.

| Device | Thread Border Router support | Google Store |
|---|:---:|:---:|
| Google Home |   |   |
| Google Nest Audio |   | [shopping_cart](https://store.google.com/us/product/nest_audio) |
| Google Nest Hub |   |   |
| Google Nest Hub (2nd gen) |   | [shopping_cart](https://store.google.com/us/product/nest_hub_2nd_gen) |
| Google Nest Hub Max |   | [shopping_cart](https://store.google.com/us/product/google_nest_hub_max) |
| Google Nest Mini |   | [shopping_cart](https://store.google.com/us/product/google_nest_mini) |
| Google TV Streamer (4k) |   | [shopping_cart](https://store.google.com/product/google_tv_streamer) |
| Nest WiFi Pro |   | [shopping_cart](https://store.google.com/product/nest_wifi_pro) |
[*Table: Google Nest hubs with Home APIs
support*]

Apart from these supported hubs, there is a
[Hubless Mode](https://developers.home.google.com/apis/android/connectivity#hubless_mode) that offers limited
Home APIs capabilities.

## Set up the SDK

The Home APIs in this open beta are not yet part of the standard libraries
provided by Google for development. In order to develop applications with the
Home APIs, you need to download and host the libraries locally.

**To download the Home APIs Android SDK, you must first be signed into Google
Home Developers.**

[Sign in now!](https://developers.home.google.com/_d/signin?continue=https://developers.home.google.com/apis/android/sdk&prompt=select_account)