请参考教材，全面理解和完成本章节内容... ...
复制工程ch21，将工程目录改名为ch22.
本章将为「陋习手记」应用打造适应平板设备的用户界面，让用户能同时查看到列表和明细界面并与它们进行交互。图22-1展示了这样的列表明细界面。通常我们也称为主从用户界面（master-detail interface）。
图22-1 同时显示列表和明细的用户界面
本章的测试需要一台平板设备(我用大手机也行)或AVD。要创建平板AVD，首先启动Android Virtual Device Manager，然后在分类Category里单击Tablet，选择一个平板AVD设备。最后设置AVD的系统目标版本为API级别第17级。如图22-2所示：
图22-2 AVD平板设备选择
22.1 增加布局灵活性
在手机设备上，CrimeListActivity生成的是单版面（single-pane）布局。而在平板设备上，为同时显示主从视图，我们需要它生成双版面（two-pane）布局。
在双版面布局中，CrimeListActivity将同时托管CrimeListFragment和CrimeFragment（如图22-3所示）。
图22-3 不同类型的布局
要实现双版面布局，需执行如下操作步骤：
- 修改
SingleFragmentActivity，不再硬编码实例化布局； - 创建包含两个fragment容器的布局；
- 修改
CrimeListActivity，实现在手机设备上实例化单版面布局，而在平板设备上实例化双版面布局。
22.1.1 修改SingleFragmentActivity
CrimeListActivity是SingleFragmentActivity的子类。当前，SingleFragmentActivity只能实例化activity_fragment.xml布局。为使SingleFragmentActivity类更加抽象、灵活，我们让它的子类自己提供布局资源ID。
在SingleFragmentActivity.java中，添加一个protected方法，返回activity需要的布局资源ID，如代码清单22-1所示。
代码清单22-1 增加SingleFragmentActivity类的灵活性（SingleFragmentActivity.java）
现在，虽然SingleFragmentActivity抽象类的功能和以前一样，但是它的子类可以选择覆盖getLayoutResId()方法返回所需布局，而不用再使用固定不变的activity_fragment.xml布局。
22.1.2 创建包含两个fragment容器的布局
在包浏览器中，右键单击res/layout/目录，选择创建一个新的布局文件，并将文件命名为activity_twopane.xml，然后选择LinearLayout作为根元素。参照图22-4，完成双版面布局的XML内容定义。
图22-4 包含两个fragment容器的布局（layout/activity_twopane.xml）
注意，布局定义的第一个FrameLayout也有一个fragmentContainer布局资源ID，因此SingleFragmentActivity.onCreate(...)方法的相关代码能够像以前一样工作。activity创建后，createFragment()方法返回的fragment将会出现在屏幕左侧的版面中。
要测试新建布局，在CrimeListActivity类中覆盖getLayoutResId()方法，返回R.layout.activity_twopane资源ID，如代码清单22-2所示。
代码清单22-2 使用双版面布局（CrimeListActivity.java）
在平板设备或AVD上运行「陋习手记」应用，确认可以看到如图22-5所示的用户界面。注意，右边的明细版面什么也没显示，点击任意列表项，也无法显示对应的陋习明细信息。本章稍后将完成crime明细fragment容器的编码及设置工作。
图22-5 平板设备上的双版面布局
当前，无论是在手机还是在平板设备上，CrimeListActivity都会生成双版面的用户界面。下一节将使用别名资源来解决这个问题。
22.1.3 使用别名资源
别名资源是一种指向其他资源的特殊资源。它存放在resvalues目录下，并按照约定定义在refs.xml文件中。
本小节将分别创建用于手机指向activity_fragment.xml布局的别名资源，以及用于平板指向activity_twopane.xml布局的别名资源。
在项目中，右键单击resvalues目录，创建一个新的XML文件, New->Values resource file，并将文件命名为refs.xml，参照代码清单22-3，在新建的refs.xml中添加item节点定义。
代码清单22-3 创建默认的别名资源值（res/values/refs.xml）
别名资源指向了单版面布局资源文件。别名资源自身也具有资源ID：R.layout.activity_masterdetail。注意，别名的type属性决定了资源ID属于什么内部类。即使别名资源自身存放在res/values/目录中，它的资源ID依然归属于R.layout内部类。
修改CrimeListActivity类的相应代码，以R.layout.activity_masterdetail资源ID替换R.layout.activity_fragment，如代码清单22-4所示。
代码清单22-4 再次切换布局（CrimeListActivity.java）
运行「陋习手记」应用，验证别名资源是否可以正常工作。一切正常的话，CrimeListActivity应该再次生成了单版面布局。
图22-5-1 再次生成了单版面布局
创建平板设备专用可选资源
存放在values目录下的别名资源是系统默认的别名资源，所以，CrimeListActivity生成了默认的单版面布局。
现在，创建一个可选别名资源，以实现在平板等大屏幕设备上，activity_masterdetail别名资源可以指向activity_twopane.xml双版面布局资源。
在包浏览器中，右键单击res目录，新建一个名为values-sw600dp的目录。将resvalues efs.xml文件复制到 resvalues-sw600dp目录下，然后参照代码清单22-5，修改别名资源指向双版面布局。
注：如果在工程里看不见新建的values-sw600dp的目录，在工程外部将refs.xml文件复制到 resvalues-sw600dp目录下。
代码清单22-5 用于大屏幕设备的可选资源（res/values-sw600dp/refs.xml）
配置修饰符-sw600dp是什么意思？SW是smallest width（最小宽度）的缩写，虽然字面上是宽度的含义，但它实际指的是屏幕的最小尺寸（dimension），因而SW与设备的当前方向无关。
在确定可选资源时，-sw600dp配置修饰符表明：对任何最小尺寸为600dp或更高dp的设备，都使用该资源。对于指定平板的屏幕尺寸规格来说，这是一种非常好的做法。
需要说明的是, Android 3.2中才引入了最小宽度配置修饰符。这意味着，运行Android 3.0或Android 3.1系统的平板设备无法识别它。
为解决该问题，可以增加另一种使用-xlarge（仅适用于Android 3.2以前的版本）屏幕尺寸修饰符的可选资源。
单击res目录，新建一个名为values-xlarge的目录。然后将values-sw600dp efs.xml资源文件复制到新建的values-xlarge目录中。现在我们有了另一个如代码清单22-6所示的资源文件。
代码清单22-6 用于Android 3.2之前版本的可选资源（res/values-xlarge/refs.xml）
<resources>
<item name="activity_masterdetail" type="layout">@layout/activity_twopane</item>
</resources>
配置修饰符-xlarge包含的资源适用于最低尺寸为720×960dp的设备。该修饰符仅适用于运行Android 3.2之前版本的设备。Android 3.2及之后的系统版本会自动找到并使用-sw600dp修饰符目录下的资源。
分别在手机和平板上运行CriminalIntent应用。确认单双版面的布局达到预期效果。
22.2 Activity：fragment 的托管者
既然单双版面的布局显示已处理完成，我们来着手添加CrimeFragment给crime明细fragment容器，让CrimeListActivity可以展示一个完整的双版面用户界面。
为保持fragment的独立性，我们可以在fragment中定义回调接口，委托托管activity来完成那些不应由fragment处理的任务。托管activity将实现回调接口，履行托管fragment的任务。
fragment回调接口
为委托工作任务给托管activity，通常的做法是由fragment定义名为Callbacks的回调接口。回调接口定义了fragment委托给托管activity处理的工作任务。任何打算托管目标fragment的activity必须实现这些定义的接口。
有了回调接口，无需知道自己的托管者是谁，fragment可以直接调用托管activity的方法。
实现CrimeListFragment.Callbacks回调接口
要实现一个Callbacks接口，首先定义一个成员变量存放实现Callbacks接口的对象。然后将托管activity强制类型转换为Callbacks对象并赋值给Callbacks类型变量。
在CrimeListFragment.java中，添加一个Callbacks接口。另外再添加一个mCallbacks变量并覆盖onAttach(Activity)和onDetach()方法，完成变量的赋值与清空，如代码清单22-7所示。
代码清单22-7 添加回调接口（CrimeListFragment.java）
现在，CrimeListFragment有了调用托管activity方法的途径。另外，它也不关心托管activity是谁。只要托管activity实现了CrimeListFragment.Callbacks接口，而CrimeListFragment中一切代码行为都保持不变。
注意，未经类安全性检查，CrimeListFragment就将托管activity强制转换为CrimeListFragment.Callbacks对象。这意味着，托管activity必须实现CrimeListFragment.Callbacks接口。这并非是不良的依赖关系，但记录下它非常重要。
接下来，在CrimeListActivity类中，实现CrimeListFragment.Callbacks接口，如代码清单22-8所示。暂时不用理会onCrimeSelected(Crime)空方法，稍后，我们再来处理。
代码清单22-8 实现回调接口（CrimeListActivity.java）
最终，在onListItemClick(...)方法里以及在用户创建新crime时，CrimeListFragment将调用onCrimeSelected(Crime)方法。现在，我们先来思考如何实现CrimeListActivity.onCrimeSelected(Crime)方法。
onCrimeSelected(Crime)方法被调用时，CrimeListActivity需要完成以下二选一的任务：
- 如使用手机用户界面布局，启动新的
CrimePagerActivity； - 如使用平板用户界面布局，将
CrimeFragment放入detailFragmentContainer中。
为确定需实例化手机还是平板界面布局，可以检查布局ID。但最好最准确的检查方式是检查布局是否包含detailFragmentContainer。因为，布局文件名随时可能更改，并且我们也不关心布局是从哪个文件实例化产生。我们只需知道，布局文件是否包含可以放入CrimeFragment的detailFragmentContainer。
如果证实布局包含detailFragmentContainer，那么我们就会创建一个fragment事务，将我们需要的CrimeFragment添加到detailFragmentContainer中。如果之前就有CrimeFragment存在，首先应从detailFragmentContainer中移除它。
在CrimeListActivity.java中，实现onCrimeSelected(Crime)方法，按照布局界面的不同，响应crime的选择，如代码清单22-9所示。
代码清单22-9 有条件的CrimeFragment启动（CrimeListActivity.java）
最后，在CrimeListFragment类中，在启动新的CrimePagerActivity的地方，调用onCrimeSelected(Crime)方法。
在CrimeListFragment.java中，修改onListItemClick(...)和onOptionsItemSelected(MenuItem)方法实现对Callbacks.onCrimeSelected(Crime)方法的调用，如代码清单22-10所示。
代码清单22-10 调用全部回调方法（CrimeListFragment.java）
在onOptionsItemSelected(...)方法中调用回调方法时，只要新增一项crime记录，就会立即重新加载crime列表。这很有必要，因为在平板设备上，新增crime记录后，crime列表依然可见。而在手机设备上，crime明细界面会在列表界面之前出现，列表项的刷新可以很灵活地处理。
在平板设备上运行CriminalIntent应用。新添加一项crime记录，可以看到，一个CrimeFragment视图立即被添加并显示在detailFragmentContainer容器中。然后，尝试查看其他旧记录以观察CrimeFragment视图的切换，如图22-6所示。
图22-6 已关联的主界面和明细界面
然而，如果修改crime明细内容，列表项并不会以最新数据刷新显示。当前，在CrimeListFragment.onResume()方法中，只有新添加一项crime记录，我们才能立即重新刷新显示列表项界面。但是，在平板设备上，CrimeListFragment和CrimeFragment将会同时可见。因此，当CrimeFragment出现时，CrimeListFragment不会暂停，自然也就永远不会从暂停状态恢复了。这就是crime列表项不能重新加载刷新的根本原因。
下面，我们将在CrimeFragment中添加另一个回调接口来修正该问题。
CrimeFragment.Callbacks回调接口的实现
CrimeFragment类中定义的接口如下：
public interface Callbacks {void onCrimeUpdated(Crime crime);}
保存crime记录的修改时，CrimeFragment类都将调用托管activity的onCrimeUpdated(Crime)方法。CrimeListActivity类将会实现onCrimeUpdated(Crime)方法，从而重新加载CrimeListFragment的列表。
实现CrimeFragment的接口之前，首先在CrimeListFragment类中新增一个方法，用来重新加载刷新CrimeListFragment列表，如代码清单22-11所示。
代码清单22-11 新增updateUI()方法（CrimeListFragment.java）
然后，在CrimeFragment.java中，添加回调方法接口以及mCallbacks成员变量并实现onAttach(...)和onDetach()方法，如代码清单22-12所示。
代码清单22-12 新增CrimeFragment回调接口（CrimeFragment.java）
然后在CrimeListActivity类中实现CrimeFragment.Callbacks接口，在onCrimeUpdated(Crime)方法中重新加载crime列表项，如代码清单22-13。
代码清单22-13 刷新显示crime列表（CrimeListActivity.java）
在CrimeFragment.java中，如果Crime对象的标题或问题处理状态发生改变，触发调用onCrimeUpdated(Crime)方法，如代码清单22-14所示。
代码清单22-14 调用onCrimeUpdated(Crime)方法（CrimeFragment.java）
在onActivityResult(...)方法中，Crime对象的记录日期、现场照片以及嫌疑人都有可能修改，因此，还需在该方法中调用onCrimeUpdated(Crime)方法。当前，crime现场照片以及嫌疑人并没有出现在列表项视图中，但并排的CrimeFragment视图应该显示了这些更新，如代码清单22-15所示。
代码清单22-15 再次调用onCrimeUpdated(Crime)方法（CrimeFragment.java）
CrimeListActivity现在有了CrimeFragment.Callbacks接口的一个良好实现。然而，如果在手机设备上运行CriminalIntent应用，它将会崩溃。记住，任何托管CrimeFragment的activity都必须实现CrimeFragment.Callbacks接口。因此，我们还需要在CrimePagerActivity类中实现CrimeFragment.Callbacks接口。
对于CrimePagerActivity类，onCrimeUpdated(Crime)方法什么都不用做，因此直接实现一个空方法即可（如代码清单22-16所示）。CrimePagerActivity类托管CrimeFragment时，必需的列表加载刷新已经在OnResume()方法中完成了。
代码清单22-16 CrimeFragment.Callbacks接口的空实现（CrimePagerActivity.java）
在平板设备上运行CriminalIntent应用。确认CrimeFragment视图中发生的任何修改，ListView视图都能够更新显示，如图22-7所示。
图22-7 列表刷新显示了明细界面的修改
至此，CriminalIntent应用的开发全部完成了。