Przejście

Animuj ruch w interfejsie za pomocą układów początkowego i końcowego.
Najnowsza aktualizacja Wersja stabilna Wersja kandydująca do publikacji Wersja beta Wersja Alfa
17 grudnia 2025 r. 1.6.0 1.7.0-rc01 - -

Deklarowanie zależności

Aby dodać zależność od biblioteki Transition, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w artykule Repozytorium Maven Google.

Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

Odlotowe

dependencies {
    // Java language implementation
    implementation "androidx.transition:transition:1.6.0"
    // Kotlin
    implementation "androidx.transition:transition-ktx:1.6.0"
}

Kotlin

dependencies {
    // Java language implementation
    implementation("androidx.transition:transition:1.6.0")
    // Kotlin
    implementation("androidx.transition:transition-ktx:1.6.0")
}

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nowy problem, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Aby oddać głos na istniejący problem, kliknij przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 1.7

Wersja 1.7.0-rc01

17 grudnia 2025 r.

Publikacje androidx.transition:transition:1.7.0-rc01 i androidx.transition:transition-ktx:1.7.0-rc01 Wersja 1.7.0-rc01 zawiera te zmiany.

Wersja 1.7.0-beta01

3 grudnia 2025 r.

Publikacje androidx.transition:transition:1.7.0-beta01 i androidx.transition:transition-ktx:1.7.0-beta01 Wersja 1.7.0-beta01 zawiera te zmiany.

Poprawki błędów

Wersja 1.7.0-alpha01

30 lipca 2025 r.

Publikacje androidx.transition:transition:1.7.0-alpha01 i androidx.transition:transition-ktx:1.7.0-alpha01 Wersja 1.7.0-alpha01 zawiera te zmiany.

Poprawki błędów

  • Naprawiliśmy awarię, która występowała, gdy widok był dołączony do okna z wartością null windowId. (I2ddf6)

Wersja 1.6

Wersja 1.6.0

23 kwietnia 2025 r.

Publikacje androidx.transition:transition:1.6.0 i androidx.transition:transition-ktx:1.6.0 Wersja 1.6.0 zawiera te zmiany.

Wersja 1.6.0-rc01

26 marca 2025 r.

Publikacje androidx.transition:transition:1.6.0-rc01 i androidx.transition:transition-ktx:1.6.0-rc01 Wersja 1.6.0-rc01 zawiera te zmiany.

Wersja 1.6.0-beta01

12 marca 2025 r.

androidx.transition:transition:1.6.0-beta01 i androidx.transition:transition-ktx:1.6.0-beta01 zostały udostępnione bez zmian od ostatniej wersji alfa. Wersja 1.6.0-beta01 zawiera te zmiany.

Wersja 1.6.0-alpha01

11 grudnia 2024 r.

Publikacje androidx.transition:transition:1.6.0-alpha01 i androidx.transition:transition-ktx:1.6.0-alpha01 Wersja 1.6.0-alpha01 zawiera te zmiany.

Nowe funkcje

  • Przejście ustawia teraz rozłączony element nadrzędny dla ViewOverlays używanego do animowania przejść. Umożliwia to rozwiązywanie problemów z właścicielami za pomocą rozłączonego elementu nadrzędnego, co oznacza, że podczas przejścia możesz teraz prawidłowo rozwiązywać problemy z ViewModels, cyklami życia itp. (I10a16, b/340894487, b/287484338)

Poprawki błędów

  • Ta biblioteka korzysta teraz z adnotacji o wartości null JSpecify, które są używane w typie. Deweloperzy Kotlin powinni używać tego argumentu kompilatora, aby wymusić prawidłowe użycie: -Xjspecify-annotations=strict (jest to domyślny argument począwszy od wersji 2.1.0 kompilatora Kotlin). (I1f54e, b/326456246)
  • Usunęliśmy ręczne określanie dostępu do nowych interfejsów API platformy, ponieważ odbywa się to automatycznie za pomocą modelowania interfejsu API podczas korzystania z R8 z AGP 7.3 lub nowszym (np. R8 w wersji 3.3) oraz w przypadku wszystkich kompilacji podczas korzystania z AGP 8.1 lub nowszego (np. D8 w wersji 8.1). Klientom, którzy nie korzystają z AGP, zalecamy przejście na D8 w wersji 8.1 lub nowszej. Więcej szczegółów znajdziesz w tym artykule. (Ia60e0, b/345472586)

Wersja 1.5

Wersja 1.5.1

24 lipca 2024 r.

Publikacje androidx.transition:transition:1.5.1 i androidx.transition:transition-ktx:1.5.1 Wersja 1.5.1 zawiera te zmiany.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że wywołania funkcji animateToStart() lub animateToEnd() w przypadku przejścia z możliwością przewijania były ignorowane, jeśli przejście nie zostało rozpoczęte. (I44d96, b/338624457)

Wersja 1.5.0

1 maja 2024 r.

Publikacje androidx.transition:transition:1.5.0 i androidx.transition:transition-ktx:1.5.0 Wersja 1.5.0 zawiera te zmiany.

Ważne zmiany od wersji 1.4.0

  • Przejścia obsługują wyszukiwanie w interfejsie API na poziomie 34 i wyższym. Do interfejsów API TransitionManager i controlDelayedTransition() dodaliśmy nowy interfejs API, który zwraca TransitionSeekController umożliwiający wyszukiwanie Transition. Ta funkcja jest używana przez Fragment 1.7.0 do automatycznego wyszukiwania przejść podczas korzystania z gestu przewidywania powrotu.
  • Przejścia mają nową metodę getRootTransition(), która zwraca przejście zawierające bieżące przejście lub bieżące przejście, jeśli nie jest ono zawarte w żadnym innym przejściu. Może to być przydatne, jeśli deweloper potrzebuje detektorów, które będą reagować na rozpoczęcie lub zakończenie całej animacji.
  • TransitionListeners ma teraz nowe onTransitionStart() i onTransitionEnd(), które informują dewelopera, czy przejście się rozpoczyna lub kończy, czy jest odwrócone, czy nie. Może to być ważne w przypadku tworzenia przejść, które można przewijać i które mają TransitionListeners.

Wersja 1.5.0-rc02

17 kwietnia 2024 r.

Publikacje androidx.transition:transition:1.5.0-rc02 i androidx.transition:transition-ktx:1.5.0-rc02 Wersja 1.5.0-rc02 zawiera te zmiany.

Aktualizacja zależności

  • Zaktualizowaliśmy zależność Fragment do wersji 1.7.0-rc02, w której usunęliśmy błąd polegający na tym, że jeśli do transakcji, w której wszystkie inne przejścia były możliwe do przewijania, dodano element udostępniony, którego nie można było przewijać, następowało awaria.

Wersja 1.5.0-rc01

3 kwietnia 2024 r.

Publikacje androidx.transition:transition:1.5.0-rc01 i androidx.transition:transition-ktx:1.5.0-rc01 Wersja 1.5.0-rc01 zawiera te zmiany.

Wersja 1.5.0-beta01

20 marca 2024 r.

Publikacje androidx.transition:transition:1.5.0-beta01 i androidx.transition:transition-ktx:1.5.0-beta01 Wersja 1.5.0-beta01 zawiera te zmiany.

Poprawki błędów

  • Rozwiązaliśmy problem w fragmentach, który powodował, że przerwanie przychodzących przejść gestem przewidywanego powrotu niszczyło widok wejściowy, co mogło skutkować wyświetlaniem pustego ekranu. (Id3f22, b/319531491)

Wersja 1.5.0-alpha06

10 stycznia 2024 r.

Publikacje androidx.transition:transition:1.5.0-alpha06 i androidx.transition:transition-ktx:1.5.0-alpha06 Wersja 1.5.0-alpha06 zawiera te zatwierdzenia.

Poprawki błędów

  • Gdy używana jest funkcjaTransitionSeekController.animateToStart(), dodana funkcjaTransitionListeners będzie teraz wywoływać funkcjęonTransitionEnd() po podaniu przez funkcjęanimateToStart() wartościRunnable. (Ic6a55, b/307624554)

Aktualizacja zależności

  • Zależność Fragment została zaktualizowana do wersji 1.7.0-alpha08.

Wersja 1.5.0-alpha05

29 listopada 2023 r.

Publikacje androidx.transition:transition:1.5.0-alpha05 i androidx.transition:transition-ktx:1.5.0-alpha05 Wersja 1.5.0-alpha05 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem NullPointerException, który był spowodowany ustawieniem przejścia udostępnionego elementu i nieustawieniem enter/exitTransition. (I8472b)
  • Rozwiązaliśmy problem polegający na tym, że animateToStart() z Slide() nie przenosiło widoku z powrotem do pozycji początkowej (I698f4, b/300157785).
  • Rozwiązaliśmy problem z ponownym wejściem w przejście, który powodował przerwanie anulowania. (Iddcce, b/308379201)

Wersja 1.5.0-alpha04

4 października 2023 roku

androidx.transition:transition:1.5.0-alpha04 i `androidx.transition:transition-ktx:1.5.0-alpha04. Wersja 1.5.0-alpha04 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Zmiana powodująca niezgodność – metoda animateToStart() przyjmuje teraz parametr Runnable, który powinien być używany do przywracania widoków przejściowych do ich pierwotnego stanu.

Wersja 1.5.0-alpha03

20 września 2023 r.

Publikacje androidx.transition:transition:1.5.0-alpha03 i androidx.transition:transition-ktx:1.5.0-alpha03 Wersja 1.5.0-alpha03 zawiera te zatwierdzenia.

Nowe funkcje

  • Biblioteka Transition obsługuje teraz animacje przewidywanego powrotu w aplikacji na urządzeniach z Androidem 14, gdy jest używana z fragmentem 1.7.0-alpha05.

Poprawki błędów

  • Usunięto błąd przerywania przejścia slajdu. Gdy przejście slajdu przerywało przejście wejścia, aby usunąć widok, przeskakiwało do nieprawidłowej pozycji. (I946f8, b/297427333)

Wersja 1.5.0-alpha02

6 września 2023 r.

Publikacje androidx.transition:transition:1.5.0-alpha02 i androidx.transition:transition-ktx:1.5.0-alpha02 Wersja 1.5.0-alpha02 zawiera te zatwierdzenia.

Nowe funkcje

  • TransitionSeekController umożliwia teraz ustawienie postępu jako ułamka całkowitego czasu trwania za pomocą setCurrentFragment(). (aosp/2647607)
  • TransitionSeekController umożliwia teraz obserwowanie postępów podczas korzystania z funkcji animateToStart() i animateToEnd() przez wywołanie funkcji addOnProgressChangedListener. (aosp/2647607)
  • Dodano TransitionManager.seekTo(), aby umożliwić korzystanie ze scen do wyszukiwania przejść. (aosp/2647607)
  • Dodano animacje oparte na fizyce do przejść podczas przewijania. Wykorzystuje 1-wymiarowy tracker prędkości do śledzenia zmian postępu za pomocą setCurrentFraction() lub setCurrentPlayTimeMillis() i używa go do określania początkowej prędkości animateToStart i animateToEnd. (aosp/2647607)

Poprawki błędów

  • Usunęliśmy migotanie podczas wyszukiwania AutoTransition. (aosp/2643369)
  • Rozwiązaliśmy problem, który powodował, że przejście Slide przeskakiwało do nieprawidłowej pozycji początkowej, gdy zostało przerwane. (aosp/2733729, b/297427333)

Aktualizacja zależności

  • Przejście jest teraz kompilowane z interfejsem API 34.

Wersja 1.5.0-alpha01

10 maja 2023 r.

Publikacje androidx.transition:transition:1.5.0-alpha01 i androidx.transition:transition-ktx:1.5.0-alpha01 Ta wersja jest opracowywana w wewnętrznej gałęzi.

Nowe funkcje

  • Przejścia obsługują wyszukiwanie w interfejsie API na poziomie 34 i wyższym. Do interfejsu TransitionManager dodano nowy interfejs API controlDelayedTransition(), który zwraca TransisionSeekController umożliwiający wyszukiwanie przejścia.

Zmiany w interfejsie API

  • TransitionManager ma nową metodę controlDelayedTransition(), która umożliwia aplikacjom kontrolowanie postępu animacji przejścia w przypadku interfejsu API w wersji 34 lub nowszej. Zwracany obiekt TransitionSeekController informuje programistę, kiedy przejście jest gotowe do wyszukiwania, jaka jest długość animacji, i umożliwia ustawienie bieżącego czasu animacji. controlDelayedTransition() obsługuje tylko przejścia, które zastępują isSeekable(), aby zwracać wartość „true”.
  • Przejścia mają nową metodę getRootTransition(), która zwraca przejście zawierające bieżące przejście lub bieżące przejście, jeśli nie jest ono zawarte w żadnym innym przejściu. Może to być przydatne, jeśli deweloper potrzebuje detektorów, które będą reagować na rozpoczęcie lub zakończenie całej animacji.
  • TransitionListeners ma teraz nowe onTransitionStart() i onTransitionEnd(), które informują dewelopera, czy przejście się rozpoczyna lub kończy, czy jest odwrócone, czy nie. Może to być ważne w przypadku tworzenia przejść, które można przewijać i które mają TransitionListeners.

Poprawki błędów

  • Przejścia są teraz kopiowane wraz z TransitionListeners podczas klonowania. Oznacza to, że dodanie nowych słuchaczy podczas createAnimator() nie wpłynie na przejście główne.

Wersja 1.4.1

Wersja 1.4.1

21 kwietnia 2021 r.

Publikacje androidx.transition:transition:1.4.1 i androidx.transition:transition-ktx:1.4.1 Wersja 1.4.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że rozpoczęcie Transition w jednym kontenerze nieumyślnie wstrzymywało inne trwające przejścia w osobnych kontenerach, przez co te przejścia nigdy się nie kończyły. (aosp/1664439, b/182845041)

Wersja 1.4.0

Wersja 1.4.0

27 stycznia 2021 r.

Publikacje androidx.transition:transition:1.4.0 i androidx.transition:transition-ktx:1.4.0 Wersja 1.4.0 zawiera te zatwierdzenia.

Główne zmiany od wersji 1.3.0

  • Artefakt transition-ktx wprowadza rozszerzenia Kotlin do dodawania słuchaczy do instancji AndroidX Transition. (b/138870873)

Wersja 1.4.0-rc01

2 grudnia 2020 r.

androidx.transition:transition:1.4.0-rc01 i androidx.transition:transition-ktx:1.4.0-rc01 są publikowane bez zmian od 1.4.0-beta01. Wersja 1.4.0-rc01 zawiera te zatwierdzenia.

Wersja 1.4.0-beta01

22 lipca 2020 r.

androidx.transition:transition:1.4.0-beta01 i androidx.transition:transition-ktx:1.4.0-beta01 zostały opublikowane bez zmian od 1.4.0-alpha01. Wersja 1.4.0-beta01 zawiera te zatwierdzenia.

Wersja 1.4.0-alpha01

24 czerwca 2020 r.

Publikacje androidx.transition:transition:1.4.0-alpha01 i androidx.transition:transition-ktx:1.4.0-alpha01 Wersja 1.4.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Artefakt transition-ktx wprowadza rozszerzenia Kotlin do dodawania słuchaczy do instancji AndroidX Transition. (b/138870873)

Wersja 1.3.1

Wersja 1.3.1

19 lutego 2020 r.

Publikacja androidx.transition:transition:1.3.1 Wersja 1.3.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Usunęliśmy błąd, który powodował nieprawidłowe przycinanie niektórych animowanych widoków podczas korzystania z funkcji ChangeTransform (b/148798452).

Wersja 1.3.0

Wersja 1.3.0

22 stycznia 2020 r.

Publikacja androidx.transition:transition:1.3.0 Wersja 1.3.0 zawiera te zmiany.

Ważne zmiany od wersji 1.2.0

  • Ulepszenia w przypadku Fragmentu 1.2.0: ulepszono integrację z Fragmentem 1.2.0, aby widok fragmentu nie był niszczony przed zakończeniem przejścia i aby przejścia były anulowane we właściwym czasie.

Wersja 1.3.0-rc02

4 grudnia 2019

Publikacja androidx.transition:transition:1.3.0-rc02 Wersja 1.3.0-rc02 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że po wysunięciu ukrytego fragmentu widoki były nieprawidłowo oznaczane symbolem INVISIBLE. (b/70793925)

Wersja 1.3.0-rc01

23 października 2019 r.

androidx.transition:transition:1.3.0-rc01 została opublikowana bez zmian od 1.3.0-beta01. Wersja 1.3.0-rc01 zawiera te zatwierdzenia.

Wersja 1.3.0-beta01

9 października 2019 r.

Publikacja androidx.transition:transition:1.3.0-beta01 Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

Nowe funkcje

  • Ulepszyliśmy integrację z Fragmentem 1.2.0-beta01, aby mieć pewność, że widok Fragmentu nie zostanie zniszczony przed zakończeniem przejścia i że przejścia są anulowane we właściwym czasie. (aosp/1119841)

Wersja 1.2.0

Wersja 1.2.0

9 października 2019 r.

Wersja androidx.transition:transition:1.2.0 nie zawiera zmian w porównaniu z wersją 1.2.0-rc01 . Wersja 1.2.0 zawiera te zmiany.

Ważne zmiany od wersji 1.1.0

Tej wersji należy używać, jeśli kierujesz reklamy na poziom interfejsu API 29. W przeciwnym razie niektóre przejścia nie będą działać prawidłowo. Zamiast wywołań odbicia ta wersja korzysta z nowych metod publicznych dodanych na poziomie interfejsu API 29. Jest to część naszych działań związanych z ograniczaniem interfejsów innych niż SDK.

Wersja 1.2.0-rc01

5 września 2019 r.

androidx.transition:transition:1.2.0-rc01 została wydana bez zmian w stosunku do wersji 1.2.0-beta01. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Wersja 1.2.0-beta01

2 lipca 2019 r.

Publikacja androidx.transition:transition:1.2.0-beta01 Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Nowe funkcje

  • Z tej wersji należy korzystać, jeśli jako wartość atrybutu targetSdkVersion podajesz 29. W przeciwnym razie niektóre przejścia nie będą działać prawidłowo. Zamiast wywołań odbicia ta wersja korzysta z nowych metod publicznych dodanych na poziomie interfejsu API 29. Jest to część naszych działań związanych z ograniczaniem interfejsów innych niż SDK.

Wersja 1.2.0-alpha01

7 maja 2019 r.

Publikacja androidx.transition:transition:1.2.0-alpha01

Nowe funkcje

  • Tej wersji należy używać, jeśli określasz Q jako targetSdkVersion. W przeciwnym razie niektóre przejścia nie będą działać prawidłowo. Zamiast wywołań odbicia ta wersja korzysta z nowych metod publicznych dodanych w wersji Q. Jest to część naszych działań związanych z ograniczaniem interfejsów innych niż SDK.

Wersja 1.1.0

Wersja 1.1.0

2 lipca 2019 r.

androidx.transition:transition:1.1.0 zostaje opublikowany bez zmian w stosunku do 1.1.0-rc02. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Wersja 1.1.0-rc02

5 czerwca 2019 r.

Publikacja androidx.transition:transition:1.1.0-rc02 Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Poprawki błędów

  • Poprawka, która umożliwia prawidłowe działanie funkcji TransitionManager.endTransitions() w przypadku przejść zależnych. (aosp/946400)

Wersja 1.1.0-rc01

7 maja 2019 r.

Publikacja androidx.transition:transition:1.1.0-rc01 Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Wersja 1.1.0-beta01

3 kwietnia 2019 r.

Publikacja androidx.transition:transition:1.1.0-beta01 Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Poprawki błędów

  • Usunięto błąd buforowania ViewGroupOverlay w Visibility, który występował na poziomie interfejsu API 17 i niższym (aosp/937350).

Wersja 1.1.0-alpha02

13 marca 2019 r.

Publikacja androidx.transition:transition:1.1.0-alpha02 Pełną listę zmian zawartych w tej wersji znajdziesz tutaj.

Zmiany w interfejsie API

  • Typ parametru metody Scene.getCurrentScene() został zmieniony z View na ViewGroup.

Poprawki błędów

  • SidePropagation nie działa, gdy dodatkowe opóźnienie jest podane za pomocą setStartDelay() (b/119839526).
  • ChangeImageTransform stosuje nieprawidłową macierz, gdy zostanie przerwany przed API 21 (b/123226255).
  • ChangeTransform w niektórych przypadkach działa nieprawidłowo przed API 21 (b/125777978).

Wersja 1.1.0-alpha01

3 grudnia 2018 r.

Zmiany w interfejsie API

  • aosp/807055: Scene.getCurrentScene(View) metoda udostępniona publicznie. Umożliwia to pisanie niestandardowej logiki warunkowej w zależności od bieżącej sceny.

Poprawki błędów

  • Usunięto awarię podczas używania znaku TransitionManager do zwijania i rozwijania elementu w RecyclerView (b/37129527).
  • Usunęliśmy błąd polegający na nieprawidłowej animacji w przypadku zastosowania 2 przejść widoczności (b/62629600).
  • Zezwalaj na zastępowanie wartości, takich jak czas trwania i interpolator, w przypadku elementów podrzędnych TransitionSet (b/64644617).
  • Naprawiono wiele innych drobnych błędów.