Slide 1

Slide 1 text

Android accessibility

Slide 2

Slide 2 text

Accessibility /ˈapps for everybody/ Android apps that are usable by everyone. Make no assumptions about the user.

Slide 3

Slide 3 text

AppFoundry appfoundry.be

Slide 4

Slide 4 text

No content

Slide 5

Slide 5 text

No content

Slide 6

Slide 6 text

No content

Slide 7

Slide 7 text

Why?

Slide 8

Slide 8 text

Assumptions Sight See the screen Mobility Touch the screen Audio Hear Speech Interact

Slide 9

Slide 9 text

Accessibility? 2 % visual impairment 8 % men color blind 0,1 % blind 8 out of 10 with visual impairment or blindness are older than 65

Slide 10

Slide 10 text

Accessibility? up to 20 % motor impairment Permanent Parkinson’s Tremor … Situational Injury … Hands busy

Slide 11

Slide 11 text

Accessibility services Talkback Screen reader Brailleback Braille display Switch Access Control by switch Voice Access Interact

Slide 12

Slide 12 text

Brailleback

Slide 13

Slide 13 text

Switch Access

Slide 14

Slide 14 text

Voice access Voice Assistant High-level voice commands Accessibility Low-level commands Device control Scrolling, clicking, text editing

Slide 15

Slide 15 text

Android - iOS

Slide 16

Slide 16 text

Improve user experience for accessibility

Slide 17

Slide 17 text

Color blindness Normal vision Deuteranopia Protanopia Tritanopia

Slide 18

Slide 18 text

Contrast

Slide 19

Slide 19 text

Color correction Accessibility options Color simulation Developer options

Slide 20

Slide 20 text

Color contrast WCAG : background - foreground : 4.5 contrast ratio

Slide 21

Slide 21 text

Android Accessibility features Large Text Magnification Gestures High Contrast Text Color inversion Color correction Caption support App developer Text size = sp Layouts = responsive

Slide 22

Slide 22 text

No content

Slide 23

Slide 23 text

Content description

Slide 24

Slide 24 text

Content description

Slide 25

Slide 25 text

Meaningful image

Slide 26

Slide 26 text

Meaningful image

Slide 27

Slide 27 text

Decorative image

Slide 28

Slide 28 text

Decorative image

Slide 29

Slide 29 text

Content description

Slide 30

Slide 30 text

Content description

Slide 31

Slide 31 text

States public void setIconAccessibilityText(boolean isFavorite, String teamName) {
 favoriteTeamMenuItem.setTitle(
 isFavorite ?
 ”defavoritise {teamName}” :
 ”mark {teamName} as favorite”;
 }

Slide 32

Slide 32 text

AccessibilityLiveRegion

Slide 33

Slide 33 text

AccessibilityLiveRegion

Slide 34

Slide 34 text

AnnounceForAccessibility private void makeViewVisible() {
 view.setVisibility(View.VISIBLE);
 view.announceForAccessibility(getString(R.string.acc));
 }

Slide 35

Slide 35 text

AnnounceForAccessibility private void makeViewVisible() {
 view.setVisibility(View.VISIBLE);
 view.announceForAccessibility(getString(R.string.acc));
 }

Slide 36

Slide 36 text

AnnounceForAccessibility private void setFavoriteListener(final Team team, final boolean isFavorite) {
 view.setOnClickListener(new View.OnClickListener() {
 
 @Override
 public void onClick(View v) {
 teamListener.onTeamClicked(team);
 String announcement = isFavorite
 ? "Removed " + team.displayTitle() + " from favourites"
 : "Added " + team.displayTitle() + " to favourites";
 view.announceForAccessibility(announcement);
 }
 
 });
 }

Slide 37

Slide 37 text

AnnounceForAccessibility private void setFavoriteListener(final Team team, final boolean isFavorite) {
 view.setOnClickListener(new View.OnClickListener() {
 
 @Override
 public void onClick(View v) {
 teamListener.onTeamClicked(team);
 String announcement = isFavorite
 ? "Removed " + team.displayTitle() + " from favourites"
 : "Added " + team.displayTitle() + " to favourites";
 view.announceForAccessibility(announcement);
 }
 
 });
 }

Slide 38

Slide 38 text

Control focus order 
 
 
 
 


Slide 39

Slide 39 text

Control focus order 
 
 
 
 


Slide 40

Slide 40 text

Filter / change if necessary

Slide 41

Slide 41 text

Ads ☹ No Ads Accessibility services detected

Slide 42

Slide 42 text

Talkback detection public boolean isAccessibilityEnabled() { 
 final AccessibilityManager am = (AccessibilityManager) context.getSystemService(Context.ACCESSIBILITY_SERVICE); 
 boolean isAccessibilityEnabled = am.isEnabled();
 boolean isExploreByTouchEnabled = am.isTouchExplorationEnabled(); 
 return isAccessibilityEnabled && isExploreByTouchEnabled;
 }

Slide 43

Slide 43 text

Talkback detection public boolean isAccessibilityEnabled() {
 final AccessibilityManager am = (AccessibilityManager) context.getSystemService(Context.ACCESSIBILITY_SERVICE); 
 boolean isAccessibilityEnabled = am.isEnabled();
 boolean isExploreByTouchEnabled = am.isTouchExplorationEnabled(); 
 boolean isSpokenFeedbackEnabled = isSpokenFeedbackEnabled(am);
 return isAccessibilityEnabled && isExploreByTouchEnabled && isSpokenFeedbackEnabled;
 } 
 
 /**
 * Check whether 'spoken feedback' services are enabled.
 */
 private boolean isSpokenFeedbackEnabled(final AccessibilityManager am) {
 List enabledSpokenFeedbackServices = am.getEnabledAccessibilityServiceList(AccessibilityServiceInfo.FEEDBACK_SPOKEN); 
 return !enabledSpokenFeedbackServices.isEmpty();
 }

Slide 44

Slide 44 text

Content description good / meaningful texts

Slide 45

Slide 45 text

Meaningful description private void setAccessibilityText(final TeamInfo teamInfo) {
 String accessibilityText;
 if (teamInfo.coaches().isEmpty()) {
 accessibilityText = getString(R.string.no_trainer_acc, teamInfo.teamName());
 } else {
 List trainerNames = getTrainerNames(teamInfo.coaches());
 
 Joiner joiner = Joiner.on(andStr).skipNulls();
 String concatTrainers = joiner.join(trainerNames);
 accessibilityText = getQuantityString(R.plurals.trainer_acc, teamInfo.coaches().size(), teamInfo.teamName(), concatTrainers);
 }
 
 getItemView().setContentDescription(accessibilityText);
 }

Slide 46

Slide 46 text

Help from your backend

Slide 47

Slide 47 text

No content

Slide 48

Slide 48 text

No content

Slide 49

Slide 49 text

Custom views

Slide 50

Slide 50 text

Custom actions

Slide 51

Slide 51 text

MatchView public interface MatchListener {
 
 void onMatchClicked(Match match);
 
 void onMatchComment(Match match);
 
 void onMatchShare(Match match);
 
 void onMatchLiked(Match match);
 }

Slide 52

Slide 52 text

No content

Slide 53

Slide 53 text

Don’t descend into view android:importantForAccessibility="noHideDescendants"

Slide 54

Slide 54 text

DIY public void showMatch(final Match match, final MatchListener listener) {
 …
 
 setOnClickListener(new View.OnClickListener() {
 @Override
 public void onClick(View view) {
 if (isAccessibilityEnabled) {
 showCustomActions(match);
 } else {
 listener.onMatchClicked(match);
 }
 }
 });

Slide 55

Slide 55 text

No content

Slide 56

Slide 56 text

No content

Slide 57

Slide 57 text

Accessibility delegate public static class MatchAccessibilityDelegate extends AccessibilityDelegateCompat {
 
 private final Match match;
 private final MatchListener listener;
 
 public MatchAccessibilityDelegate(final Match match, final MatchListener listener) {
 this.match = match;
 this.listener = listener;
 }
 
 @Override
 public void onInitializeAccessibilityNodeInfo(View host, AccessibilityNodeInfoCompat info) {
 super.onInitializeAccessibilityNodeInfo(host, info);
 info.addAction(new AccessibilityNodeInfoCompat.AccessibilityActionCompat(R.id.comment, "Comment"));
 info.addAction(new AccessibilityNodeInfoCompat.AccessibilityActionCompat(R.id.share, "Share"));
 …
 }
 
 @Override
 public boolean performAccessibilityAction(View host, int action, Bundle args) {
 switch (action) {
 case R.id.comment:
 listener.onMatchComment(match);
 return true;
 case R.id.share:
 listener.onMatchShare(match);
 return true;
 …
 return true;


Slide 58

Slide 58 text

Accessibility delegate public static class MatchAccessibilityDelegate extends AccessibilityDelegateCompat {
 
 private final Match match;
 private final MatchListener listener;
 
 public MatchAccessibilityDelegate(final Match match, final MatchListener listener) {
 this.match = match;
 this.listener = listener;
 }
 
 @Override
 public void onInitializeAccessibilityNodeInfo(View host, AccessibilityNodeInfoCompat info) {
 super.onInitializeAccessibilityNodeInfo(host, info);
 info.addAction(new AccessibilityNodeInfoCompat.AccessibilityActionCompat(R.id.comment, "Comment"));
 info.addAction(new AccessibilityNodeInfoCompat.AccessibilityActionCompat(R.id.share, "Share"));
 …
 }
 
 @Override
 public boolean performAccessibilityAction(View host, int action, Bundle args) {
 switch (action) {
 case R.id.comment:
 listener.onMatchComment(match);
 return true;
 case R.id.share:
 listener.onMatchShare(match);
 return true;
 …


Slide 59

Slide 59 text

Accessibility delegate public void showMatch(final Match match, final MatchListener listener) {
 …
 
 ViewCompat.setAccessibilityDelegate(this, new MatchAccessibilityDelegate(match, listener));
 
 …

Slide 60

Slide 60 text

No content

Slide 61

Slide 61 text

Testing

Slide 62

Slide 62 text

Manual testing

Slide 63

Slide 63 text

No content

Slide 64

Slide 64 text

Talkback basics Touch to explore Advance through elements (swipe left - right) Double tap selection Gestures for Back, Home, Context menus, …

Slide 65

Slide 65 text

Accessibility scanner

Slide 66

Slide 66 text

No content

Slide 67

Slide 67 text

No content

Slide 68

Slide 68 text

No content

Slide 69

Slide 69 text

No content

Slide 70

Slide 70 text

No content

Slide 71

Slide 71 text

Code scanning (Lint)

Slide 72

Slide 72 text

No content

Slide 73

Slide 73 text

No content

Slide 74

Slide 74 text

Lint rules lintOptions { abortOnError true }

Slide 75

Slide 75 text

Instrumentation tests

Slide 76

Slide 76 text

Espresso - Accessibility @Test
 public void testPlayStopButtonContentDescription() {
 final ViewInteraction playButtonInteraction = onView(withId(R.id.play_button));
 playButtonInteraction.check(matches(withContentDescription("Play")));
 
 playButtonInteraction.perform(click());
 playButtonInteraction.check(matches(withContentDescription("Stop")));
 }

Slide 77

Slide 77 text

Espresso - Accessibility androidTestCompile 'com.android.support.test.espresso:espresso-contrib:2.2.2' @Before
 public void setUp() {
 AccessibilityChecks.enable();
 }

Slide 78

Slide 78 text

No content

Slide 79

Slide 79 text

Accessibility checks com..…AccessibilityViewCheckException: There were 2 accessibility errors: AppCompatImageButton{id=2131427416, res-name=imageButton1, visibility=VISIBLE, width=144, height=132, has- focus=true, has-focusable=true, has-window-focus=false, is-clickable=true, is-enabled=true, is- focused=true, is-focusable=true, is-layout-requested=false, is-selected=false, root-is-layout- requested=false, has-input-connection=false, x=48.0, y=48.0}: View falls below the minimum recommended size for touch targets. Minimum touch target size is 48x48dp. Actual size is 48.0x44.0dp (screen density is 3.0)., AppCompatImageButton{id=2131427416, res-name=imageButton1, visibility=VISIBLE, width=144, height=132, has- focus=true, has-focusable=true, has-window-focus=false, is-clickable=true, is-enabled=true, is- focused=true, is-focusable=true, is-layout-requested=false, is-selected=false, root-is-layout- requested=false, has-input-connection=false, x=48.0, y=48.0}: View is missing speakable text needed for a screen reader at … at android.support.test.espresso.contrib.AccessibilityChecks$2.check(AccessibilityChecks.java:58) at android.support.test.espresso.action.ViewActions$1.perform(ViewActions.java:131) … at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:616)

Slide 80

Slide 80 text

Android Testing Support Library https://developer.android.com/guide/topics/ui/accessibility

Slide 81

Slide 81 text

Sample github.com/filipmaelbrancke/AndroidAccessibility Accessibility sample Sample used in this presentation: Custom Actions Espresso Test

Slide 82

Slide 82 text

Resources Accessibility Testing Checklist https://developer.android.com/training/accessibility/testing.html Google’s Accessibility Test Framework github.com/google/Accessibility-Test-Framework-for-Android Espresso Accessibility Checking google.github.io/android-testing-support-library/docs/accesibility-checking/ Talkback Gestures support.google.com/accessibility/android/answer/6151827?hl=en

Slide 83

Slide 83 text

+ accessibility + accessibility

Slide 84

Slide 84 text

No content

Slide 85

Slide 85 text

Questions? Filip Maelbrancke Consultant @ AppFoundry fi[email protected] @fmaelbrancke