## Introduction

Play for On-device AI brings the benefits of[Android App Bundles](https://developer.android.com/guide/app-bundle)and Google Play delivery to custom ML model distribution so you can improve model performance with less device ecosystem complexity at no additional cost. It lets you publish a single artifact to Play containing your code, assets, and ML models and to choose from a number of delivery modes and targeting options.

### Benefits

- Upload a single publishing artifact to Google Play and delegate hosting, delivery, updates, and targeting to Play at no additional cost.
- Deliver your ML models at install-time, fast-follow, or on-demand.
  - Install-time delivery can guarantee that a very large model is present when your app is opened. Your model will be installed as an APK.
  - Fast-follow delivery occurs automatically in the background after your app has been installed. Users may open your app before your model has been fully downloaded. Your model will be downloaded to your app's internal storage space.
  - On-demand delivery lets you request the model at runtime, which is useful if the model is only required for certain user-flows. Your model will be downloaded to your app's internal storage space.
- Deliver variants of your ML models that are targeted to specific devices based on device model, system properties, or RAM.
- Keep app updates small and optimized with Play's automatic patching, which means only the differences in files need to be downloaded.

### Considerations

- By using Play for On-device AI you agree to the terms in the[Google Play Developer Distribution Agreement](https://play.google.com/about/developer-distribution-agreement.html)and the[Play Core Software Development Kit Terms of Service](https://developer.android.com/guide/playcore#license).
- Models downloaded by Play for On-device AI should only be used by your apps. Models shouldn't be offered to other apps.
- Individual AI packs can be up to 1.5GB, based on their compressed download sizes. The maximum cumulative app size of any version of your app generated from your app bundle is 4GB.
- Apps over 1GB in size must set min SDK Level to 21 or higher.

### How to use Play for On-device AI

Play for On-device AI uses AI packs. You package custom models that are ready for distribution in AI packs in your app bundle. You can choose whether the AI pack should be delivered at install-time, fast-follow, or on-demand.

By packaging AI packs with your app bundle, you can use all of Play's existing testing and release tools, such as test tracks and staged rollouts to manage your app's distribution with your custom models.

AI packs are updated together with the app binary. If your new app release doesn't make changes to an AI pack, then Play's automatic patching process will ensure the user doesn't have to re-download it. Play will just download what's changed when it updates the app.

AI packs only contain models. Java/Kotlin and native libraries are not allowed. If you need to ship libraries or code to run your ML model, move it into the base module or a[feature module](https://developer.android.com/guide/playcore/feature-delivery). You can configure your feature module so that it has the same download and targeting settings as the AI pack.
| **Note:** AI packs don't contain Java/Kotlin or native libraries. You can ship libraries or code to run your ML models in[feature modules](https://developer.android.com/guide/playcore/feature-delivery).

### Use LiteRT and MediaPipe with AI packs

You can use LiteRT and MediaPipe with AI packs. Package your model in an AI pack and then access it using the instructions for[install-time packs](https://developer.android.com/google/play/on-device-ai#install-time-delivery)or for[fast-follow and on-demand packs](https://developer.android.com/google/play/on-device-ai#ff-od-delivery).

Further reading:

- [Getting started with LiteRT](https://ai.google.dev/edge/litert/android)
  - The[sample app](https://developer.android.com/google/play/on-device-ai#example-app)shows how you can package a LiteRT model in an AI pack and load it at runtime.
  - There are many[pretrained LiteRT models](https://ai.google.dev/edge/litert/models/trained)that you can use in AI packs to get started.
- [Getting started with MediaPipe](https://ai.google.dev/edge/mediapipe/framework/getting_started/android)
  - For fast-follow and on-demand packs, you can use[AssetCache.java](https://github.com/google-ai-edge/mediapipe/blob/master/mediapipe/java/com/google/mediapipe/framework/AssetCache.java)to load your assets (eg.`.binarypb`files) by their file paths.
  - For install-time packs, you can use[AndroidAssetUtil.java](https://github.com/google-ai-edge/mediapipe/blob/master/mediapipe/java/com/google/mediapipe/framework/AndroidAssetUtil.java#L56).

## Get started with AI packs

At a high level, here's how you can start using Play for On-device AI:

1. Package your models into AI packs into your Android App Bundle and specify how the AI packs should be delivered.
2. \[Optional\] If you want to deliver different models to different devices, you can[configure device targeting](https://developer.android.com/google/play/on-device-ai#device-targeting-configuration)for your AI packs. For example, you could deliver AI pack A to a specific device model, AI pack B to devices with at least 6GB of RAM, and all other devices could receive no model.
3. \[Optional\] If you're using on-demand or fast-follow delivery, integrate the Play AI Delivery Library into your app to download your AI packs as needed.
4. Test and release your app bundle to Google Play.

### Check Android Gradle Plugin version

To use AI packs, ensure that your Android Gradle Plugin (AGP) version is at least 8.8. This version is packaged with Android Studio Ladybug 2.

### Extract your model into an AI pack

Android Studio is not required for the following steps.

1. In the top-level directory of your project, create a directory for the AI pack. This directory name is used as the AI pack name. AI pack names must start with a letter and can only contain letters, numbers, and underscores.
2. In the AI pack directory, create a`build.gradle`file and add the following code. Make sure to specify the name of the AI pack and only one delivery type:

       // In the AI pack's build.gradle file:
       plugins {
         id 'com.android.ai-pack'
       }

       aiPack {
           packName = "ai-pack-name" // Directory name for the AI pack
           dynamicDelivery {
               deliveryType = "[ install-time | fast-follow | on-demand ]"
           }
       }

3. In the project's app`build.gradle`file, add the name of every AI pack in your project as shown below:

       // In the app build.gradle file:
       android {
           ...
           assetPacks = [":ai-pack-name", ":ai-pack2-name"]
       }

4. In the project's`settings.gradle`file, include all AI packs in your project as shown below:

       // In the settings.gradle file:
       include ':app'
       include ':ai-pack-name'
       include ':ai-pack2-name'

5. Inside your AI pack, create a`src/main/assets/`directory.

6. Place your models in the`src/main/assets`directory. You can create subdirectories in here as well. The directory structure for your app should now look like the following:

   - `build.gradle`
   - `settings.gradle`
   - `app/`
   - `ai-pack-name/build.gradle`
   - `ai-pack-name/src/main/assets/your-model-directories`
7. Add code to load and run your models. How you do this will depend on the delivery mode of your AI packs. See instructions for[install-time](https://developer.android.com/google/play/on-device-ai#install-time-delivery)and[fast-follow/on-demand](https://developer.android.com/google/play/on-device-ai#ff-od-delivery)below.

8. \[Optional\][Configure device targeting](https://developer.android.com/google/play/on-device-ai#device-targeting-configuration)to deliver different models to different devices.

9. [Build the Android App Bundle with Gradle](https://developer.android.com/studio/build/building-cmdline#build_bundle). In the generated app bundle, the root-level directory now includes the following:

   - `ai-pack-name/manifest/AndroidManifest.xml`: Configures the AI pack's identifier and delivery mode
   - `ai-pack-name/assets/your-model-directories`: Directory that contains all assets delivered as part of the AI pack

   Gradle generates the manifest for each AI pack and outputs the`assets/`directory for you.

### Configure install-time delivery

AI packs configured as install-time are immediately available at app launch. Use the Java AssetManager API to access AI packs served in this mode:  

```java
import android.content.res.AssetManager;
...
Context context = createPackageContext("<var translate="no">com.example.app</var>", 0);
AssetManager assetManager = context.getAssets();
InputStream is = assetManager.open("<var translate="no">model-name</var>");
```

### Configure fast-follow and on-demand delivery

To download AI packs with fast-follow or on-demand delivery, use the Play AI Delivery Library.

#### Declare dependency on the Play AI Delivery Library

In your app's`build.gradle`file, declare a dependency on the Play AI Delivery Library:  

    dependencies {
      ...
      implementation "com.google.android.play:ai-delivery:0.1.1-alpha01"
    }

#### Check status

Each AI pack is stored in a separate folder in the app's internal storage. Use the[`getPackLocation()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackManager#getPackLocation(java.lang.String))method to determine the root folder of an AI pack. This method returns the following values:

|                                                         Return value                                                         |                                                                                    Status                                                                                    |
|------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| A valid[`AiPackLocation`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackLocation)object | AI pack root folder is ready for immediate access at[`assetsPath()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackLocation#assetsPath) |
| `null`                                                                                                                       | Unknown AI pack or AI packs are not available                                                                                                                                |

| **Note:** Don't rely on cached AI pack locations between app launches. The app should always check for the existence of AI packs at every launch. AI packs may become invalid due to app updates or if the user clears the app data.

#### Get download information about AI packs

Use the  
[`getPackStates()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackManager#getPackStates(java.util.List%3Cjava.lang.String%3E))method to determine the size of the download and whether the pack is already downloading.  

```java
Task<AiPackStates> getPackStates(List<String> packNames)
```

`getPackStates()`is an asynchronous method that returns a`Task<AiPackStates>`. The[`packStates()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackStates#packStates())method of an`AiPackStates`object returns a`Map<String, AiPackState>`. This map contains the state of each requested AI pack, keyed by its name:  

```java
Map<String, AiPackState> AiPackStates#packStates()
```

The final request is shown by the following:  

```java
final String aiPackName = "<var translate="no">myAiPackName</var>";

aiPackManager
    .getPackStates(Collections.singletonList(aiPackName))
    .addOnCompleteListener(new OnCompleteListener<AiPackStates>() {
        @Override
        public void onComplete(Task<AiPackStates> task) {
            AiPackStates aiPackStates;
            try {
                aiPackStates = task.getResult();
                AiPackState aiPackState =
                    aiPackStates.packStates().get(aiPackName);
            } catch (RuntimeExecutionException e) {
                Log.d("MainActivity", e.getMessage());
                return;
            });
```

The following[`AiPackState`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackState)methods provide the size of the AI pack, the downloaded amount so far (if requested), and the amount already transferred to the app:

- [`totalBytesToDownload()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackState#totalBytesToDownload())
- [`bytesDownloaded()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackState#bytesDownloaded())
- [`transferProgressPercentage()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackState#transferProgressPercentage())

To get the status of an AI pack, use the[`status()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackState#status())method, which returns the status as an integer that corresponds to a constant field in the[`AiPackStatus`](https://developer.android.com/reference/com/google/android/play/core/aipacks/model/AiPackStatus)class. An AI pack that's not installed yet has the status`AiPackStatus.NOT_INSTALLED`.

If a request fails, use the[`errorCode()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackState#errorCode())method, whose return value corresponds to a constant field in the[`AiPackErrorCode`](https://developer.android.com/reference/com/google/android/play/core/aipacks/model/AiPackErrorCode)class.

#### Install

Use the[`fetch()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackManager#fetch(java.util.List%3Cjava.lang.String%3E))method to download an AI pack for the first time or call for the update of an AI pack to complete:  

```java
Task<AiPackStates> fetch(List<String> packNames)
```

This method returns an[`AiPackStates`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackStates)object containing a list of packs and their initial download states and sizes. If an AI pack requested via`fetch()`is already downloading, the download status is returned and no additional download is started.
| **Note:** In most cases, you implement a`listener`to track the download and installation process as covered in the next section.

#### Monitor download states

You should implement an[`AiPackStateUpdateListener`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackStateUpdateListener)to track the installation progress of AI packs. The status updates are broken down per pack to support tracking the status of individual AI packs. You can start using available AI packs before all other downloads for your request have completed.  

```java
void registerListener(AiPackStateUpdateListener listener)
void unregisterListener(AiPackStateUpdateListener listener)
```
| **Note:** The Play Store automatically triggers the download of any`fast-follow`packs after the user installs or updates the app. However, these packs may not be ready to use immediately. You must check the status of the`fast-follow`packs at every app launch. If the download is in progress, monitor it with a listener. If the download is cancelled or paused, you can resume it by using the`fetch()`method, as covered in the[Install](https://developer.android.com/google/play/on-device-ai#install)section.

##### Large downloads

If the download is larger than 200 MB and the user is not on Wi-Fi, the download does not start until the user explicitly gives their consent to proceed with the download using a mobile data connection. Similarly, if the download is large and the user loses Wi-Fi, the download is paused and explicit consent is required to proceed using a mobile data connection. A paused pack has state`WAITING_FOR_WIFI`. To trigger the UI flow to prompt the user for consent, use the[`showConfirmationDialog()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackManager#showConfirmationDialog(androidx.activity.result.ActivityResultLauncher%3Candroidx.activity.result.IntentSenderRequest%3E))method.

Note that if the app does not call this method, the download is paused and will resume automatically only when the user is back on a Wi-Fi connection.

##### Required user confirmation

If a pack has the`REQUIRES_USER_CONFIRMATION`status, the download won't proceed until the user accepts the dialog that is shown with[`showConfirmationDialog()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackManager#showConfirmationDialog(androidx.activity.result.ActivityResultLauncher%3Candroidx.activity.result.IntentSenderRequest%3E)). This status can occur when the app is not recognized by Play---for example, if the app was sideloaded. Note that calling[`showConfirmationDialog()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackManager#showConfirmationDialog(androidx.activity.result.ActivityResultLauncher%3Candroidx.activity.result.IntentSenderRequest%3E))in this case will cause the app to be updated. After the update, you will need to request the AI packs again.

The following is an example implementation of a listener:  

```java
AiPackStateUpdateListener aiPackStateUpdateListener = new AiPackStateUpdateListener() {
    private final ActivityResultLauncher<IntentSenderRequest> activityResultLauncher =
      registerForActivityResult(
          new ActivityResultContracts.StartIntentSenderForResult(),
          new ActivityResultCallback<ActivityResult>() {
            @Override
            public void onActivityResult(ActivityResult result) {
              if (result.getResultCode() == RESULT_OK) {
                Log.d(TAG, "Confirmation dialog has been accepted.");
              } else if (result.getResultCode() == RESULT_CANCELED) {
                Log.d(TAG, "Confirmation dialog has been denied by the user.");
              }
            }
          });

    @Override
    public void onStateUpdate(AiPackState aiPackState) {
      switch (aiPackState.status()) {
        case AiPackStatus.PENDING:
          Log.i(TAG, "Pending");
          break;

        case AiPackStatus.DOWNLOADING:
          long downloaded = aiPackState.bytesDownloaded();
          long totalSize = aiPackState.totalBytesToDownload();
          double percent = 100.0 * downloaded / totalSize;

          Log.i(TAG, "PercentDone=" + String.format("%.2f", percent));
          break;

        case AiPackStatus.TRANSFERRING:
          // 100% downloaded and assets are being transferred.
          // Notify user to wait until transfer is complete.
          break;

        case AiPackStatus.COMPLETED:
          // AI pack is ready to use. Run the model.
          break;

        case AiPackStatus.FAILED:
          // Request failed. Notify user.
          Log.e(TAG, aiPackState.errorCode());
          break;

        case AiPackStatus.CANCELED:
          // Request canceled. Notify user.
          break;

        case AiPackStatus.WAITING_FOR_WIFI:
        case AiPackStatus.REQUIRES_USER_CONFIRMATION:
          if (!confirmationDialogShown) {
            aiPackManager.showConfirmationDialog(activityResultLauncher);
            confirmationDialogShown = true;
          }
          break;

        case AiPackStatus.NOT_INSTALLED:
          // AI pack is not downloaded yet.
          break;
        case AiPackStatus.UNKNOWN:
          Log.wtf(TAG, "AI pack status unknown")
          break;
      }
    }
}
```

Alternatively, you can use the[`getPackStates()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackManager#getPackStates())method to get the status of current downloads.[`AiPackStates`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackStates)contains the download progress, download status, and any failure error codes.

#### Access AI packs

You can access an AI pack using file system calls after the download request reaches the[`COMPLETED`](https://developer.android.com/reference/com/google/android/play/core/aipacks/model/AiPackStatus#completed())state. Use the[`getPackLocation()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackManager#getPackLocation(java.lang.String))method to get the root folder of the AI pack.

AI packs are stored in the`assets`directory within the AI pack root directory. You can get the path to the`assets`directory by using the convenience method[`assetsPath()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackLocation#assetsPath()). Use the following method to get the path to a specific asset:  

```java
private String getAbsoluteAiAssetPath(String aiPack, String relativeAiAssetPath) {
    AiPackLocation aiPackPath = aiPackManager.getPackLocation(aiPack);

    if (aiPackPath == null) {
        // AI pack is not ready
        return null;
    }

    String aiAssetsFolderPath = aiPackPath.assetsPath();
    // equivalent to: FilenameUtils.concat(aiPackPath.path(), "assets");
    String aiAssetPath = FilenameUtils.concat(aiAssetsFolderPath, relativeAiAssetPath);
    return aiAssetPath;
}
```

### Configure device targeting

You can follow the[device targeting instructions](https://developer.android.com/google/play/on-device-ai#device-targeting-configuration)to specify devices or groups of devices that should receive your AI packs.

### Other Play AI Delivery API methods

The following are some additional API methods you may want to use in your app.

#### Cancel request

Use[`cancel()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackManager#cancel(java.util.List%3Cjava.lang.String%3E))to cancel an active AI pack request. Note that this request is a best-effort operation.

#### Remove an AI pack

Use[`removePack()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackManager#removePack(java.lang.String))to schedule the removal of an AI pack.

#### Get locations of multiple AI packs

Use[`getPackLocations()`](https://developer.android.com/reference/com/google/android/play/core/aipacks/AiPackManager#getPackLocations())to query the status of multiple AI packs in bulk, which returns a map of AI packs and their locations. The map returned by`getPackLocations()`contains an entry for each pack that is currently downloaded and up-to-date.

## Device targeting

Device targeting gives you finer control over which parts of your app bundle are delivered to specific devices. For example, you could ensure that a large model is only delivered to devices with high RAM or you could deliver different versions of a model to different devices.

You can target device properties such as:

- System on chip
- Device model
- Device RAM
- [System features](https://developer.android.com/guide/topics/manifest/uses-feature-element#features-reference)

### Overview of required steps

The following steps are required to enable device targeting:

1. Define your device groups in an XML file.
2. Specify which parts of your bundle should go to which device groups.
3. \[Optional\] Test your configuration locally.
4. Upload your bundle (containing the XML file) to Google Play.

### Check Android Gradle Plugin version

To use device targeting, ensure that your Android Gradle Plugin (AGP) version is at least 8.10.0. This is packaged with Android Studio (Meerkat 2 and later). Download the latest[stable version of Android Studio](https://developer.android.com/studio).

### Enable this feature in Android Gradle Plugin

Device targeting must be enabled explicitly in your`gradle.properties`file:  

    android.experimental.enableDeviceTargetingConfigApi=true

### Create a device targeting configuration XML file

The device targeting configuration file is an XML file in which you define your custom device groups. For example, you could define a device group called`qti_v79`that contains all devices with the Qualcomm SM8750 system on chip:  

    <config:device-targeting-config
        xmlns:config="http://schemas.android.com/apk/config">

        <config:device-group name="qti_v79">
            <config:device-selector>
                <config:system-on-chip manufacturer="QTI" model="SM8750"/>
            </config:device-selector>
        </config:device-group>

    </config:device-targeting-config>

A**device group** is composed of up to 5**device selectors**. A device is included in a device group if it satisfies any of its device selectors.

A**device selector** can have one or more**device properties**. A device is selected if it matches all of the selector's device properties.

If a device matches multiple groups, it will be served the content for the group that is defined first in the XML file. The order you define groups in the XML file is your priority order.

If a device matches no groups, it will receive the default "other" group. This group is automatically generated and shouldn't be defined explicitly.

#### Available device properties

- **device_ram** : Device RAM requirements
  - **min_bytes** (*inclusive)*: Minimum required RAM (in bytes)
  - **max_bytes** (*exclusive)*: Maximum required RAM (in bytes)
- **included_device_ids** : Device models to be included in this selector**(max of 10000 device_ids per group)** . This property is satisfied if the device matches any device_id in the list.
  - **build_brand**: Device manufacturer
  - **build_device**: Device model code
- **excluded_device_ids** : Device models to be excluded in this selector**(max of 10000 device_ids per group)** . This property is satisfied if the device matches no device_id in the list.
  - **build_brand**: Device manufacturer
  - **build_device**: Device model code
- **required_system_features** : Features that a device needs to have to be included by this selector**(max of 100 features per group)**. A device needs to have all system features in this list to satisfy this property.

  System[feature reference](https://developer.android.com/guide/topics/manifest/uses-feature-element#features-reference)
  - **name**: A system feature
- **forbidden_system_features** : Features that a device mustn't have to be included by this selector**(max of 100 features per group)**. If a device has any of the system features in this list it doesn't satisfy this property.

  System[feature reference](https://developer.android.com/guide/topics/manifest/uses-feature-element#features-reference)
  - **name**: A system feature
- **system-on-chip**: System on chips to be included in this selector. A device needs to have any chip in this list to satisfy this property.

  - **manufacturer** :[System on chip manufacturer](https://developer.android.com/reference/android/os/Build#SOC_MANUFACTURER)
  - **model** :[System on chip model](https://developer.android.com/reference/android/os/Build#SOC_MODEL)

| **Tip:**Including multiple properties in a single selector creates a logical AND, for example:  
|
| ```xml
|     <config:device-selector ram-min-bytes="7000000000">
|         <config:included-device-id brand="google" device="flame"/>
|     </config:device-selector>
|   
| ```
|
| will create the condition for all devices with \> 7GB of RAM AND it is a Pixel 4 - also written as follows:
|
| ![](https://developer.android.com/static/images/google/play/intersect.png)
|
| If you want an OR condition, create separate selectors in a single device group, for example:  
|
| ```xml
|     <config:device-selector ram-min-bytes="7000000000"/>
|     <config:device-selector>
|           <config:included-device-id brand="google" device="flame"/>
|     </config:device-selector>
|   
| ```
|
| will create the condition for all devices with \> 7GB of RAM OR it is a Pixel 4 - also written as follows:
|
| ![](https://developer.android.com/static/images/google/play/union.png)

Here is an example showing all possible device properties:  

    <config:device-targeting-config
        xmlns:config="http://schemas.android.com/apk/config">

        <config:device-group name="myCustomGroup1">
          <config:device-selector ram-min-bytes="8000000000">
            <config:included-device-id brand="google" device="redfin"/>
            <config:included-device-id brand="google" device="sailfish"/>
            <config:included-device-id brand="good-brand"/>
            <config:excluded-device-id brand="google" device="caiman"/>
            <config:system-on-chip manufacturer="Sinclair" model="ZX80"/>
            <config:system-on-chip manufacturer="Commodore" model="C64"/>
          </config:device-selector>
          <config:device-selector ram-min-bytes="16000000000"/>
        </config:device-group>

        <config:device-group name="myCustomGroup2">
          <config:device-selector ram-min-bytes="4000000000" ram-max-bytes="8000000000">
            <config:required-system-feature name="android.hardware.bluetooth"/>
            <config:required-system-feature name="android.hardware.location"/>
            <config:forbidden-system-feature name="android.hardware.camera"/>
            <config:forbidden-system-feature name="mindcontrol.laser"/>
          </config:device-selector>
        </config:device-group>

    </config:device-targeting-config>

#### Official device manufacturer and device model codes

You can find the correct formatting for the device manufacturer and model code by using the Device Catalog on the Google Play Console, by either:

- Inspecting individual devices using the Device Catalog, and finding the manufacturer and model code in the locations as shown in the example below (For a Google Pixel 4a, the manufacturer is "Google" and the model code is "sunfish")'

  ![pixel 4a page in the device catalog](https://developer.android.com/static/images/google/play/pixel-4.png)

  ![pixel 4a page in the device catalog](https://developer.android.com/static/images/google/play/pixel-4-2.png)
- Downloading a CSV of supported devices, and using the*Manufacturer* and*Model Code* for the*build_brand* and*build_device*fields, respectively.

#### Include your device targeting configuration file in your app bundle

Add the following to your main module's`build.gradle`file:  

    android {
      ...
      bundle {
        deviceTargetingConfig = file('device_targeting_config.xml')
        deviceGroup {
          enableSplit = true   // split bundle by #group
          defaultGroup = "other"  // group used for standalone APKs
        }
      }
      ...
    }

`device_targeting_config.xml`is the path of your configuration file relative to the main module. This ensures that your configuration file is packaged with your app bundle.

The`deviceGroup`clause ensures that the APKs generated from your bundle are split by device groups.

### Use device targeting for your AI packs

You can keep size optimized on devices by only delivering your large models to devices that can run them.

Subdivide your AI packs by device groups by taking the**existing**AI pack directories created in the last step, and post-fixing the appropriate folders (as described below) with #group_myCustomGroup1, #group_myCustomGroup2, etc. When using the AI packs in your app, you won't need to address folders by postfix (in other words, the postfix is automatically stripped during the build process).

After the previous step, this might look like:  

    ...
    .../ai-pack-name/src/main/assets/image-classifier#group_myCustomGroup1/
    .../ai-pack-name/src/main/assets/image-classifier#group_myCustomGroup2/
    ...

In this example, you would reference`ai-pack-name/assets/image-classifier/`without any postfixes.

Devices in`myCustomGroup1`will receive all the assets under`image-classifier#group_myCustomGroup1/`, while devices in`myCustomGroup2`will receive all the assets under`image-classifier#group_myCustomGroup2/`.

Devices that don't belong to either`myCustomGroup1`or`myCustomGroup2`will receive an empty`ai-pack-name`pack.

This is because devices that don't match any device group will receive the default variant of your AI pack. This includes anything that is not inside a directory with a`#group_suffix`.

Once you have downloaded the AI pack, you can check whether your model is present by using the[AssetManager](https://developer.android.com/google/play/on-device-ai#install-time-delivery)for install-time packs or the[AiPackManager](https://developer.android.com/google/play/on-device-ai#access-AI-packs)for fast-follow and on-demand packs. Examples for doing this are shown for all delivery modes in the[sample app](https://developer.android.com/google/play/on-device-ai#example-app).
| **Important:** It's not possible to prevent**any**variant of your AI pack being delivered to certain devices. Non-targeted devices will always receive the default variant.

### Use device targeting for your feature modules

You can also use device targeting for feature modules. Instead of subdividing feature modules by device group, you specify whether the entire module should be delivered based on device group membership.

To deliver a feature module to devices that belong to either`myCustomGroup1`or`myCustomGroup2`, modify its`AndroidManifest.xml`:  

    <manifest ...>
      ...
      <dist:module dist:title="...">
        <dist:delivery>
          <dist:install-time>
            <dist:conditions>
              <dist:device-groups>
                <dist:device-group dist:name="myCustomGroup1"/>
                <dist:device-group dist:name="myCustomGroup2"/>
              </dist:device-groups>
              ...
            </dist:conditions>
          </dist:install-time>
        </dist:delivery>
      </dist:module>
      ...
    </manifest>

| **Note:** Devices that are not targeted won't receive the feature module at all. This is different from[targeting for AI packs](https://developer.android.com/google/play/on-device-ai#targeting-for-ai-packs), where devices that are not targeted receive a default, empty variant of the AI pack.

## Test locally

Before creating a release for your new bundle, you can test locally with either Internal App Sharing or Bundletool.

### Internal App Sharing

Internal App Sharing lets you use an app bundle to quickly generate a URL that you can tap on a local device to install exactly what Google Play would install for that device if that version of the app was live in a test or prod track.

Take a look at the[internal app sharing instructions](https://support.google.com/googleplay/android-developer/answer/9844679).

### Bundletool

Alternatively, you can generate APKs using[`bundletool`](https://developer.android.com/studio/command-line/bundletool)(1.18.0 or above) and sideload them onto your device. Follow these steps to test your app locally using bundletool:

1. Build your app bundle with Android Studio or bundletool.

2. Generate APKs with the`--local-testing`flag:

   ```
   java -jar bundletool-all.jar build-apks --bundle=path/to/your/bundle.aab \
     --output=output.apks --local-testing
   ```
3. Connect a device and run`bundletool`to sideload the APKs:

   ```
   # Example without Device Targeting Configuration
   java -jar bundletool.jar install-apks --apks=output.apks
   ```  

   ```
   # Example with Device Targeting Configuration (you must specify which groups the connected device belongs to)
   java -jar bundletool.jar install-apks --apks=output.apks --device-groups=myCustomGroup1,myCustomGroup2
   ```

#### Limitations of local testing with bundletool

The following are limitations of local testing with bundletool:

- `fast-follow`packs behave as`on-demand`packs. That is, they won't be automatically fetched when the app is sideloaded. Developers need to request them manually when the app starts; this does not require any code changes in your app.
- Packs fetch from external storage instead of Play, so you cannot test how your code behaves in the case of network errors.
- Local testing does not cover the wait-for-Wi-Fi scenario.
- Updates are not supported. Before installing a new version of your build, manually uninstall the previous version.

### Verify that the correct APKs are being installed

Use the following method to ensure only the correct APKs are installed on the device  

    adb shell pm path {packageName}

You should see something like:  

    package:{...}/base.apk
    package:{...}/split_config.en.apk
    package:{...}/split_config.xxhdpi.apk
    package:{...}/split_main_ai-pack-name.apk
    package:{...}/split_main_ai-pack-name.config.group_myCustomGroup1.apk

Note that you will only see APKs in this list, which are made from feature modules and install-time AI packs. On-demand and fast-follow AI packs are not installed as APKs.

## Test and release on Google Play

We recommend that you test your app end to end on Google Play with an[internal test track](https://support.google.com/googleplay/android-developer/answer/9845334).

Once you've done this, you can incrementally release your app update to production with[staged roll-outs](https://support.google.com/googleplay/android-developer/answer/6346149).

## Sample app using Play for On-device AI

Download the[sample app](https://drive.google.com/drive/folders/1zb2O2mDvEh4vOmv1QbjeLU-O25KHrfKJ).

It demonstrates how to use each of the delivery modes as well as the device targeting configuration. See the[local testing](https://developer.android.com/google/play/on-device-ai#local-testing)section to get started.

## Related content

Learn more about[Android App Bundles](https://developer.android.com/guide/app-bundle)and read the references for the[AI Delivery SDK](https://developer.android.com/reference/com/google/android/play/core/packages-ai_delivery).