# Android ### Finding your APK file #### With Android Studio Select **Build** -> **Build APK(s)** -> **Build APK(s)** or **Build** -> **Generated Signed APK** (and following the prompts)

Once the build is complete you can locate the `.apk` file by selecting `locate` in the dialog that appears

Select `locate` in the dialog to navigate to the apk

or by navigating to ``` {project name}/{app module name}/build/outputs/apk/ ``` #### With Gradle Generate your build with `gradle` by running the `assemble` command for your preferred app build variant e.g. `debug` variant Copy ``` ./gradlew assembleDebug ``` Once the build is complete you can locate the `.apk` file by navigating to ``` {project name}/{app module name}/build/outputs/apk/ ``` ### Converting AAB to APK Scandium currently only supports `apk` files for Android. In order to get your application to work with Scandium you will need to convert your `aab` to an `apk` by making use of the [`bundletool`](https://developer.android.com/tools/bundletool) provided by Google. **Generate Universal APKS** ``` bundletool build-apks --bundle=//{aab name}.aab \ --output=/{your app}/{app name}.apks \ --mode=universal ``` **Generate Single APK file from the Universal APKs** ``` unzip -p /{your app}/{app name}.apks universal.apk > /{your app}/{app name}.apk ``` ### Troubleshooting If you are having trouble running your uploaded Android app in Scandium, we recommend trying to run the same APK on the standard Google-provided Android emulator locally over ADB. Once your emulator is launched and available via `adb devices`, you can install it using the `install` command: ``` adb install -r {your app}.apk ``` or by simply dragging over the `apk` into the emulator window. ## Running apps that are not permitted to run on rooted device? Scandium runs Android emulators that are very similar to the Android emulators provided by Google. So, if you encounter any issue, it's often easier to troubleshoot on the Android emulators locally, and then re-upload to Scandium.The standard Google-provided Android emulators do come with *su*. So, some apps can detect this and have limitations to run on rooted devices. If that is the issue, and you would like your app to run on Scandium, you may detect when your app is running in Scandium and skip your rooted check in that case. For convenience, we set the key "i**sAppetize**" to `true` when streaming apps. Check below for example. {% tabs %} {% tab title="Java" %} **With Intents** The data will be passed as extras into the intent that launches your app, accessible by calling the appropriate get method (based on type) e.g. ```java Intent intent = getIntent() intent.getBooleanExtra("isAppetize", false); intent.getStringExtra("stringKey"); ... ``` **With SharedPreferences** The data will also be stored in SharedPreferences under a file called `prefs.db`. This is accessible by fetching that `SharedPreferences` instance and calling the appropriate get method e.g. ```java SharedPreferences preferences = getApplicationContext().getSharedPreferences("prefs.db", Context.MODE_PRIVATE); preferences.getBoolean("isAppetize", false); preferences.getString("stringKey", null); ... ``` {% endtab %} {% tab title="Kotlin" %} **With Intents** The data will be passed as extras into the intent that launches your app, accessible by calling the appropriate get method (based on type) e.g. ```kotlin intent.getBooleanExtra("isAppetize", false) intent.getStringExtra("stringKey") ... ``` **With SharedPreferences** The data will also be stored in SharedPreferences under a file called `prefs.db`. This is accessibly by fetching that `SharedPreferences` instance and calling the appropriate get method e.g. Copy ``` val preferences = applicationContext.getSharedPreferences("prefs.db", Context.MODE_PRIVATE); preferences.getBoolean("isAppetize", false) preferences.getString("stringKey", null) ... ``` Complex types (e.g. arrays or objects) will automatically be serialized and need to be deserialized manually before using e.g. passing an object: Copy ``` { "obj": { "stringKey": "value", "boolKey": true } } ``` when queried, will return: Copy ``` "{"stringKey":"value","boolKey":true}" ``` {% endtab %} {% endtabs %} --- # 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.getscandium.com/mobile-application-testing/uploading-apps/android.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.