This sample is a revised version of the AlarmService functionality included in the ApiDemos sample application. It is used as the application under test for the Alarm Service Test sample test application.

This application demonstrates a simple Android service that is started when needed by Context.startService(Intent) and stops itself when its work is done. You can use this type of service to move long-running or periodic tasks into the background. For example, you could use this type of service to perform data synchronization.

In the sample, the service simply runs for 15 seconds and then stops itself. The wait is implemented in a separate thread that uses a thread-safe object. This illustrates how to set up a service that runs multiple threads that depend on one or more objects that must be made thread-safe.

The application also contains the AlarmActivity activity that is a client of the service. You use the activity to control when the service starts and stops. By default, the activity fires off the service every thirty seconds. In effect, the service starts after thirty seconds, runs for 15 seconds, stops, and then runs again automatically in another 15 seconds. You also use the client to stop this cycle.

The test application AlarmServiceTest shows you how to set up a test of this service.