Android アプリ開発にて、ListFragment で setListAdapter した後に addHeaderView や addFooterView を呼び出すと java.lang.IllegalStateException 例外が発生して、アプリがクラッシュしてしまいます。

Android 4 系だと例外は発生しなくて、Android 2.3 系だと例外でクラッシュするみたいです。

Stack Trace
_________________________________
0  java.lang.RuntimeException: Unable to resume activity {com.example/com.example.activity.MainActivity}:
 java.lang.IllegalStateException: Cannot add header view to list -- setAdapter has already been called.
1    at android.app.ActivityThread.performResumeActivity(ActivityThread.java:2124)
2    at android.app.ActivityThread.handleResumeActivity(ActivityThread.java:2139)
3    at android.app.ActivityThread$H.handleMessage(ActivityThread.java:961)
4    at android.os.Handler.dispatchMessage(Handler.java:99)
5    at android.os.Looper.loop(Looper.java:123)
6    at android.app.ActivityThread.main(ActivityThread.java:3691)
7    at java.lang.reflect.Method.invokeNative(Native Method)
8    at java.lang.reflect.Method.invoke(Method.java:507)
9    at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:864)
10    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:622)
11    at dalvik.system.NativeStart.main(Native Method)
12  Caused by: java.lang.IllegalStateException: Cannot add header view to list -- setAdapter has already been called.
13    at android.widget.ListView.addHeaderView(ListView.java:336)
14    at android.widget.ListView.addHeaderView(ListView.java:359)
15    at com.example.fragment.NewFragment.refreshListView(NewFragment.java:358)
16    at com.example.fragment.NewFragment.onResume(NewFragment.java:143)
17    at android.support.v4.app.Fragment.performResume(Fragment.java:1503)
18    at android.support.v4.app.FragmentManagerImpl.moveToState(FragmentManager.java:947)
19    at android.support.v4.app.FragmentManagerImpl.moveToState(FragmentManager.java:1088)
20    at android.support.v4.app.FragmentManagerImpl.moveToState(FragmentManager.java:1070)
21    at android.support.v4.app.FragmentManagerImpl.dispatchResume(FragmentManager.java:1871)
22    at android.support.v4.app.FragmentActivity.onResumeFragments(FragmentActivity.java:455)
23    at android.support.v4.app.FragmentActivity.onPostResume(FragmentActivity.java:444)
24    at com.actionbarsherlock.app.SherlockFragmentActivity.onPostResume(SherlockFragmentActivity.java:69)
25    at android.app.Activity.performResume(Activity.java:3867)
26    at android.app.ActivityThread.performResumeActivity(ActivityThread.java:2114)
27    ... 10 more
28  java.lang.IllegalStateException: Cannot add header view to list -- setAdapter has already been called.
29    at android.widget.ListView.addHeaderView(ListView.java:336)
30    at android.widget.ListView.addHeaderView(ListView.java:359)
31    at com.example.fragment.NewFragment.refreshListView(NewFragment.java:358)
32    at com.example.fragment.NewFragment.onResume(NewFragment.java:143)
33    at android.support.v4.app.Fragment.performResume(Fragment.java:1503)
34    at android.support.v4.app.FragmentManagerImpl.moveToState(FragmentManager.java:947)
35    at android.support.v4.app.FragmentManagerImpl.moveToState(FragmentManager.java:1088)
36    at android.support.v4.app.FragmentManagerImpl.moveToState(FragmentManager.java:1070)
37    at android.support.v4.app.FragmentManagerImpl.dispatchResume(FragmentManager.java:1871)
38    at android.support.v4.app.FragmentActivity.onResumeFragments(FragmentActivity.java:455)
39    at android.support.v4.app.FragmentActivity.onPostResume(FragmentActivity.java:444)
40    at com.actionbarsherlock.app.SherlockFragmentActivity.onPostResume(SherlockFragmentActivity.java:69)
41    at android.app.Activity.performResume(Activity.java:3867)
42    at android.app.ActivityThread.performResumeActivity(ActivityThread.java:2114)
43    at android.app.ActivityThread.handleResumeActivity(ActivityThread.java:2139)
44    at android.app.ActivityThread$H.handleMessage(ActivityThread.java:961)
45    at android.os.Handler.dispatchMessage(Handler.java:99)
46    at android.os.Looper.loop(Looper.java:123)
47    at android.app.ActivityThread.main(ActivityThread.java:3691)
48    at java.lang.reflect.Method.invokeNative(Native Method)
49    at java.lang.reflect.Method.invoke(Method.java:507)
50    at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:864)
51    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:622)
52    at dalvik.system.NativeStart.main(Native Method)

正しいコード

// addHeaderView 後に setListAdapter
listView.addHeaderView(headerView);
listView.addFooterView(footerView);

setListAdapter(arrayAdapter);

IllegalStateException でクラッシュするコード

// setListAdapter 後に addHeaderView
setListAdapter(arrayAdapter);

listView.addHeaderView(headerView);
listView.addFooterView(footerView);

必ず setListAdapter する前に、addHeaderView や addFooterView を呼び出すようにしましょう。

[参考]

・Note to self: ListFragment and header views

・android - ListFragment add headerView gives java.lang.IllegalStateException:alled - Stack Overflow

・Android - ListActivity, add Header and Footer view - Stack Overflow

・android - How to add footer view dynamically - Stack Overflow