Project 4

Due Date: Fri 22 Nov (FIRM)

Pair Project 

Objectives 

Familiarity with
  • event-driven program execution
  • state dependence in application
  • Model-View-Adapter architecture
  • Android framework

Description 

In this project, you will implement a very simple timer as an Android application. 

Functional Requirements (55%) 

The timer has the following controls:
  • (0.5) One two-digit display of the form 88.
  • (0.5) One multi-function button.
The timer behaves as follows:
  • (0.5) The timer always displays the remaining time in seconds.
  • (0.5) Initially, the timer is stopped and the (remaining) time is zero.
  • (0.5) If the button is pressed when the timer is stopped, the time is incremented by one up to a preset maximum of 99. (The button acts as an increment button.)
  • (0.5) If the time is greater than zero and three seconds elapse from the most recent time the button was pressed, then the timer beeps once and starts running.
  • (0.5) While running, the timer subtracts one from the time for every second that elapses.
  • (0.5) If the timer is running and the button is pressed, the timer stops and the time is reset to zero. (The button acts as a cancel button.)
  • (0.5) If the timer is running and the time reaches zero by itself (without the button being pressed), then the timer stops and the alarm starts beeping continually and indefinitely.
  • (0.5) If the alarm is sounding and the button is pressed, the alarm stops sounding; the timer is now stopped and the (remaining) time is zero. (The button acts as a stop button.)
  • (0.5) The timer handles rotation by continuing in its current state.

Nonfunctional Requirements (25%)

  • Ensure your application is testable.
  • (1.5) Ensure your application includes comprehensive unit, integration, and functional tests using the techniques from the clickcounter and stopwatch examples where appropriate. (See also http://developer.android.com/tools/testing/testing_android.html)
  • (0.5) Follow the design principles discussed so far.
  • Maintain a clear, responsibility-based separation among the different building blocks. It is recommended that you start with the stopwatch example.
    • The adapter should be lean (as in the stopwatch example).
    • Most of the complexity should be buried in the model (also as in the stopwatch example).
    • Unlike the stopwatch example, the dynamic model (state machine) has guards involving the current time. Think carefully how to inject the dependency on the time model into the state machine. Do not use static members!
    • (0.5 extra credit) Use of the state pattern (APPP chapter 36) is recommended.
  • Generally follow good Android development practice: http://developer.android.com
  • Use this Timer class: http://developer.android.com/reference/java/util/Timer.html
  • (0.5) For beeping, use media playback to play a notification sound (or some other suitable mechanism):
    • http://stackoverflow.com/questions/10335057/play-notification-default-sound-only-android
    • use getApplicationContext() to obtain the required context reference

Written Part/Documentation (20%) 

Please include these deliverables in the doc folder of your project4.
  • (0.5) Include the model from the group activity. (Minimally, a cell phone scan of your drawing is acceptable.)
  • (0.25) Use inline comments to document design details in the code.
  • (0.25) Use javadoc comments to document how to use the abstractions (interfaces, classes) you designed.
  • Include a brief (300-500 words) report on
    • (0.5) Your pair development journey during this project. Focus on aspects you find noteworthy, e.g., process, pairing, testing, design decisions, refactoring, use of the repository.
    • (0.5) The relationship between your state machine model from this project and your actual code. Possible talking points are:
      • What are the similarities and differences between model and code?
      • Is it more effective to code or model first?
      • Now that you have the code, what, if any, changes would you make to your model? 

Grading Criteria

  • Stated percentages for the major categories
  • Stated points for the specific items
  • Total 10 points
  • Deductions of up to 1 point for
    • deviation from the required project folder structure (see clickcounter)
    • inability to run and/or test

How to submit 

As the first step in working on this project, you or your teammate will push the code skeleton to a private Bitbucket repository shared among the two of you and your instructor and TA. The name of the repository is cs313f13teamNp4, where N is your team number found in Sakai. When your work is ready to be graded, please notify your instructor and TA via Piazza.
Comments