public final class AndroidApplicationResolver

Resolves the appFile value used by StartApplication into something Appium can install, transparently converting a real Android App Bundle (AAB) into a cached universal APK first. Behavior (per STUDIO-10661):

• Vendor-native, non-downloadable references (bs://, sauce-storage:, lt://, ...) are passed through unchanged — Katalon has no access to those bytes.
• http(s):// URLs are downloaded first, only to inspect the bytes. If the download turns out not to be an AAB, the original URL is handed back unchanged — Appium (local or remote) can download http(s):// URLs itself, and our local temp copy is discarded.
• The local file's zip structure is inspected (not its extension/URL suffix) to decide whether it's really an AAB. If not, the (possibly downloaded) local path is returned unchanged — existing .apk behavior is untouched.
• A real AAB is converted via bundletool (through AabConverter), cached by content hash + bundletool version, and the converted .apk path is returned. The converted .apk only ever exists on this machine's local disk, so this class is only ever called for a LOCAL Appium run — StartApplicationKeyword skips it entirely for a REMOTE run, since there is no upload step to a remote Appium server's own app storage.

This runs before any Appium session is attempted (called from StartApplicationKeyword), so a corrupt/invalid AAB fails fast with a clear message instead of surfacing as a confusing Appium/device error later.