ActivityResultLauncher: co to je a jak používat

Co je ActivityResultLauncher

ActivityResultLauncher je třída z balíčku androidx.activity.result, která poskytuje typově bezpečný mechanismus pro spouštění Activity a získávání výsledku. Launcher je vytvořen pomocí metody registerForActivityResult, která přijímá dva parametry: Contract (popisuje vstupní a výstupní typy) a ActivityResultCallback (zpracovatel výsledku). Po registraci je launcher připraven k volání pomocí metody launch.

Klíčový rozdíl oproti starému API je oddělení registrace a spouštění. Registrace probíhá ve fázi inicializace (Activity.onCreate nebo Fragment.onCreate), callback je navázán na launcher jednou a garantovaně se aktivuje při vrácení výsledku. To odstraňuje problém, kdy se onActivityResult aktivoval v neočekávaném pořadí nebo na zničené Activity.

ActivityResultLauncher podporuje všechny scénáře, které byly dříve zpracovávány přes onActivityResult: spouštění kamery, galerie, žádost o kontakty, oprávnění a vlastní Activity. Kromě toho je API rozšiřitelné: vývojář může vytvářet vlastní Contract pro specifické scénáře výměny dat mezi Activity.

Proč Activity Result API nahradilo startActivityForResult

startActivityForResult byl součástí Android SDK od verze API Level 1 (2008) a zůstal hlavním způsobem získávání výsledku z Activity po více než 12 let. Tato metoda však měla zásadní nedostatky, které Google odstranil v Activity Result API. Podívejme se na hlavní problémy a jak je nové API řeší.

Problém 1: těsné propojení s Activity

Metoda startActivityForResult je spojena s Activity a Fragment prostřednictvím requestCode — libovolného celého čísla, které je předáno do onActivityResult. Vývojář ručně přiřazoval kód ke spuštěné operaci, což vedlo k chybám při opětovném použití kódu a dědičnosti. ActivityResultLauncher zcela odstraňuje requestCode: callback je navázán na konkrétní launcher ve fázi registrace a je volán pouze pro něj.

Problém 2: ztráta výsledku při otáčení obrazovky

Při změnách konfigurace (otočení obrazovky, změna jazyka) byla Activity znovu vytvořena a onActivityResult se nemusel aktivovat — callback se ztratil. Activity Result API automaticky ukládá a obnovuje stav launcheru pomocí SavedStateRegistry, což garantuje přijetí výsledku i po znovuvytvoření Activity.

Problém 3: chybějící typová bezpečnost

Staré API předávalo výsledek přes Intent s Bundle, kde klíče a datové typy nebyly kontrolovány kompilátorem. Activity Result API používá Contract — generické rozhraní, které definuje typ vstupních dat (I) a typ výsledku (O). Chyby typové neshody jsou detekovány ve fázi kompilace, nikoli za běhu.

Hlavní kontrakty Activity Result API

Contract je rozhraní ActivityResultContract<I, O>, které definuje, jak spustit Activity a jak interpretovat výsledek. Google poskytuje sadu vestavěných kontraktů pro typické scénáře, pokrývající většinu potřeb vývojáře.

StartIntentSenderForResult

StartIntentSenderForResult je základní kontrakt pro spouštění IntentSender. Používá se v systémových scénářích, například při autentizaci přes Google Sign-In nebo při platbě přes Google Pay. Vstupní parametr — PendingIntent, výstup — ActivityResult s kódem a Intent.

RequestMultiplePermissions

RequestMultiplePermissions je kontrakt pro žádost o více oprávnění současně v Android 6.0+. Vstupní parametr — pole String s názvy oprávnění, výstup — Map<String, Boolean> s výsledkem každé žádosti. Dříve to vyžadovalo ruční parsování v onRequestPermissionsResult s přiřazováním kódů žádostí.

TakePicture a TakeVideo

TakePicture je kontrakt pro fotografování přes systémový fotoaparát. Vstup — Uri, kam uložit snímek, výstup — Boolean (úspěch). TakeVideo funguje podobně s videem. Tyto kontrakty nahrazují zastaralý MediaStore.ACTION_IMAGE_CAPTURE s nestabilním chováním na různých zařízeních.

GetContent a OpenDocument

GetContent je kontrakt pro výběr obsahu přes systémový výběr. Vstup — MIME typ (např. image/*), výstup — Uri vybraného souboru. OpenDocument se liší podporou vícenásobného výběru a filtrováním podle typů dokumentů. Oba kontrakty fungují přes SAF (Storage Access Framework).

CreateDocument a OpenDocumentTree

CreateDocument je kontrakt pro vytvoření nového dokumentu přes systémové dialogové okno. Uživatel vybere název a složku, systém vrátí Uri pro zápis. OpenDocumentTree poskytuje přístup k celému adresáři — uživatel vybere složku a aplikace získá tree-uri pro čtení a zápis všech souborů uvnitř.

Použití v Activity a Fragment

Základní vzor použití ActivityResultLauncher v klasickém Androidu se skládá ze dvou kroků: registrace pomocí registerForActivityResult ve fázi inicializace a volání launch jako odpověď na akci uživatele. Podívejme se na typický příklad výběru obrázku z galerie.

Registrace a spuštění v Activity

Zaregistrujte launcher v onCreate Activity — to garantuje, že callback bude připraven před jakýmkoli možným voláním. Nikdy neregistrujte launcher bezprostředně před spuštěním — to porušuje kontrakt API a může vést ke ztrátě výsledku při znovuvytvoření Activity.

class MainActivity : AppCompatActivity() {
    private val pickImageLauncher =
        registerForActivityResult(ActivityResultContracts.GetContent()) { uri: Uri? ->
            uri?.let { binding.imageView.setImageURI(it) }
        }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        pickImageLauncher.launch("image/*")
    }
}

Použití ve Fragment

Ve Fragment se registrace provádí v onCreate, onAttach nebo inicializaci v onCreateView. FragmentActivity předává launcher přes rodičovskou Activity, takže výsledek je zpracováván uvnitř Fragment, nikoli v Activity. To zlepšuje zapouzdření ve srovnání s onActivityResult, kde byly všechny výsledky ze všech Fragment shromažďovány v jedné metodě Activity.

class ProfileFragment : Fragment() {
    private val cameraLauncher =
        registerForActivityResult(ActivityResultContracts.TakePicture()) { success ->
            if (success) { updateProfilePhoto() }
        }

    fun takePhoto(photoUri: Uri) {
        cameraLauncher.launch(photoUri)
    }
}

ActivityResultLauncher v Jetpack Compose

Jetpack Compose poskytuje speciální funkcionalitu composable pro Activity Result API — rememberLauncherForActivityResult. Na rozdíl od klasického přístupu je v Compose launcher vytvořen jako objekt navázaný na životní cyklus composable přes remember. To umožňuje používat Activity Result API plně deklarativním stylem bez přímého přístupu k Activity nebo Fragment.

rememberLauncherForActivityResult

rememberLauncherForActivityResult přijímá Contract a callback, vrací ActivityResultLauncher. Launcher je zachován při rekompozici a automaticky čištěn při opuštění kompozice. Volání launch nastává jako reakce na událost — například stisknutí tlačítka nebo změna stavu.

@Composable
fun PhotoPicker() {
    val context = LocalContext.current
    val launcher = rememberLauncherForActivityResult(
        ActivityResultContracts.GetContent()
    ) { uri -> handleImage(uri) }

    Button(onClick = { launcher.launch("image/*") }) {
        Text("Vybrat fotografii")
    }
}

Zpracování oprávnění v Compose

Žádost o oprávnění v Compose se také provádí pomocí rememberLauncherForActivityResult s kontraktem RequestPermission nebo RequestMultiplePermissions. Google doporučuje používat accompanist-permissions, ale pod kapotou také používá Activity Result API. Pro kontrolu stavu oprávnění je vhodné ukládat stav do remember nebo ViewModel.

Typické chyby a osvědčené postupy

Activity Result API odstranilo mnoho problémů starého přístupu, ale jeho nesprávné použití může vést k novým typům chyb. Podívejme se na nejčastější problémy a způsoby, jak se jim vyhnout.

Chyba: registrace uvnitř lambdy nebo korutiny

Registrace launcheru musí proběhnout při inicializaci komponenty — v onCreate Activity nebo inicializátoru Fragment. Pokud registrujete launcher uvnitř lambdy, callbacku nebo korutiny, při znovuvytvoření Activity může být registrace provedena znovu a starý launcher ztratí spojení s výsledkem.

Chyba: registrace více launcherů se stejným klíčem

Každý launcher získává jedinečný klíč pro ukládání stavu. Pokud zaregistrujete dva launchery se stejným Contract v jedné komponentě, SavedStateRegistry může přepsat stav jednoho druhým. Android Studio na to upozorňuje pomocí lint pravidla UnnecessaryRegisterForActivityResult, ale je lepší kontrolovat jedinečnost ručně.

Osvědčený postup: vždy zpracovávat null výsledek

Uživatel může zrušit akci — stisknout systémové tlačítko zpět, minimalizovat aplikaci nebo přepnout na jinou aplikaci. V tomto případě callback obdrží null nebo ActivityResult s RESULT_CANCELED. Vždy kontrolujte výsledek na null před použitím, abyste předešli NullPointerException.

Osvědčený postup: vlastní Contract pro znovupoužitelnou logiku

Pokud vaše aplikace často spouští podobné scénáře — například výběr kontaktu s vrácením jména a telefonu — vytvořte si vlastní Contract. To zlepšuje čitelnost kódu a umožňuje centrálně měnit logiku spouštění a zpracování výsledku.

class PickContactContract : ActivityResultContract<Void, ContactData?>() {
    override fun createIntent(context: Context, input: Void?) =
        Intent(Intent.ACTION_PICK).setType(ContactsContract.Contacts.CONTENT_TYPE)

    override fun parseResult(resultCode: Int, intent: Intent?) =
        intent?.data?.let { queryContact(it) }
}