Przejście

Animuj ruch w interfejsie za pomocą układów początkowych i końcowych.
Najnowsza aktualizacja Wersja stabilna Kandydat do wydania Wersja Beta Wydanie alfa
24 lipca 2024 r. 1.5.1 - - -

Deklarowanie zależności

Aby dodać zależność od Przenoszenie, musisz dodać repozytorium Google Maven do swojego w projektach AI. Zapoznaj się z repozytorium Google Maven. .

Dodaj zależności artefaktów, których potrzebujesz w pliku build.gradle aplikacji lub modułu:

Odlotowe

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

Kotlin

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

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

Opinia

Twoja opinia pomoże nam ulepszyć Jetpack. Daj nam znać, jeśli odkryjesz nowe problemy jak ulepszyć tę bibliotekę. Przyjrzyj się istniejące problemy w tej bibliotece, zanim utworzysz nową. Możesz zagłosować nad istniejącym problemem przez klikając przycisk gwiazdki.

Tworzenie nowego numeru

Zobacz dokumentację narzędzia Issue Tracker. .

Wersja 1.5

Wersja 1.5.1

24 lipca 2024 r.

androidx.transition:transition:1.5.1 i androidx.transition:transition-ktx:1.5.1 zostały udostępnione. Wersja 1.5.1 zawiera te zatwierdzenia.

Poprawki błędów

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

Wersja 1.5.0

1 maja 2024 r.

androidx.transition:transition:1.5.0 i androidx.transition:transition-ktx:1.5.0 zostały udostępnione. Wersja 1.5.0 zawiera te zatwierdzenia.

Ważne zmiany wprowadzone od wersji 1.4.0

  • Obsługa przenoszenia użytkowników za pomocą interfejsu API w wersji 34 lub nowszej. Do TransitionManager (controlDelayedTransition()) dodano nowy interfejs API, który zwraca TransitionSeekController umożliwiający wyszukiwanie Transition. Ta funkcja jest używana przez fragment 1.7.0 do automatycznego przewijania przejść podczas korzystania z przewidywanego gestu cofania.
  • Przejścia zawierają nową metodę (getRootTransition()), która zwraca przejście zawierające bieżące lub bieżące przejście, jeśli nie jest ono zawarte w żadnym innym przejściu. Jest to przydatne, jeśli deweloper potrzebuje deweloperów na czas rozpoczęcia lub zakończenia całego przejścia.
  • TransitionListeners ma teraz nowe detektory onTransitionStart() i onTransitionEnd(), dzięki którym deweloper może wiedzieć, czy przejście zaczyna się lub kończy w odwrotnym kierunku. Może to być ważne przy tworzeniu łatwych do przewijania przejść z elementem TransitionListeners.

Wersja 1.5.0-rc02

17 kwietnia 2024 r.

androidx.transition:transition:1.5.0-rc02 i androidx.transition:transition-ktx:1.5.0-rc02 zostały udostępnione. Wersja 1.5.0-rc02 zawiera te zatwierdzenia.

Aktualizacja zależności

  • Zaktualizowano zależność fragmentu do wersji 1.7.0-rc02. Naprawiliśmy błąd polegający na tym, że w sytuacji, gdy do transakcji, w której można było przewinąć wszystkie pozostałe przejścia, dochodziło do awarii, w przypadku dodania niewidocznego udostępnionego elementu.

Wersja 1.5.0-rc01

3 kwietnia 2024 r.

androidx.transition:transition:1.5.0-rc01 i androidx.transition:transition-ktx:1.5.0-rc01 zostały udostępnione. Wersja 1.5.0-rc01 zawiera te zatwierdzenia.

Wersja 1.5.0-beta01

20 marca 2024 r.

androidx.transition:transition:1.5.0-beta01 i androidx.transition:transition-ktx:1.5.0-beta01 zostały udostępnione. Wersja 1.5.0-beta01 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiono błąd we fragmentach „Fragmenty”, który powodował, że przerywanie przychodzących przejść gestem przewidywania skutkowało zniszczeniem widoku wejściowego, co mogło spowodować pozostawienie pustego ekranu. (Id3f22, b/319531491)

Wersja 1.5.0-alpha06

10 stycznia 2024 r.

androidx.transition:transition:1.5.0-alpha06 i androidx.transition:transition-ktx:1.5.0-alpha06 zostały udostępnione. Wersja 1.5.0-alfa06 zawiera te zatwierdzenia.

Poprawki błędów

  • Gdy funkcja TransitionSeekController.animateToStart() jest używana, dodana funkcja TransitionListeners będzie teraz wywoływać funkcję onTransitionEnd() po otrzymaniu parametru Runnable z obiektu animateToStart(). (Ic6a55, b/307624554)

Aktualizacja zależności

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

Wersja 1.5.0-alpha05

29 listopada 2023 r.

androidx.transition:transition:1.5.0-alpha05 i androidx.transition:transition-ktx:1.5.0-alpha05 zostały udostępnione. Wersja 1.5.0-alfa05 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiliśmy błąd NullPointerException spowodowany ustawieniem przejścia wspólnego elementu i braku ustawienia enter/exitTransition. (I8472b)
  • Rozwiązanie problemu polegającego na tym, że za pomocą funkcji animateToStart() i elementu Slide() nie udało się przenieść widoku z powrotem do pozycji początkowej (I698f4, b/300157785)
  • Rozwiązaliśmy problem z ponownym wyświetlaniem w funkcji przenoszenia, który powodował anulowanie subskrypcji. (Iddcce, b/308379201)

Wersja 1.5.0-alpha04

4 października 2023 roku

Zwolniono androidx.transition:transition:1.5.0-alpha04 i „androidx.transition:transition-ktx:1.5.0-alpha04”. Wersja 1.5.0-alfa04 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Zmiana niewłaściwa – metoda animateToStart() korzysta teraz z Runnable, który powinien być używany do przywrócenia widoków przejścia do ich pierwotnego stanu.

Wersja 1.5.0-alpha03

20 września 2023 r.

androidx.transition:transition:1.5.0-alpha03 i androidx.transition:transition-ktx:1.5.0-alpha03 zostały udostępnione. Wersja 1.5.0-alfa03 zawiera te zatwierdzenia.

Nowe funkcje

  • Przejście obsługuje teraz w aplikacji animacje przewidywanego Wstecz w aplikacji na urządzeniach z Androidem 14, gdy są używane z fragmentem 1.7.0-alpha05.

Poprawki błędów

  • Usunęliśmy błąd związany z przechodzeniem ze slajdu. Gdy przejście ze slajdu spowodowało przerwanie przejścia prowadzącego do usunięcia widoku, przeskoczyło do niewłaściwej pozycji. (I946f8, b/297427333)

Wersja 1.5.0-alpha02

6 września 2023 r.

androidx.transition:transition:1.5.0-alpha02 i androidx.transition:transition-ktx:1.5.0-alpha02 zostały udostępnione. Wersja 1.5.0-alfa02 zawiera te zatwierdzenia.

Nowe funkcje

  • W TransitionSeekController możesz teraz ustawić postęp jako ułamek łącznego czasu trwania w narzędziu setCurrentFragment(). (Aosp/2647607).
  • Aplikacja TransitionSeekController umożliwia teraz śledzenie postępów podczas korzystania z funkcji animateToStart() i animateToEnd() po wywołaniu funkcji addOnProgressChangedListener. (Aosp/2647607).
  • Dodano TransitionManager.seekTo(), aby umożliwić używanie scen do przewijania przejść. (Aosp/2647607).
  • Do wyszukiwania przejść dodaliśmy animacje oparte na fizyce. Wykorzystuje tracker 1-D do śledzenia zmiany postępu za pomocą setCurrentFraction() lub setCurrentPlayTimeMillis() oraz używa go do prędkości początkowej animateToStart i animateToEnd. (Aosp/2647607).

Poprawki błędów

  • Naprawiono migotanie podczas przewijania: AutoTransition. (Aosp/2643369).
  • Rozwiązaliśmy problem, który powodował, że przerywane przejście w trybie Slide powodowało przeskakiwanie do niewłaściwej pozycji początkowej. (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.

androidx.transition:transition:1.5.0-alpha01 i androidx.transition:transition-ktx:1.5.0-alpha01 zostały udostępnione. Ta wersja jest opracowana w gałęzi wewnętrznej.

Nowe funkcje

  • Obsługa przenoszenia użytkowników za pomocą interfejsu API w wersji 34 lub nowszej. Do TransitionManager (controlDelayedTransition()) dodano nowy interfejs API, który zwraca TransisionSeekController umożliwiający przejście do przejścia.

Zmiany interfejsu API

  • TransitionManager udostępnia nową metodę (controlDelayedTransition()), która umożliwia aplikacjom kontrolowanie postępu animacji przejścia w interfejsie API w wersji 34 i nowszych. Zwrócony parametr TransitionSeekController informuje dewelopera o tym, że przejście jest gotowe do przewijania, i o czasie trwania animacji. Pozwala także ustawić bieżący czas animacji. controlDelayedTransition() obsługuje tylko przejścia, które zastępują wartość isSeekable() tak, aby zwracała wartość „prawda”.
  • Przejścia zawierają nową metodę (getRootTransition()), która zwraca przejście zawierające bieżące lub bieżące przejście, jeśli nie jest ono zawarte w żadnym innym przejściu. Jest to przydatne, jeśli deweloper potrzebuje deweloperów na czas rozpoczęcia lub zakończenia całego przejścia.
  • TransitionListeners ma teraz nowe detektory onTransitionStart() i onTransitionEnd(), dzięki którym deweloper może wiedzieć, czy przejście zaczyna się lub kończy w odwrotnym kierunku. Może to być ważne przy tworzeniu łatwych do przewijania przejść z elementem TransitionListeners.

Poprawki błędów

  • Przenoszenie TransitionListeners jest teraz kopiowane podczas klonowania. Oznacza to, że dodanie nowych detektorów w okresie createAnimator() nie wpłynie na przejście z poziomu głównego.

Wersja 1.4.1

Wersja 1.4.1

21 kwietnia 2021 r.

androidx.transition:transition:1.4.1 i androidx.transition:transition-ktx:1.4.1 zostały udostępnione. Wersja 1.4.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Rozwiązaliśmy problem, który powodował, że uruchomienie polecenia Transition w jednym kontenerze powodowało niezamierzone wstrzymanie innych uruchomionych przejść w osobnych kontenerach, przez co te przejścia nigdy się nie zakończyły. (Aosp/1664439, b/182845041)

Wersja 1.4.0

Wersja 1.4.0

27 stycznia 2021 r.

androidx.transition:transition:1.4.0 i androidx.transition:transition-ktx:1.4.0 zostały udostępnione. Wersja 1.4.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.3.0

  • Artefakt transition-ktx wprowadza rozszerzenia Kotlin służące do dodawania detektorów do instancji w systemie AndroidX Transition. (B/138870873)

Wersja 1.4.0-rc01

Grudzień 2, 2020

Wersje androidx.transition:transition:1.4.0-rc01 i androidx.transition:transition-ktx:1.4.0-rc01 zostały zwolnione bez zmian od 1.4.0-beta01. Wersja 1.4.0-rc01 zawiera te zatwierdzenia.

Wersja 1.4.0-beta01

22 lipca 2020 r.

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

Wersja 1.4.0-alpha01

24 czerwca 2020 r.

androidx.transition:transition:1.4.0-alpha01 i androidx.transition:transition-ktx:1.4.0-alpha01 zostały udostępnione. Wersja 1.4.0-alfa01 zawiera te zatwierdzenia.

Nowe funkcje

  • Artefakt transition-ktx wprowadza rozszerzenia Kotlin służące do dodawania detektorów do instancji w systemie AndroidX Transition. (B/138870873)

Wersja 1.3.1

Wersja 1.3.1

19 lutego 2020 r.

Usługa androidx.transition:transition:1.3.1 została zwolniona. Wersja 1.3.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiono błąd polegający na tym, że niektóre animowane widoki były nieprawidłowo przycinane po użyciu funkcji ChangeTransform (b/148798452)

Wersja 1.3.0

Wersja 1.3.0

Styczeń 22, 2020

Usługa androidx.transition:transition:1.3.0 została zwolniona. Wersja 1.3.0 zawiera te zatwierdzenia.

Ważne zmiany wprowadzone od wersji 1.2.0

  • Ulepszenia dotyczące fragmentu 1.2.0: poprawiliśmy integrację z fragmentem 1.2.0, aby mieć pewność, że widok fragmentu nie zostanie zniszczony przed zakończeniem przejścia i anulowaniem przejścia w odpowiednim momencie.

Wersja 1.3.0-rc02

4 grudnia 2019

Usługa androidx.transition:transition:1.3.0-rc02 została zwolniona. Wersja 1.3.0-rc02 zawiera te zatwierdzenia.

Poprawki błędów.

  • Naprawiono błąd polegający na tym, że wyświetlenia były błędnie oznaczane jako INVISIBLE po wyświetleniu ukrytego fragmentu. (b/70793925)

Wersja 1.3.0-rc01

23 października 2019 r.

Usługa androidx.transition:transition:1.3.0-rc01 została udostępniona 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.

Usługa androidx.transition:transition:1.3.0-beta01 została zwolniona. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

Nowe funkcje

  • Poprawiliśmy integrację z fragmentem 1.2.0-beta01, aby mieć pewność, że widok fragmentu nie zostanie zniszczony przed zakończeniem przejścia i anulowaniem przejścia w odpowiednim momencie. (Aosp/1119841)

Wersja 1.2.0

Wersja 1.2.0

9 października 2019 r.

Udostępniono wersję androidx.transition:transition:1.2.0 bez zmian w wersji 1.2.0-rc01 . Wersja 1.2.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.1.0

Tej wersji należy używać, jeśli kierujesz treści na interfejs API na poziomie 29. W przeciwnym razie niektóre przejścia nie będą działać prawidłowo. Ta wersja zamiast wywołań funkcji odbicia wykorzystuje nowe metody publiczne dodane w interfejsie API na poziomie 29. Jest to część naszych ograniczeń związanych z używaniem interfejsów innych niż SDK.

Wersja 1.2.0-rc01

5 września 2019 r.

Usługa androidx.transition:transition:1.2.0-rc01 została udostępniona bez zmian od wersji 1.2.0-beta01. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Wersja 1.2.0-beta01

2 lipca 2019 r.

Usługa androidx.transition:transition:1.2.0-beta01 została zwolniona. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Nowe funkcje

  • Tej wersji należy używać, jeśli dla targetSdkVersion określasz 29. W przeciwnym razie niektóre przejścia nie będą działać prawidłowo. Ta wersja zamiast wywołań funkcji odbicia wykorzystuje nowe metody publiczne dodane w interfejsie API na poziomie 29. Jest to część naszych ograniczeń związanych z używaniem interfejsów innych niż SDK.

Wersja 1.2.0-alpha01

7 maja 2019 r.

Usługa androidx.transition:transition:1.2.0-alpha01 została zwolniona.

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. Ta wersja zamiast wywołań funkcji odbicia wykorzystuje nowe metody publiczne dodane w Q. Jest to część naszych ograniczeń związanych z używaniem interfejsów innych niż SDK.

Wersja 1.1.0

Wersja 1.1.0

2 lipca 2019 r.

Pakiet androidx.transition:transition:1.1.0 został zwolniony bez zmian w stosunku do wersji 1.1.0-rc02. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Wersja 1.1.0-rc02

5 czerwca 2019 r.

Usługa androidx.transition:transition:1.1.0-rc02 została zwolniona. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Poprawki błędów.

  • Popraw zasadę TransitionManager.endTransitions(), aby działała prawidłowo z przejściami zależnych. (Aosp/946400)

Wersja 1.1.0-rc01

7 maja 2019 r.

Usługa androidx.transition:transition:1.1.0-rc01 została zwolniona. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Wersja 1.1.0-beta01

3 kwietnia 2019 r.

Usługa androidx.transition:transition:1.1.0-beta01 została zwolniona. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Poprawki błędów.

  • Naprawiono błąd buforowania ViewGroupOverlay w Visibility, występujący w interfejsie API na poziomie 17 i niższym (aosp/937350)

Wersja 1.1.0-alfa02

13 marca 2019 r.

Usługa androidx.transition:transition:1.1.0-alpha02 została zwolniona. Pełną listę zatwierdzeń zawartych w tej wersji znajdziesz tutaj.

Zmiany interfejsu API

  • Zmieniono typ parametru metody Scene.getCurrentScene() z View na ViewGroup.

Poprawki błędów.

  • SidePropagation nie działa w przypadku dodatkowego opóźnienia: setStartDelay() (b/119839526).
  • Funkcja ChangeImageTransform stosuje niewłaściwą macierz w przypadku przerwy w działaniu przed interfejsem API 21 (b/123226255).
  • W niektórych przypadkach przed interfejsem API 21 (b/125777978) funkcja ChangeTransform działa nieprawidłowo.

Wersja 1.1.0-alpha01

3 grudnia 2018 r.

Zmiany interfejsu API

  • aosp/807055: metoda Scene.getCurrentScene(View) została udostępniona publicznie. Pozwala napisać własną logikę warunkową uzależnioną od bieżącej sceny.

Poprawki błędów.

  • Naprawiono błąd, który powodował awarię przy użyciu funkcji TransitionManager do zwijania/rozwijania elementu w RecyclerView (b/37129527).
  • Naprawiono nieprawidłową animację po zastosowaniu 2 przejść widoczności (b/62629600).
  • Zezwalaj na wartości zastępowania, takie jak czas trwania i interpolator, dla elementów podrzędnych MigrateSet (b/64644617).
  • Naprawiono wiele innych drobnych błędów.