# Install App After initializing the DTIS SDK, use the `install()` method to specify the target app you want to download. You can specify the target app by its unique package name or its APK file URI. {% code title="Kotlin" %} ```kotlin fun install( data: String, callback: IResponseCallback? = null, metadata: Bundle = Bundle(), action: Bundle = Bundle(), config: RequestConfig = RequestConfig() ) ``` {% endcode %} ## Parameters | PARAMETER | STATUS | TYPE | DESCRIPTION | | ---------- | -------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `data` | Required | String | Package name or URI of the app. | | `callback` | Optional | Interface |

The DTIS SDK includes the IResponseCallback interface for you to receive asynchronous status and progress updates throughout the installation lifecycle. You can receive installation progress by callbacks along with notifications by broadcasts.

If you do not wish to receive installation status notifications via callback, set this parameter to null.

For more information, see Notifications by Callback.

| | `metadata` | Optional | Bundle |

Bundled data for further processing. Use this field to send the following information about the installation:

You can send any key-value pair in the metadata bundle. However, prior to sending the key-value pairs, inform DT which APK version you want to associate with each key-value pair.

| | `action` | Optional | Bundle |

Bundle containing the broadcast to be triggered asynchronously as task progresses. In the bundle, specify the fully qualified class name of BroadcastReceiver to receive status and progress updates.

For example:
com.myapp.receivers.MyBroadcastReceiver.kt

You can receive installation progress updates either by broadcasts, callbacks, or a combination of both.

For more information, see Notifications by Broadcast.

| | `config` | Optional | Object | An instance of a custom `RequestConfig` object, providing settings to override the default retry and timeout policies for the installation task. For more information, see [Set Retry Policy](/dt-ignite/ignite-services/sdk-reference/set-retry-policy.md). | ## Reconnecting to Ongoing Installations If you call `install()` for an installation that is already in progress, the SDK attempts to reconnect to the existing installation task. To better monitor installation progress, DT recommends specifying a way of receiving installation status (either by callback or broadcast) to obtain a `taskId` that you can use to track task status and troubleshoot errors. ## Examples The following code snippets show how to call the `install()` method to install an app. ### Install App by Package Name The following snippet initiates the installation of an app identified by its package name. {% code title="Kotlin" %} ```kotlin // Initialization // Install application via package name string and do not listen to updates val packageName = "com.package.name" IgniteServiceSdk.instance().install(packageName) // ... ``` {% endcode %} ### Install App by URI The following snippet initiates the installation of `MyFunGame.apk` by specifying its URI. {% code title="Kotlin" %} ```kotlin // Initialization // Install application via uri string and do not listen to updates val file = File("${context.filesDir}", "MyFunGame.apk") val uriString = file.toUri().toString() IgniteServiceSdk.instance().install(uriString) // ... ``` {% endcode %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.digitalturbine.com/dt-ignite/ignite-services/sdk-reference/install-app.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.