1 <p> 2 This sample is a revised version of the AlarmService functionality included in the 3 ApiDemos sample application. It is used as the application under test 4 for the <a href="../AlarmServiceTest/index.html">Alarm Service Test</a> 5 sample test application. 6 </p> 7 <p> 8 This application demonstrates a simple Android service that is started when needed by 9 <code>Context.startService(Intent)</code> and stops itself when its work is done. You can 10 use this type of service to move long-running or periodic tasks into the background. For 11 example, you could use this type of service to perform data synchronization. 12 </p> 13 <p> 14 In the sample, the service simply runs for 15 seconds and then stops itself. The wait is 15 implemented in a separate thread that uses a thread-safe object. This illustrates how to 16 set up a service that runs multiple threads that depend on one or more objects that must be 17 made thread-safe. 18 </p> 19 <p> 20 The application also contains the <code>AlarmActivity</code> activity that is a client of the 21 service. You use the activity to control when the service starts and stops. By default, the 22 activity fires off the service every thirty seconds. In effect, the service starts after 23 thirty seconds, runs for 15 seconds, stops, and then runs again automatically in another 24 15 seconds. You also use the client to stop this cycle. 25 </p> 26 <p> 27 The test application <a href="tests/index.html">AlarmServiceTest</a> 28 shows you how to set up a test of this service. 29 </p> 30
