Request File Read Permissions

As a user, I need the app to request file read permissions so that I can play the sermons located on my phone.

Acceptance Criteria:

  • GIVEN the application has permission to read files

    • WHEN viewing the sermon list screen
      • THEN the listing of sermons on disk are shown

  • GIVEN the application does not have permission to read files

    • WHEN the application has not yet asked for permission
    • OR the user has denied the permission, but not permanently
      • THEN display a screen with a message
      • AND the screen has an image at the top of 240dp x 240dp
      • AND 24dp below the image is a title of size 18sp reading "File Access Permission"
      • AND 8dp below the title is a description of default text size reading "Branham Player needs permission to access your files before it can play a sermon"
      • AND 48dp below the description is a button reading "Grant Access"
      • AND the contents are vertically aligned to the center
    • WHEN the user has permanently denied the permission
      • THEN display a screen with the same layout, button, and image as above
      • AND the title reads "File Access Denied"
      • AND the description reads "Branham Player was denied access to read your files. Please open up the app settings and grant the Storage permission."
      • AND the button reads "Open Settings"
    • WHEN the user has granted the permission
      • THEN the listing of sermons on disk are shown
      • AND the permission request screen is no longer show

  • GIVEN the buttons

    • WHEN the user presses the “Grant Access” button
      • THEN the system’s file request permission dialog is shown
    • WHEN the user presses the “Open Settings” button
      • THEN the user is taken to Branham Player app details in the Android Settings app