Back to Repositories

Testing LottieDrawable Animation Control and Frame Management in lottie-android

The LottieDrawableTest suite validates core functionality of Lottie’s animation drawable component in Android. This comprehensive test suite ensures proper frame handling, animation control, and system animation state management for the Lottie animation library.

Test Coverage Overview

The test suite provides extensive coverage of LottieDrawable’s frame management and animation control capabilities.

Frame boundary testing for minimum and maximum animation frames
Progress-based frame calculations
System animation state handling
Animation lifecycle management with disabled system animations

Implementation Analysis

Tests utilize JUnit and Mockito frameworks to validate LottieDrawable behavior. The implementation employs mock animation listeners and composition factories to isolate test scenarios.

Mock-based animation event verification
Composition initialization with controlled parameters
Systematic validation of frame calculations

Technical Details

JUnit 4 test framework
Mockito for animation listener mocking
Custom composition factory for test scenarios
AndroidX collection utilities
Frame calculation precision testing

Best Practices Demonstrated

The test suite exemplifies robust testing practices for Android animation components.

Isolated test cases with proper setup/teardown
Comprehensive edge case coverage
Mock-based event verification
Precise floating-point comparisons
Systematic state management testing

airbnb/lottie-android

lottie/src/test/java/com/airbnb/lottie/LottieDrawableTest.java

            
package com.airbnb.lottie;

import android.animation.Animator;
import android.graphics.Rect;
import androidx.collection.LongSparseArray;
import androidx.collection.SparseArrayCompat;
import com.airbnb.lottie.configurations.reducemotion.ReducedMotionMode;

import org.junit.Before;
import org.junit.Test;
import org.mockito.Mock;
import org.mockito.MockitoAnnotations;

import java.util.ArrayList;
import java.util.HashMap;

import static junit.framework.Assert.assertEquals;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.atLeastOnce;
import static org.mockito.Mockito.verify;

public class LottieDrawableTest extends BaseTest {

  @Mock Animator.AnimatorListener animatorListener;

  @Before
  public void setup() {
    MockitoAnnotations.initMocks(this);
  }

  @SuppressWarnings("SameParameterValue")
  private LottieComposition createComposition(int startFrame, int endFrame) {
    LottieComposition composition = new LottieComposition();
    composition.init(new Rect(), startFrame, endFrame, 1000, new ArrayList<>(),
        new LongSparseArray<>(0), new HashMap<>(0),
        new HashMap<>(0), 1f, new SparseArrayCompat<>(0),
        new HashMap<>(0), new ArrayList<>(), 0, 0);
    return composition;
  }

  @Test
  public void testMinFrame() {
    LottieComposition composition = createComposition(31, 391);
    LottieDrawable drawable = new LottieDrawable();
    drawable.setComposition(composition);
    drawable.setMinProgress(0.42f);
    assertEquals(182f, drawable.getMinFrame());
  }

  @Test
  public void testMinWithStartFrameFrame() {
    LottieComposition composition = createComposition(100, 200);
    LottieDrawable drawable = new LottieDrawable();
    drawable.setComposition(composition);
    drawable.setMinProgress(0.5f);
    assertEquals(150f, drawable.getMinFrame());
  }

  @Test
  public void testMaxFrame() {
    LottieComposition composition = createComposition(31, 391);
    LottieDrawable drawable = new LottieDrawable();
    drawable.setComposition(composition);
    drawable.setMaxProgress(0.25f);
    assertEquals(121f, drawable.getMaxFrame());
  }

  @Test
  public void testMinMaxFrame() {
    LottieComposition composition = createComposition(31, 391);
    LottieDrawable drawable = new LottieDrawable();
    drawable.setComposition(composition);
    drawable.setMinAndMaxProgress(0.25f, 0.42f);
    assertEquals(121f, drawable.getMinFrame());
    assertEquals(182.99f, drawable.getMaxFrame());
  }

  @Test
  public void testPlayWhenSystemAnimationDisabled() {
    disableSystemAnimation();
    LottieComposition composition = createComposition(31, 391);
    LottieDrawable drawable = new LottieDrawable();
    drawable.addAnimatorListener(animatorListener);
    drawable.setSystemAnimationsAreEnabled(false);
    drawable.setComposition(composition);
    drawable.playAnimation();
    assertEquals(391, drawable.getFrame());
    verify(animatorListener, atLeastOnce()).onAnimationEnd(any(Animator.class), eq(false));
  }

  @Test
  public void testResumeWhenSystemAnimationDisabled() {
    LottieComposition composition = createComposition(31, 391);
    LottieDrawable drawable = new LottieDrawable();
    drawable.addAnimatorListener(animatorListener);
    drawable.setSystemAnimationsAreEnabled(false);
    drawable.setComposition(composition);
    drawable.resumeAnimation();
    assertEquals(391, drawable.getFrame());
    verify(animatorListener, atLeastOnce()).onAnimationEnd(any(Animator.class), eq(false));
  }

  @Test
  public void testPlayWhenSystemAnimationDisabledFromLottieConfig() {
    disableSystemAnimation();
    LottieComposition composition = createComposition(31, 391);
    LottieDrawable drawable = new LottieDrawable();
    drawable.addAnimatorListener(animatorListener);
    drawable.setComposition(composition);
    drawable.playAnimation();
    assertEquals(391, drawable.getFrame());
    verify(animatorListener, atLeastOnce()).onAnimationEnd(any(Animator.class), eq(false));
  }

  @Test
  public void testResumeWhenSystemAnimationDisabledFromLottieConfig() {
    disableSystemAnimation();
    LottieComposition composition = createComposition(31, 391);
    LottieDrawable drawable = new LottieDrawable();
    drawable.addAnimatorListener(animatorListener);
    drawable.setComposition(composition);
    drawable.resumeAnimation();
    assertEquals(391, drawable.getFrame());
    verify(animatorListener, atLeastOnce()).onAnimationEnd(any(Animator.class), eq(false));
  }

  private void disableSystemAnimation() {
    Lottie.initialize(new LottieConfig.Builder().setReducedMotionOption(
        context -> ReducedMotionMode.REDUCED_MOTION
    ).build());
  }
}