MaterialTapTargetPrompt

Features

• Added showFor to show prompt for a time limit

Bug Fixes

• Fixed UnsupportedOperationException caused by clipping to path in Android SDK < 18 #101

Features

• Added getPath to PromptFocal to get the clip path for the prompt focal (#99)
• Transparent focal colour is now supported and no longer renders black (#99)

Bug Fixes

• Fixed prompt not updating correctly when target view moves #95

Bug Fixes

• Reverted changes that fixed prompt positioning not updating correctly when the target moves but caused the background to not be shown

Features

• Added nullable annotations #92
• Added Android SDK 27 support #91

Bug Fixes

• Fixed prompt not updating correctly when target view moves

Bug Fixes

• Fixed invalid state when attempting to show prompt that is dismissing #89

Features

• Added Prompt.getState() to get the current prompt state. #87
• Added prompt state STATE_NOT_SHOWN for the base state before prompt is shown. #87

Bug Fixes

• Fixed null pointer exception when attempting to dismiss prompt before it has been shown. #87

Features

• Added fullscreen prompt background. #85

Features

• Added PromptBackground, PromptFocal and PromptText to enable overriding the default implementation.
• Added RectanglePromptBackground, RectanglePromptFocal, CirclePromptBackground and CirclePromptFocal background and focal implementations.
• Added PromptOptions class as base for Builder class.

Other

• Expanded unit testing.

Features

• Added support for primary and secondary text being CharSequence. (#82)
• Added STATE_FINISHING for state change after the finish method has been called.
• Added STATE_NON_FOCAL_PRESSED for state change after the user has pressed the prompt somewhere other than the target or the system back button has been pressed.

Bug Fixes

• Fixed STATE_DISMISSING state change incorrectly occurring when auto dismiss is disabled. Fixes null pointer exception in sample. (#82)

Bug Fixes

• Fix user being unable to leave Activity with back button if setAutoDismiss(false) #81

• Minimum sdk is now 14.
• Back button dismiss is now enabled by default.

Bug Fixes

• Attributes are prefixed with mttp to be compatible with API 26.

Removed

• ResourceFinder.getWindow()
• OnHidePromptListener - Replaced with PromptStateChangeListener.
• OnHidePromptListener.onHidePrompt - Replaced with PromptStateChangeListener(MaterialTapTargetPrompt prompt, boolean state) where the state is either MaterialTapTargetPrompt.STATE_DISMISSING or MaterialTapTargetPrompt.STATE_FOCAL_PRESSED.
• OnHidePromptListener.onHidePromptComplete - Replaced with PromptStateChangeListener(MaterialTapTargetPrompt prompt, boolean state) where the state is either MaterialTapTargetPrompt.STATE_DISMISSED or MaterialTapTargetPrompt.STATE_FINISHED.
• builder.setBackgroundColourAlpha - Alpha is taken from builder.setBackgroundColour(int)
• builder.setBackgroundColourFromRes(int) - Use a constructor with a theme for example Builder(Activity, int)
• builder.setFocalColourAlpha(int) - Alpha value is taken from builder.setFocalColour(int)
• builder.setFocalColourFromRes(int) - Use a constructor with a theme for example Builder(Activity, int)
• builder.setFocalToTextPadding(float) - Renamed to setFocalPadding(float)
• builder.setFocalToTextPadding(int) - Rename to setFocalPadding(int)
• builder.setIconDrawableColourFilterFromRes(int) - Use a constructor with a theme for example Builder(Activity, int)
• builder.setOnHidePromptListener(MaterialTapTargetPrompt.OnHidePromptListener - Replaced with builder.setPromptStateChangeListener(PromptStateChangeListener)
• builder.setPrimaryTextColourFromRes(int) - Use a constructor with a theme for example Builder(Activity, int)
• builder.setSecondaryTextColourFromRes(int) - Use a constructor with a theme for example Builder(Activity, int)

Bug Fixes

• Fixed prompt not working with window app bar

Bug Fixes

• Fixed incorrect positioning of prompt when target view gets removed from window.

Deprecated

• ResourceFinder.getWindow() no longer required, will be removed in v2.0.0

Features

• Added setBackButtonDismissEnabled(boolean) to allow the system back button to dismiss the prompt.
• Added bottom sheet dialog fragment example.
• Added PromptStateChangeListener to listen for prompt being shown and hidden. Possible states are:
• STATE_REVEALING - Prompt reveal animation is running.
• STATE_REVEALED - Prompt reveal animation has finished and the prompt is displayed.
• STATE_FOCAL_PRESSED - The prompt target has been pressed.
• STATE_FINISHED - The prompt has been removed from view after the prompt target has been pressed.
• STATE_DISMISSING - The prompt has been pressed somewhere other than the prompt target or the system back button has been pressed.
• STATE_DISMISSED - The prompt has been removed from view after the prompt has either been pressed somewhere other than the prompt target or the system back button has been pressed.
• Replaced dependency on Activity with ResourceFinder interface. Now uses ActivityResourceFinder or DialogResourceFinder.
• Primary text is no longer required, either primary or secondary text must be set.

Bug Fixes

• Fixed prompt not working correctly with dialogs by using DialogResourceFinder.

Deprecated

• OnHidePromptListener - Replaced with PromptStateChangeListener.
• OnHidePromptListener.onHidePrompt - Replaced with PromptStateChangeListener(MaterialTapTargetPrompt prompt, boolean state) where the state is either MaterialTapTargetPrompt.STATE_DISMISSING or MaterialTapTargetPrompt.STATE_FOCAL_PRESSED.
• OnHidePromptListener.onHidePromptComplete - Replaced with PromptStateChangeListener(MaterialTapTargetPrompt prompt, boolean state) where the state is either MaterialTapTargetPrompt.STATE_DISMISSED or MaterialTapTargetPrompt.STATE_FINISHED.
• builder.setBackgroundColourAlpha - Alpha value will be taken from builder.setBackgroundColour(int) in v2.0.0
• builder.setBackgroundColourFromRes(int) - Will be removed in v2.0.0, use a constructor with a theme for example Builder(Activity, int)
• builder.setFocalColourAlpha(int) - Alpha value will be taken from builder.setFocalColour(int) in v2.0.0
• builder.setFocalColourFromRes(int) - Will be removed in v2.0.0, use a constructor with a theme for example Builder(Activity, int)
• builder.setFocalToTextPadding(float) - Renamed to setFocalPadding(float)
• builder.setFocalToTextPadding(int) - Rename to setFocalPadding(int)
• builder.setIconDrawableColourFilterFromRes(int) - Will be removed in v2.0.0, use a constructor with a theme for example Builder(Activity, int)
• builder.setOnHidePromptListener(MaterialTapTargetPrompt.OnHidePromptListener - Replaced with builder.setPromptStateChangeListener(PromptStateChangeListener)
• builder.setPrimaryTextColourFromRes(int) - Will be removed in v2.0.0, use a constructor with a theme for example Builder(Activity, int)
• builder.setSecondaryTextColourFromRes(int) - Will be removed in v2.0.0, use a constructor with a theme for example Builder(Activity, int)

Features

• Added id to prompt view

Bug Fixes

• Fixed null text causing crash when layout direction is right to left

Bug Fixes

• Fixed right to left text positioning

Other

• Improved text and background positioning calculations
• Added side nav target example

Bug Fixes

• Fixed right to left text drawing outside the background