Git Product home page Git Product logo

trackr's Introduction

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

Home Screen TalkBack Detail Edit
Home Screen TalkBack Detail Edit

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.

trackr's People

Contributors

alexvanyo avatar calren avatar diverdan92 avatar jdkoren avatar plain-dev avatar shailen avatar yaraki avatar zsmb13 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

trackr's Issues

app-compose:compileDebugKotlin task is failing Trackr Android sample App

  1. Import Trackr Android App sample on the EEPatch 2 or Flamingo RC1
  2. Upgrade AGP to 8.0.0-rc1
  3. Build project(Build->Rebuild)
Observed Result:

Build failed with below error

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app-compose:compileDebugKotlin'.
> A failure occurred while executing org.jetbrains.kotlin.compilerRunner.GradleCompilerRunnerWithWorkers$GradleKotlinCompilerWorkAction
   > Compilation error. See log for more details

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.

* Get more help at https://help.gradle.org

Deprecated Gradle features were used in this build, making it incompatible with Gradle 9.0.

You can use '--warning-mode all' to show the individual deprecation warnings and determine if they come from your own scripts or plugins.

See https://docs.gradle.org/8.0/userguide/command_line_interface.html#sec:command_line_warnings

BUILD FAILED in 2m 30s
105 actionable tasks: 104 executed, 1 up-to-date

Streamline Github Actions Setup

I noticed that the current workflow setup can be improved in some way.

  • Target latest ubuntu version which is ubuntu-20.04
  • Update actions e.g. checkout@v2, setup-java@v2, upload-artifact@v2
  • Pin Java to JDK 11
  • Rather than extra step to zip artifacts, we can specify multiple paths using upload-artifact action so it zips and uploads artifacts itself.
  • Get rid of the step which does chmod +x .github/scripts/gradlew_recursive.sh. To let scripts have executable permissions we could use git update-index. Or we can completely remove gradlew_recursive.sh and use this approach instead.
  • Apply Gradle cache so we can have faster CI/build results in next runs.

the function of CoroutineTestRule

fun runBlockingTest(
    block: suspend TestCoroutineScope.() -> Unit
) = testDispatcher.runBlockingTest {
    block()
}

Suggest to write this:

fun runBlockingTest(
    block: suspend TestCoroutineScope.() -> Unit
) = testDispatcher.runBlockingTest ( block )

TalkBack focuses on obscured views of the list pane when the details pane is open.

Android 11, Samsung SM-G770F/DS, TalkBack 12.5.01.2

Open task detail from the task list screen and explore the opened screen with TalkBack turned on.
Besides the elements of the details page, TalkBack will also focus on the hidden views of the task list screen:

Screenshot_20210912-023246_Trackr_2

i think this is a bug in SlidingPaneLayout library. Until it is fixed, as a workaround we can set importantForAccessibility = View.IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS on the hidden pane of the SlidingPaneLayout. Something like this:

--- a/app/src/main/java/com/example/android/trackr/ui/BaseTwoPaneFragment.kt
        slidingPaneLayout.addPanelSlideListener(SlidingPaneAccessibilityHandler(slidingPaneLayout))

internal class SlidingPaneAccessibilityHandler(private val slidingPaneLayout: SlidingPaneLayout) : PanelSlideListener {

    private val listPaneContent by lazy(NONE) {
        slidingPaneLayout.findViewById<ViewGroup>(R.id.list_pane)[0]
    }

    init {
        slidingPaneLayout.doOnLayout {
            syncState()
        }
    }

    private fun syncState() {
        val mode = if (slidingPaneLayout.isSlideable && slidingPaneLayout.isOpen) {
            View.IMPORTANT_FOR_ACCESSIBILITY_NO_HIDE_DESCENDANTS
        } else {
            View.IMPORTANT_FOR_ACCESSIBILITY_AUTO
        }
        listPaneContent.importantForAccessibility = mode
    }
    override fun onPanelOpened(panel: View) {
        syncState()
    }

    override fun onPanelClosed(panel: View) {
        syncState()
    }

    override fun onPanelSlide(panel: View, slideOffset: Float) {
        // empty
    }
}

This snippet fixes the problem.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.