Przekazywanie danych pomiędzy aktywnościami

Przesłanie danych w obrębie jednej aplikacji pomiędzy różnymi jej aktywnościami polega na wykorzystaniu metody

putExtra()- do wysłania danych
getExtra()- do odbioru danych

Metoda putExtra() przekazuje podstawowe typy danych takie jak Int, Float, Char, Double, String, IntArray itd. Odbywa się to przez podanie do metody dwóch argumentów. Pierwszym argumentem jest tak zwany klucz, drugi argument to przesyłana dana. Klucz pełni role identyfikatora przesyłanej danych. Po kluczu rozpoznaje się przesłane dane w momencie ich odbioru w drugiej aktywności.

Przykładowa instrukcja

Wskazówka:


val bt1=findViewById<Button>(R.id.button1)
bt1.setOnClickListener {
    val intencja = Intent(this,Okno1::class.java)
    intencja.putExtra("dane_imie","Jan")
    intencja.putExtra("dane_nazwisko","Kowalski")
    intencja.putExtra("dane_wiek",24)
}

Pisząc powyższy kod, można się posłużyć mechanizmem podpowiedzi. Patrz poniższa ilustracja

Android Studio przesyłanie danych putExtra

Przesłane dane w nowo otwartej aktywności należy odebrać w metodzie OnCreate() stosując metodę getExtra() klasy intent dobraną do typu przesyłanych danych. Rozpoznanie danych odbywa się przez podanie klucza. Nazwa klucza powinna być zgodna co do użytych znaków w kluczy wysyłającym dane. Patrz poniższy przykładowy kod

Wskazówka:


val txtImie=intent.getStringExtra("dane_imie")
val txtNazwisko=intent.getStringExtra("dane_nazwisko")
val intWiek=intent.getIntExtra("dane_wiek",0)

Przesyłanie parcelowanych danych

Sposób przesyłania pojedynczych danych jest prosty ale nie jest zbyt wygodny. Dużo lepszą metodą jest przesyłanie danych serializowanych lub parcelowanych. Wymienione sposoby wymagają skorzystania z odpowiedniego interfejsu: Parcelable lub Serializable. Interfejs Serializable jest standardowym interfejsem Java, zaś Parcelable jest składnikiem Android SDK. Parcelable jest szybszy niż Serializable.

Dodanie interfejsu Parcelable

Skorzystanie z interfejsu Parcelable w budowanym projekcie wymaga zmian w plikach bibliotek i plikach gradle tworzonej aplikacji.

Krok 1

W pliku libs.versions.toml w sekcji [versions] dodaj informację o możliwie najnowszej wersji kotlinPlugin (tu 1.9.0)

Wskazówka:


[versions]
agp = "8.4.0"
kotlin = "1.9.0"
kotlinPlugin = "1.9.0"
coreKtx = "1.13.1"

A w sekcji [plugins] dołącz moduł kotlin-parcelize. Patrz poniżej

Wskazówka:


[plugins]
android-application = { id = "com.android.application", version.ref = "agp" }
jetbrains-kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
kotlin-parcelize = { id = "org.jetbrains.kotlin.plugin.parcelize",  version.ref = "kotlinPlugin"  }

Krok 2

Aby skorzystać z interfejsu Parcelable należy go dołączyć w pluginach pliku build.gradle.kts modułu aplikacji.

Wskazówka:


plugins {
    alias(libs.plugins.android.application)
    alias(libs.plugins.jetbrains.kotlin.android)
    alias (libs.plugins.kotlin.parcelize)
}

Krok 3

oraz w pliku build.gradle.kts modułu projektu

Wskazówka:


plugins {
    alias(libs.plugins.android.application) apply false
    alias(libs.plugins.jetbrains.kotlin.android) apply false
    alias (libs.plugins.kotlin.parcelize) apply false
}

Krok 4

UWAGA! Po każdorazowej zmianie zawartości plików gradle należy wykonać synchronizację zmian. Patrz krok 3 na poniższym rysunku

Krok 5

Po aktualizacji zmiany pliku gradle należy w głównym pliku tworzonej aplikacji zaimportować dwa moduły bibliotek rozszerzeń (Parcelize i Parcelable). Patrz poniżej

Wskazówka:


import androidx.appcompat.app.AppCompatActivity
import kotlinx.parcelize.Parcelize
import android.os.Parcelable

class MainActivity : AppCompatActivity() {

Intencje jawne: Przekazywanie danych pomiędzy aktywnościami

Tworzymy projekt, w którym będziemy mogli wykorzystać cztery osobne okna aktywności. Jedno z okien jest oknem głównym, pozostałe trzy są oknami podrzędnymi. Dodanie nowych aktywności w obrębie jednego projektu można wykonać po wybraniu New/ Activity/ Empty Activity

Ustaw nazwę okna aktywności i język (Kotlin)

Po dodaniu mamy cztery aktywności:

MainActivity (przyjmujemy że jest główna)
Okno1
Okno2
Okno3

Prawidłowo dodane aktywności do projektu są zainicjowane w manifeście tworzonej aplikacji. Sprawdź czy manifest aplikacji zawiera odpowiednie wpisy. Patrz poniższy kod

Wskazówka:


<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <application
        android:allowBackup="true"
        android:dataExtractionRules="@xml/data_extraction_rules"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.IntencjaAktywnosci"
        tools:targetApi="31">
        <activity
            android:name=".Okno1"
            android:exported="false" />
        <activity
            android:name=".Okno2"
            android:exported="false" />
        <activity
            android:name=".Okno3"
            android:exported="false" />
        <activity
            android:name=".MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

</manifest>

Pliki XML układu tworzonych aktywności

Układ widoku głównej aktywności powinien zawierać poniższe kontrolki

TextView- 1 sztuka (tytuł okna aktywności)
PlainText- 2 sztuki (pola do wprowadzania imienia i nazwiska)
Number- 1 sztuka (pole do wprowadzania ilości lat- wieku)
Button- 4 sztuki

Pozostałe okna aktywności podrzędnych są do siebie podobne. Różnią się tylko tekstem nagłówkowym Okno 1, Okno 2, Okno 3 podanym w kontrolce TextView

Wysyłanie pojedynczych danych

Wysyłanie danych z jednej aktywności do drugiej rozpoczniemy od najprostszego rozwiązania. Będziemy wysyłać pojedyncze dane metoda putExtra(). W pliku głównej aktywności (MainActivity.kt) wysłanie danych zrealizujemy po kliknięciu w pierwszą kontrolkę typu Button. Patrz poniższy kod.

Wskazówka:


override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    //wyślij dane najprostszą metoda do aktywności Okno1
    val bt1=findViewById<Button>(R.id.button1)
    bt1.setOnClickListener {
        val intencja = Intent(this,Okno1::class.java)
        val imie=findViewById<EditText>(R.id.editTextText1).text.toString()
        intencja.putExtra("dane_imie",imie)
        val nazwisko=findViewById<EditText>(R.id.editTextText2).text.toString()
        intencja.putExtra("dane_nazwisko",nazwisko)
        val wiek=findViewById<EditText>(R.id.editTextNumber1).text.toString().toInt()
        intencja.putExtra("dane_wiek",wiek)
        startActivity(intencja)
    }
    //zamkniecie aplikacji
    val bt4=findViewById<Button>(R.id.button4)
    bt4.setOnClickListener {
        finishAffinity()
        System.exit(0)
    }
}

Zauważ, że każda wysyłana pojedyncza dana ma inny unikatowy klucz. W tym przypadku klucze to

dane_imie
dane_nazwisko
dane_wiek

Odebranie danych w aktywności Okno1 realizuje poniższy kod, w który to używamy tych samych kluczy. UWAGA! Ma znaczenie pisownia, w kluczach rozróżniana jest wielkość liter (duże/ małe)

Wskazówka:


class Okno1 : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_okno1)

        //odebranie pojedynczych danych
        val txtImie=intent.getStringExtra("dane_imie")
        val txtNazwisko=intent.getStringExtra("dane_nazwisko")
        val intWiek=intent.getIntExtra("dane_wiek",0)

        val txt=findViewById<TextView>(R.id.textView2)
        txt.setText("Przesłane dane:\n"
                    +txtImie+"\n"
                    +txtNazwisko+"\n"
                    +intWiek.toString())

        //powrót do okna głownego
        val bt1=findViewById<Button>(R.id.button1)
        bt1.setOnClickListener {
            val intencja = Intent(this,MainActivity::class.java)
            startActivity(intencja)
        }
    }
}

Skompiluj aplikację i sprawdź efekt działania.

Przesłanie danych metodą Parcelable

W tej metodzie prześlemy dane złożone w postaci rekordu danych, który to w Kotlinie przymuje postać klasy danych (data class). Na końcu pliku (MainActivity.kt) głównej aktywności dopisujemy klasę danych, którą należy parcelizować

Wskazówka:


@Parcelize
data class Osoba(
    var nazwisko: String="",
    val imie: String="",
    val wiek: Int=0
) : Parcelable

Przesłanie danych realizujemy po kliknięciu w druga kontrolkę typu Button. I tak samo jak poprzednio używamy klucza. Tym razem klucz to: paczka_osoba.

Wskazówka:


val intencja = Intent(this,Okno2::class.java)
val osoba:Osoba=Osoba(nazwisko,imie,wiek)
intencja.putExtra("paczka_osoba",osoba)

Kod przesłania danych realizowany po kliknięciu w przycisk.

Wskazówka:


//wyślij dane, metoda Parcelable
val bt2=findViewById<Button>(R.id.button2)
bt2.setOnClickListener {
    val intencja = Intent(this,Okno2::class.java)
    val imie=findViewById<EditText>(R.id.editTextText1).text.toString()
    val nazwisko=findViewById<EditText>(R.id.editTextText2).text.toString()
    val wiek=findViewById<EditText>(R.id.editTextNumber1).text.toString().toInt()
    val osoba:Osoba=Osoba(nazwisko,imie,wiek)
    intencja.putExtra("paczka_osoba",osoba)
    startActivity(intencja)
}

W pliku klasy aktywności Okno2.kt odebranie danych przesłanych tą metodą realizuje poniższy kod

Wskazówka:


class Okno2 : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_okno2)
        val txt=findViewById<TextView>(R.id.textView2)
        //odebranie pakietu danych, metoda Parcelize
        val osoba=intent.getParcelableExtra<Osoba>("paczka_osoba")as Osoba
        txt.setText("Przesłane dane osoba:\n"
                + osoba.imie +"\n"
                +osoba.nazwisko+"\n"
                +osoba.wiek)
        //powrót do okna głownego
        val bt1=findViewById<Button>(R.id.button1)
        bt1.setOnClickListener {
            val intencja = Intent(this,MainActivity::class.java)
            startActivity(intencja)
        }
    }
}

Skompiluj program i sprawdź działanie

Przesłanie danych metodą Serializable

Podobnie jak poprzednio przygotujemy klasę danych, którą przed wysłaniem należy serializować. Dopisujemy ją na końcu pliku (MainActivity.kt) głównej aktywności. Nowej klasie danych nadajemy nazwę Osoba2

Wskazówka:


@Parcelize
data class Osoba(
    var nazwisko: String="",
    val imie: String="",
    val wiek: Int=0
) : Parcelable

data class Osoba2(
    var nazwisko:String="",
    var imie:String="",
    var wiek:Int=0
): Serializable

W nagłówku tego samego pliku importujemy bibliotekę java.io.Serializable. Patrz poniżej

Wskazówka:


import kotlinx.parcelize.Parcelize
import android.os.Parcelable
import java.io.Serializable

Wysłanie danych podpinamy pod trzeci przycisk. Przypisujemy klucz: paczka_osoba2

Wskazówka:


//wyślij dane, metoda Serializable
val bt3=findViewById<Button>(R.id.button3)
bt3.setOnClickListener {
   val intencja = Intent(this,Okno3::class.java)
   val osoba2=Osoba2()
   osoba2.imie=findViewById<EditText>(R.id.editTextText1).text.toString()
   osoba2.nazwisko=findViewById<EditText>(R.id.editTextText2).text.toString()
   osoba2.wiek=findViewById<EditText>(R.id.editTextNumber1).text.toString().toInt()
   intencja.putExtra("paczka_osoba2",osoba2)
   startActivity(intencja)
}

Skompiluj program i sprawdź działanie

Pełny kod głównej aktywności

Wskazówka:


import android.content.Intent
import android.os.Bundle
import android.widget.Button
import android.widget.EditText
import androidx.appcompat.app.AppCompatActivity
import kotlinx.parcelize.Parcelize
import android.os.Parcelable
import java.io.Serializable


class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        //wyślij dane najprostszą metoda do aktywności Okno1
        val bt1=findViewById<Button>(R.id.button1)
        bt1.setOnClickListener {
            val intencja = Intent(this,Okno1::class.java)
            val imie=findViewById<EditText>(R.id.editTextText1).text.toString()
            intencja.putExtra("dane_imie",imie)
            val nazwisko=findViewById<EditText>(R.id.editTextText2).text.toString()
            intencja.putExtra("dane_nazwisko",nazwisko)
            val wiek=findViewById<EditText>(R.id.editTextNumber1).text.toString().toInt()
            intencja.putExtra("dane_wiek",wiek)
            startActivity(intencja)
        }
        //wyślij dane, metoda Parcelable
        val bt2=findViewById<Button>(R.id.button2)
        bt2.setOnClickListener {
            val intencja = Intent(this,Okno2::class.java)
            val imie=findViewById<EditText>(R.id.editTextText1).text.toString()
            val nazwisko=findViewById<EditText>(R.id.editTextText2).text.toString()
            val wiek=findViewById<EditText>(R.id.editTextNumber1).text.toString().toInt()
            val osoba:Osoba=Osoba(nazwisko,imie,wiek)
            intencja.putExtra("paczka_osoba",osoba)
            startActivity(intencja)
        }
        //wyślij dane, metoda Serializable
        val bt3=findViewById<Button>(R.id.button3)
        bt3.setOnClickListener {
           val intencja = Intent(this,Okno3::class.java)
           val osoba2=Osoba2()
           osoba2.imie=findViewById<EditText>(R.id.editTextText1).text.toString()
           osoba2.nazwisko=findViewById<EditText>(R.id.editTextText2).text.toString()
           osoba2.wiek=findViewById<EditText>(R.id.editTextNumber1).text.toString().toInt()
           intencja.putExtra("paczka_osoba2",osoba2)
           startActivity(intencja)
        }
        //zamkniecie aplikacji
        val bt4=findViewById<Button>(R.id.button4)
        bt4.setOnClickListener {
            finishAffinity()
            System.exit(0)
        }
    }
}

@Parcelize
data class Osoba(
    var nazwisko: String="",
    val imie: String="",
    val wiek: Int=0
) : Parcelable

data class Osoba2(
    var nazwisko:String="",
    var imie:String="",
    var wiek:Int=0
): Serializable

Kod aktywności Okno1

Wskazówka:


import android.content.Intent
import android.os.Bundle
import android.widget.Button
import android.widget.TextView
import androidx.activity.enableEdgeToEdge
import androidx.appcompat.app.AppCompatActivity
import androidx.core.view.ViewCompat
import androidx.core.view.WindowInsetsCompat

class Okno1 : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_okno1)

        //odebranie pojedynczych danych
        val txtImie=intent.getStringExtra("dane_imie")
        val txtNazwisko=intent.getStringExtra("dane_nazwisko")
        val intWiek=intent.getIntExtra("dane_wiek",0)

        val txt=findViewById<TextView>(R.id.textView2)
        txt.setText("Przesłane dane:\n"
                    +txtImie+"\n"
                    +txtNazwisko+"\n"
                    +intWiek.toString())

        //powrót do okna głownego
        val bt1=findViewById<Button>(R.id.button1)
        bt1.setOnClickListener {
            val intencja = Intent(this,MainActivity::class.java)
            startActivity(intencja)
        }
    }
}

Kod aktywności Okno2

Wskazówka:


import android.content.Intent
import android.os.Bundle
import android.widget.Button
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity

class Okno2 : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_okno2)
        val txt=findViewById<TextView>(R.id.textView2)
        //odebranie pakietu danych, metoda Parcelize
        val osoba=intent.getParcelableExtra<Osoba>("paczka_osoba")as Osoba
        txt.setText("Przesłane dane osoba:\n"
                + osoba.imie +"\n"
                +osoba.nazwisko+"\n"
                +osoba.wiek)
        //powrót do okna głownego
        val bt1=findViewById<Button>(R.id.button1)
        bt1.setOnClickListener {
            val intencja = Intent(this,MainActivity::class.java)
            startActivity(intencja)
        }
    }
}

Kod aktywności Okno3

Wskazówka:


import android.content.Intent
import android.os.Bundle
import android.widget.Button
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity

class Okno3 : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_okno3)
        val osoba2=intent.getSerializableExtra("paczka_osoba2")as Osoba2
        val txt=findViewById<TextView>(R.id.textView2)
        //odebranie pakietu danych, metoda Serializable
        txt.setText("Przesłane dane osoba2:\n"
                + osoba2.imie +"\n"
                +osoba2.nazwisko+"\n"
                +osoba2.wiek)
        //powrót do okna głownego
        val bt1=findViewById<Button>(R.id.button1)
        bt1.setOnClickListener {
            val intencja = Intent(this,MainActivity::class.java)
            startActivity(intencja)
        }
    }
}