Ta strona została przetłumaczona przez Cloud Translation API.

Przejście

Animuj ruch w interfejsie z układem początkowym i końcowym.

Najnowsza aktualizacja	Wersja stabilna	Kandydat do publikacji	Wersja Beta	Wersja alfa
17 kwietnia 2024 r.	1.4.1	1.5.0-rc02	-	-

Deklarowanie zależności

Aby dodać zależność w Przenoszeniu, musisz dodać do projektu repozytorium Google Maven. Więcej informacji znajdziesz w repozytorium Google Maven.

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

Odlotowy

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

Kotlin

dependencies {
    // Java language implementation
    implementation("androidx.transition:transition:1.4.1")
    // Kotlin
    implementation("androidx.transition:transition-ktx:1.4.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 znajdziesz nowe wydania lub masz pomysły na ulepszenie tej biblioteki. Zanim utworzysz nową bibliotekę, przejrzyj problemy z tą biblioteką. Możesz oddać głos w ramach istniejącego problemu, klikając przycisk gwiazdki.

Utwórz nowy numer

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

Wersja 1.5

Wersja 1.5.0-rc02

17 kwietnia 2024 r.

Opublikowano androidx.transition:transition:1.5.0-rc02 i androidx.transition:transition-ktx:1.5.0-rc02. 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 jeśli do transakcji, w której można było przeszukiwać wszystkie inne przejścia, został dodany niemożliwy do wyszukania element udostępniony. Dochodzi do awarii.

Wersja 1.5.0-rc01

3 kwietnia 2024 r.

Opublikowano androidx.transition:transition:1.5.0-rc01 i androidx.transition:transition-ktx:1.5.0-rc01. Wersja 1.5.0-rc01 zawiera te zatwierdzenia.

Wersja 1.5.0-beta01

20 marca 2024 r.

Opublikowano androidx.transition:transition:1.5.0-beta01 i androidx.transition:transition-ktx:1.5.0-beta01. Wersja 1.5.0-beta01 zawiera te zatwierdzenia.

Poprawki błędów

Naprawiono błąd w plikach Fragments, który powodował, że przerywanie przychodzących przejść gestem przewidywania powrotu mogło spowodować zniszczenie otwartego widoku, potencjalnie pozostawiając pusty ekran. (Id3f22, b/319531491)

Wersja 1.5.0-alfa06

10 stycznia 2024 r.

Opublikowano 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żyjesz właściwości TransitionSeekController.animateToStart(), dodane połączenie TransitionListeners będzie mieć teraz wywołanie onTransitionEnd() po określonym przez animateToStart() elemencie Runnable. (Ic6a55, b/307624554)

Aktualizacja zależności

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

Wersja 1.5.0-alfa05

29 listopada 2023 r.

Opublikowano 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

Naprawiono błąd NullPointerException spowodowany ustawieniem przejścia elementu współdzielonego i brakiem ustawienia enter/exitTransition. (I8472b)
Rozwiązanie problemu polegającego na tym, że funkcja animateToStart() z atrybutem Slide() nie przeniosła widoku z powrotem do pozycji początkowej (I698f4, b/300157785)
Naprawiono problem ponownego wystąpienia w przejściu, który przerywał anulowanie. (Iddcce, b/308379201)

Wersja 1.5.0-alfa04

4 października 2023 r.

Opublikowano 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

Breaking Change – metoda animateToStart() wykorzystuje teraz parametr Runnable, którego należy użyć do przywrócenia przenoszonych widoków do ich pierwotnego stanu.

Wersja 1.5.0-alfa03

20 września 2023 r.

Opublikowano 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

Przejście zapewnia teraz obsługę animacji przewidywanego przejścia wstecz w aplikacji na urządzeniach z Androidem 14 w połączeniu z fragmentem 1.7.0-alpha05.

Poprawki błędów

Usunięto błąd przerwy w przejściu slajdu. Gdy przejście slajdu zostało przerwane w celu usunięcia widoku, przeskoczyło w niewłaściwe miejsce. (I946f8, b/297427333)

Wersja 1.5.0-alfa02

6 września 2023 r.

Opublikowano 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 ustawianie postępu jako ułamka całkowitego czasu trwania w setCurrentFragment(). (Aosp/2647607)
TransitionSeekController umożliwia teraz obserwowanie postępów podczas korzystania z usług animateToStart() i animateToEnd() przez wywołanie addOnProgressChangedListener. (Aosp/2647607)
Dodano TransitionManager.seekTo(), aby umożliwić używanie scen do przewijania przejść. (Aosp/2647607)
Do przewijania przejść dodaliśmy animacje oparte na fizyce. Wykorzystuje 1-D tracker do śledzenia zmiany postępu za pomocą setCurrentFraction() lub setCurrentPlayTimeMillis() i używa go do określenia prędkości początkowej animateToStart i animateToEnd. (Aosp/2647607)

Poprawki błędów

Naprawiono migotanie podczas przewijania elementu AutoTransition. (Aosp/2643369)
Rozwiązaliśmy problem, który powodował, że po przerwaniu przejście Slide przeskakiwało do niewłaściwej pozycji początkowej. (Aosp/2733729, b/297427333)

Aktualizacja zależności

Przejście kompiluje się teraz z interfejsem API 34.

Wersja 1.5.0-alfa01

10 maja 2023 r.

Opublikowano androidx.transition:transition:1.5.0-alpha01 i androidx.transition:transition-ktx:1.5.0-alpha01. Ta wersja została opracowana w gałęzi wewnętrznej.

Nowe funkcje

Przenoszenie obsługuje wyszukiwanie w interfejsie API 34 i nowszych. Do interfejsu TransitionManager controlDelayedTransition() dodano nowy interfejs API, który zwraca wartość TransisionSeekController umożliwiającą przewijanie.

Zmiany w interfejsie API

W interfejsie TransitionManager pojawiła się nowa metoda: controlDelayedTransition(), która umożliwia aplikacjom kontrolowanie postępu animacji przejścia w interfejsie API w wersji 34 lub nowszej. Zwrócony atrybut TransitionSeekController informuje dewelopera, że przejście jest gotowe do wyszukiwania, oraz jak długo trwa animacja. Umożliwia też ustawienie bieżącego czasu animacji. controlDelayedTransition() obsługuje tylko przejścia, które zastępują isSeekable() w celu zwrócenia wartości prawda.
Przejścia używają nowej metody getRootTransition(), która zwraca przejście zawierające bieżące lub bieżące przejście, jeśli nie zawiera go żadne inne przejście. Jest to przydatne, jeśli deweloper potrzebuje detektorów określających początek i koniec całego przejścia.
W TransitionListeners są teraz nowe detektory onTransitionStart() i onTransitionEnd(), które pozwalają deweloperowi określić, czy przenoszenie się rozpoczyna, czy też kończy. Może to być istotne przy opracowywaniu możliwych do wyszukania przejść, w których występuje TransitionListeners.

Poprawki błędów

Podczas klonowania przejścia kopiowane są teraz TransitionListeners. Oznacza to, że dodanie nowych detektorów w czasie createAnimator() nie będzie miało wpływu na przejście główne.

Wersja 1.4.1

21 kwietnia 2021 r.

Opublikowano 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 uruchomienie komponentu Transition w jednym kontenerze powodowało niezamierzone wstrzymywanie innych uruchomionych przejść w oddzielnych kontenerach, przez co procesy te nigdy się nie kończyły. (Aosp/1664439, b/182845041)

Wersja 1.4.0

27 stycznia 2021 r.

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

Ważne zmiany od wersji 1.3.0

Artefakt transition-ktx wprowadza rozszerzenia Kotlin umożliwiające dodawanie detektorów do wystąpień systemu 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 opublikowane bez zmian z 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 są dostępne bez zmian od 1.4.0-alpha01. Wersja 1.4.0-beta01 zawiera te zatwierdzenia.

Wersja 1.4.0-alfa01

24 czerwca 2020 r.

Opublikowano 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 umożliwiające dodawanie detektorów do wystąpień systemu AndroidX Transition. (b/138870873)

Wersja 1.3.1

19 lutego 2020 r.

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

Poprawki błędów

Naprawiono błąd, który powodował, że niektóre widoki animowane były nieprawidłowo przycinane podczas korzystania z funkcji ChangeTransform (b/148798452)

Wersja 1.3.0

22 stycznia 2020 r.

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

Ważne zmiany od wersji 1.2.0

Ulepszenia dotyczące fragmentu kodu w wersji 1.2.0: poprawiliśmy integrację z fragmentem kodu w wersji 1.2.0, by widok fragmentu nie został zniszczony przed zakończeniem przenoszenia oraz że przejścia były anulowane w odpowiednim momencie.

Wersja 1.3.0-rc02

4 grudnia 2019

Aplikacja 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, przez który wyświetlenia były błędnie oznaczane jako INVISIBLE po wycięciu ukrytego fragmentu. (b/70793925)

Wersja 1.3.0-rc01

23 października 2019 r.

Wersja 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.

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

Nowe funkcje

Ulepszyliśmy integrację z fragmentem 1.2.0-beta01, aby widok fragmentu nie został zniszczony przed zakończeniem przenoszenia i przejścia były anulowane w odpowiednim momencie. (Aosp/1119841)

Wersja 1.2.0

9 października 2019 r.

Wersja androidx.transition:transition:1.2.0 została udostępniona bez zmian z wersji 1.2.0-rc01 . Wersja 1.2.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.1.0

Używaj tej wersji, jeśli kierujesz reklamy na poziom API 29. W przeciwnym razie niektóre przejścia nie będą działać prawidłowo. Zamiast wywołań odczuć ta wersja korzysta z nowych metod publicznych dodanych w interfejsie API na poziomie 29. Jest to jedna z naszych ograniczeń dotyczących interfejsów innych niż SDK.

Wersja 1.2.0-rc01

5 września 2019 r.

Aplikacja androidx.transition:transition:1.2.0-rc01 została opublikowana bez zmian od wersji 1.2.0-beta01. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Wersja 1.2.0-beta01

2 lipca 2019 r.

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

Nowe funkcje

Użyj tej wersji, jeśli jako targetSdkVersion podasz 29. W przeciwnym razie niektóre przejścia nie będą działać prawidłowo. Zamiast wywołań odczuć ta wersja korzysta z nowych metod publicznych dodanych w interfejsie API na poziomie 29. Jest to jedna z naszych ograniczeń dotyczących interfejsów innych niż SDK.

Wersja 1.2.0-alfa01

7 maja 2019 r.

Aplikacja androidx.transition:transition:1.2.0-alpha01 została zwolniona.

Nowe funkcje

Użyj tej wersji, jeśli określasz Q jako targetSdkVersion. W przeciwnym razie niektóre przejścia nie będą działać prawidłowo. Zamiast wywołań odczuć ta wersja korzysta z nowych metod publicznych dodanych w Q. Jest to jedna z naszych ograniczeń dotyczących interfejsów innych niż SDK.

Wersja 1.1.0

2 lipca 2019 r.

Opublikowano androidx.transition:transition:1.1.0 bez zmian z 1.1.0-rc02. Zatwierdzenia zawarte w tej wersji znajdziesz tutaj.

Wersja 1.1.0-rc02

5 czerwca 2019 r.

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

Poprawki błędów

Popraw błąd TransitionManager.endTransitions(), aby prawidłowo działał z zależnymi przejściami. (Aosp/946400)

Wersja 1.1.0-rc01

7 maja 2019 r.

Aplikacja 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.

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

Poprawki błędów

Naprawiono błąd pamięci podręcznej ViewGroupOverlay w interfejsie Visibility, który występował na poziomie API 17 i niższym (aosp/937350).

Wersja 1.1.0-alfa02

13 marca 2019 r.

Aplikacja androidx.transition:transition:1.1.0-alpha02 została zwolniona. Pełną listę zatwierdzeń 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

Funkcja SidePropagation nie działa, gdy dodatkowe opóźnienie jest podane przez setStartDelay() (b/119839526).
ChangeImageTransform stosuje nieprawidłową macierz po przerwaniu przed interfejsem API 21 (b/123226255).
ChangeTransform w niektórych przypadkach działa nieprawidłowo przed interfejsem API 21 (b/125777978).

Wersja 1.1.0-alfa01

3 grudnia 2018 r.

Zmiany w interfejsie API

aosp/807055: metoda Scene.getCurrentScene(View) została udostępniona publicznie. Pozwala napisać niestandardową logikę warunkową w zależności od bieżącej sceny.

Poprawki błędów

Naprawiono awarię, która występowała podczas używania funkcji TransitionManager do zwijania/rozwijania elementu w komponencie RecyclerView (b/37129527).
Naprawiono nieprawidłową animację po zastosowaniu dwóch przejść widoczności (b/62629600).
Zezwalaj na zastępowanie wartości takich jak czas trwania i interpolator w elementach podrzędnych PrzejścieSet (b/64644617).
Naprawiono wiele innych drobnych błędów.