MTKAndroid4.2.2添加重启功能

    接触Android框架层也有一段时间了，但是基本上都没有对遇到的问题写总结，当遇到同样的问题也只能凭着模糊的记忆去解决。打算从今天开始每天抽点时间对工作中遇到的问题进行总结。

今天要说的是为Android添加一个重启按钮，在Nine的客户需求中需要添加这项功能，在长按电源键弹出的菜单中没有重启选项，谨以此文记录自己添加这个功能的过程：
修改涉及到的文件如下：

frameworks\base\core\java\android\view\WindowManagerPolicy.java
frameworks\base\core\res\res\values\strings.xml
frameworks\base\core\res\res\values-zh-rCN\strings.xml
frameworks\base\policy\src\com\android\internal\policy\impl\GlobalActions.java
frameworks\base\services\java\com\android\server\wm\windowManagerService.java
frameworks\base\services\java\com\android\server\power\ShutdownThread.java
frameworks\base\core\res\res\values\symbols.xml

首先找到长按电源键弹出的对话框，在frameworks\base\policy\src\com\android\internal\policy\impl\GlobalActions.java文件中

/**
* Create the global actions dialog.
* @return A new dialog.
*/
private GlobalActionsDialog createDialog() {
...
...
mItems = new ArrayList<Action>();
// first: power off
mItems.add(
new SinglePressAction(
com.android.internal.R.drawable.ic_lock_power_off,
R.string.global_action_power_off) {
public void onPress() {
// shutdown by making sure radio and power are handled accordingly.
mWindowManagerFuncs.shutdown(true);
}
public boolean onLongPress() {
mWindowManagerFuncs.rebootSafeMode(true);
return true;
}
public boolean showDuringKeyguard() {
return true;
}
public boolean showBeforeProvisioning() {
return true;
}
});
//xiaoyuguang 20130616 add reboot item
mItems.add(
new SinglePressAction(
com.android.internal.R.drawable.ic_lock_power_off,
R.string.global_action_reboot) {
public void onPress() {
// reboot
mWindowManagerFuncs.reboot(true);
}
public boolean onLongPress() {
return true;
}
public boolean showDuringKeyguard() {
return true;
}
public boolean showBeforeProvisioning() {
return true;
}
});
//end xiaoyuguang 20130616
...
...}

在GlobalActionsDialog方法可以看 mItems.add这个方法是添加菜单选项的，该菜单的添加的第一个选项就是关机选项。可以仿照关机的Item添加一个重启的选项，如上面的代码所示；这样就解决了在长按的电源键弹出的对话框中添加一个重启选项了。当然这仅仅是添加一个显示而已，接下来就为这个选项添加逻辑控制代码了。

在上面的代码中使用的mWindowManagerFuncs.reboot方法和R.string.global_action_reboot资源（资源的添加放到最后说），默认是不存在的，所以需要在自己手动添加。

首先在找到WindowManagerFuncs这个所在的位置，在frameworks\base\core\java\android\view\WindowManagerPolicy.java中

/**
* Interface for calling back in to the window manager that is private
* between it and the policy.
*/
public interface WindowManagerFuncs {
...
...
/**
* Switch the keyboard layout for the given device.
* Direction should be +1 or -1 to go to the next or previous keyboard layout.
*/
public void switchKeyboardLayout(int deviceId, int direction);
public void shutdown(boolean confirm);
public void rebootSafeMode(boolean confirm)
//xiaoyuguang
public void reboot(boolean confirm);

}

添加reboot方法。但这只是添加接口而已，它的具体实现在呢？找了许久在frameworks\base\services\java\com\android\server\wm\windowManagerService.java中找到了这个接口的实现。

/** {@hide} */
public class WindowManagerService extends IWindowManager.Stub
implements Watchdog.Monitor, WindowManagerPolicy.WindowManagerFuncs,
DisplayManagerService.WindowManagerFuncs, DisplayManager.DisplayListener {
...
...
// Called by window manager policy.  Not exposed externally.
@Override
public void shutdown(boolean confirm) {
ShutdownThread.shutdown(mContext, confirm);
}
//xiaoyuguang 20130616 add reboot
@Override
public void reboot(boolean confirm){
ShutdownThread.reboot(mContext, null, confirm);
}
//end xiaoyuguang
// Called by window manager policy.  Not exposed externally.
@Override
public void rebootSafeMode(boolean confirm) {
ShutdownThread.rebootSafeMode(mContext, confirm);
}
...
...}

同样在仿照关机的原理添加reboot的具体实现代码，既然在ShutdownThread这个类中提供了shutdown和rebootSafeMode的方法，那按理也应该有reboot的方法，或者类似reboot的方法。找到Shutdown.java文件，在frameworks\base\services\java\com\android\server\power\ShutdownThread.java中，

public final class ShutdownThread extends Thread {
...
...
/**
* Request a clean shutdown, waiting for subsystems to clean up their
* state etc.  Must be called from a Looper thread in which its UI
* is shown.
*
* @param context Context used to display the shutdown progress dialog.
* @param confirm true if user confirmation is needed before shutting down.
*/
public static void shutdown(final Context context, boolean confirm) {
...
}
/**
* Request a clean shutdown, waiting for subsystems to clean up their
* state etc.  Must be called from a Looper thread in which its UI
* is shown.
*
* @param context Context used to display the shutdown progress dialog.
* @param reason code to pass to the kernel (e.g. "recovery"), or null.
* @param confirm true if user confirmation is needed before shutting down.
*/
public static void reboot(final Context context, String reason, boolean confirm) {
mReboot = true;
mRebootSafeMode = false;
mRebootReason = reason;
Log.d(TAG, "reboot");
shutdownInner(context, confirm);
}
...
...
}

其中提供了一个静态的reboot方法，所以在windowManagerService.java中的reboot实现中直接调用ShutdownThread中reboot即可。
 public static void reboot(final Context context, String reason, boolean confirm)；有三个参数，后两个参数解释如下： reason  如果值为是null，正常重启；如果是recovery，系统重启进入recovery mode ；confirm为true显示关机提示框，需要用户【确认】；false不显示提示框，直接关机。

到此重启功能基本上可以使用了（除资源还没有添加之外），但是此时选择重启选项时，其提示还是不够关机的提示，所以还要修改选择“重启”时的对话框的提示。
在frameworks\base\services\java\com\android\server\power\ShutdownThread.java中

static void shutdownInner(final Context context, boolean confirm) {
...
...
final int resourceId = mRebootSafeMode
? com.android.internal.R.string.reboot_safemode_confirm
: (longPressBehavior == 2
? com.android.internal.R.string.shutdown_confirm_question
: com.android.internal.R.string.shutdown_confirm);
...
...
sConfirmDialog = new AlertDialog.Builder(context)
.setTitle(mRebootSafeMode
? com.android.internal.R.string.reboot_safemode_title
: com.android.internal.R.string.power_off)
.setMessage(resourceId)
...
...
}

修改如下：

final int resourceId = mReboot
? com.android.internal.R.string.reboot_confirm
: (mRebootSafeMode
? com.android.internal.R.string.reboot_safemode_confirm
: (longPressBehavior == 2
? com.android.internal.R.string.shutdown_confirm_question
: com.android.internal.R.string.shutdown_confirm));
...
...
sConfirmDialog = new AlertDialog.Builder(context)
.setTitle(mReboot
? com.android.internal.R.string.global_action_reboot
: (mRebootSafeMode
? com.android.internal.R.string.reboot_safemode_title
: com.android.internal.R.string.power_off))
.setMessage(resourceId)

至此关于代码部分的改动全部完成，接下就添加需要添加使用到的资源了，就是其中使用的字符串，为了简单起见就添加了英文和简体中文：
在对应的资源文件中添加：
frameworks\base\core\res\res\values\strings.xml

<!-- xiaoyuguang 20130616 -->
<!-- label for item that turns reboot in device options dialog -->
<string name="global_action_reboot">Reboot</string>
<string name="reboot_confirm">	Do you want to reboot your device?</string>
<!-- end xiaoyuguang 20130616 -->

frameworks\base\core\res\res\values-zh-rCN\strings.xml

<!-- xiaoyuguang 20130616 -->
<string name="global_action_reboot">重启</string>
<string name="reboot_confirm">您要重新启动您的设备吗?</string>
<!-- end xiaoyuguang 20130616-->

现在已经添加了好这些资源，但是现在还不能使用，此时编译会出现找不到该资源的错误，还需要在frameworks\base\core\res\res\values\symbols.xml（在4.1中是在frameworks\base\core\res\res\values\public.xml）文件中进行资源声明：

<java-symbol type="string" name="global_action_reboot" />
<java-symbol type="string" name="reboot_confirm" />

至此重启功能添加完毕，在编译前执行./mk -t update-api （因为新添加了接口）。
当然这仅仅是从框架层上进行修改，其底层的具体实现暂时还未探讨，有时间在去看看了。