[Android] 新旧のAndroidで動作するServiceの作り方

How to able to run service applications on all OS versions

ServiceクラスのonStartメソッドはdeprecated（非推奨）に指定され、Android2.1以降では使うべきではないメソッドになってしまいました。
実際にAndroid2.1以降ではonStartメソッドが呼ばれないことがあります。
代替メソッドとしてonStartCommandメソッドが用意されましたが、Android1.6にはonStartCommandメソッドがありません。

1.6以降のどのAndroidでも同じように動作するサービスアプリケーションを作るには、onStartメソッドとonStartCommandメソッドの両方を実装します。
1.6以降のAndroidに対応させるので、プロジェクトのBuild TargetはAndroid1.6(API Level 4)とします。
以下はサンプルです。

サービスクラス(MyService.java)
package jp.fujiu.onStartCommand_test; import android.app.Service; import android.content.Intent; import android.os.IBinder; import android.widget.Toast; public class MyService extends Service { // (1) private static final int START_STICKY = 1; // (2) public int onStartCommand(Intent intent, int flags, int startId){ onStart(intent, startId); return START_STICKY; } /* * Android1.6以前はonStartが呼ばれる */ @Override public void onStart(Intent intent, int startId) { //ここからサービス開始後の処理 Toast.makeText(getApplicationContext(), "MyService has been started", Toast.LENGTH_LONG).show(); } @Override public IBinder onBind(Intent intent) { return null; } }

Activity(Main.java)
package jp.fujiu.onStartCommand_test; import android.app.Activity; import android.content.Intent; public class Main extends Activity { private Intent intent; @Override protected void onResume() { super.onResume(); //サービス起動 intent = new Intent(this, MyService.class); startService(intent); } @Override protected void onPause() { super.onPause(); //サービス停止 stopService(intent); } }

マニフェスト(AndroidManifest.xml)
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="jp.fujiu.onStartCommand_test" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="4" /> <application android:label="onStartCommand test" > <activity android:name=".Main" > <intent-filter > <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <service android:name=".MyService"> </service> </application> </manifest>

このプロジェクトを実行するとActivity（真っ黒の画面）が表示されている間だけMyServiceクラスが起動します。
実行するとAndroid1.6ではonStartメソッドが、Android2.1以降ではOnStartCommandメソッドが呼ばれます。

Build TargetにAndroid1.6をしていたい場合は、onStartCommandメソッドはオーバーライドせずに（@overrideアノテーションを書かずに）コーディングします。
Eclipseを使う場合、[ソース]-[メソッドのオーバーライド] メニューを開いてもonStartCommandメソッドは選べません。メソッド名や引数を間違えないようにAndroidリファレンスからコピーします。

onStartCommandメソッドを使う上で特に注意することがあります。
サービスはOSによってrestartされることがあるのですが、restartされたときに呼ばれるonStartCommandメソッドの引数 intent は null です。
（return START_STICKY; と指定した場合）
Android1.6とAndroid2.xとでは、restartされたときの引数の内容が異なります。

また、Android1.6では「No more background processes」によりrestartされてもonStartメソッドが実行されないことがあります。
Android1.6のサポートが難しくなってきました。

以上、参考になれば幸いです。