Trackr Android App
Note: Trackr uses version 7 of Gradle, which currently requires Android Studio Beta or Canary.
Trackr is a sample task management app used to explore common UI patterns from the perspective of supporting accessibility. Trackr is currently under development.
Using Trackr, end users can discover, create, and edit tasks; they can assign tasks to team members and they can associate different tags with each task. Users can archive a task by swiping right and they can modify a task's priority by dragging it up or down.
Developers are encouraged to explore Trackr using an accessibility service like Talkback or Switch Access; developers are also encouraged to try out the various accessibility settings found on their devices (see Settings > Accessibility on most Android phones) when using Trackr. If you have any suggestions, please create an issue (see below).
Trackr is designed with the goal of allowing all users to enjoy its core functionality, including users with disabilities who may interact with their devices using accessibility services. So, for example, while blind and low vision users or users with manual dexterity issues may not be able to perform the swipe gesture to archive an item or drag and drop items to reorder their priority, they should nonetheless be able to access the archive and reorder functionality through the accessibility service they are using.
APIs showcased
The following accessibility APIs (non exhaustive list) are showcased in this sample:
ViewCompat#addAccessibilityAction(): to surface functionality like swipe-to-archive, drag and drop, etc.
ViewCompat#performAccessiblityAction(): used in testing.
ViewCompat#replaceAccessibilityAction(): used to customize the label for associated with an action.
ViewCompat.setStateDescription(): used to specify state associated with a view.
AccessibilityManager#getRecommendedTimeoutMillis(): used to specify the timeout for ephemeral content.
Getting Started
This project uses the Gradle build system. To build this project, use the gradlew build
command or use "Import Project" in Android Studio.
To run tests, run gradlew test
To learn more about Android accessibility, visit the Android accessibility page. To learn more about developer facing aspects of Android accessibility, read the accessibility developer guide.
Screenshots
{width=240px} {width=240px} {width=240px}
Issues
We are continuously working to improve this sample and add new features. If you have suggestions for improvement or if you encounter a problem, please provide feedback to us via the issue tracker. When creating an issue, try to include the following:
- The device manufacturer and model
- The Android build running on the device
- If using an accessibility service (for example a screen reader), the name and version number of that service
- A description of the issue; include screenshots/screencaps if you think they'll help us understand the problem
License
Copyright 2021 Google, Inc.
Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.