twrp gui/actions.cpp 中的功能实现 tw_action ，tw_action_param ,第二章

继续分析 twrp ui.xml中的相关内容，以<page name="reboot">为讲解内容 

    <object type="button">
                <highlight color="%highlight_color%" />
                <condition var1="tw_reboot_system" var2="1" />
                <placement x="%col1_x%" y="%row1_y%" />
                <font resource="font" color="%button_text_color%" />
                <text>System</text>
                <image resource="main_button" />
                <actions>
                    <action function="set">tw_back=reboot</action>
                    <action function="set">tw_action=reboot</action>
                    <action function="set">tw_action_param=system</action>
                    <action function="set">tw_has_action2=0</action>
                    <action function="set">tw_text1=No OS Installed! Are you</action>
                    <action function="set">tw_text2=sure you wish to reboot?</action>
                    <action function="set">tw_action_text1=Rebooting...</action>
                    <action function="set">tw_complete_text1=Rebooting...</action>
                    <action function="set">tw_slider_text=Swipe to Reboot</action>
                    <action function="page">rebootcheck</action>
                </actions>
            </object>

            <object type="button">
                <highlight color="%highlight_color%" />
                <condition var1="tw_reboot_poweroff" var2="1" />
                <placement x="%col2_x%" y="%row1_y%" />
                <font resource="font" color="%button_text_color%" />
                <text>Power Off</text>
                <image resource="main_button" />
                <actions>
                    <action function="set">tw_back=reboot</action>
                    <action function="set">tw_action=reboot</action>
                    <action function="set">tw_action_param=poweroff</action>
                    <action function="set">tw_has_action2=0</action>
                    <action function="set">tw_text1=No OS Installed! Are you</action>
                    <action function="set">tw_text2=sure you wish to power off?</action>
                    <action function="set">tw_action_text1=Turning Off...</action>
                    <action function="set">tw_complete_text1=Turning Off...</action>
                    <action function="set">tw_slider_text=Swipe to Power Off</action>
                    <action function="page">rebootcheck</action>
                </actions>
            </object>

            <object type="button">
                <highlight color="%highlight_color%" />
                <condition var1="tw_reboot_recovery" var2="1" />
                <placement x="%col1_x%" y="%row2_y%" />
                <font resource="font" color="%button_text_color%" />
                <text>Recovery</text>
                <image resource="main_button" />
                <actions>
                    <action function="set">tw_back=reboot</action>
                    <action function="set">tw_action=reboot</action>
                    <action function="set">tw_action_param=recovery</action>
                    <action function="set">tw_has_action2=0</action>
                    <action function="set">tw_text1=No OS Installed! Are you</action>
                    <action function="set">tw_text2=sure you wish to reboot?</action>
                    <action function="set">tw_action_text1=Rebooting...</action>
                    <action function="set">tw_complete_text1=Rebooting...</action>
                    <action function="set">tw_slider_text=Swipe to Reboot</action>
                    <action function="page">rebootcheck</action>
                </actions>
            </object>

            <object type="button">
                <highlight color="%highlight_color%" />
                <condition var1="tw_reboot_bootloader" var2="1" />
                <placement x="%col2_x%" y="%row2_y%" />
                <font resource="font" color="%button_text_color%" />
                <text>Bootloader</text>
                <image resource="main_button" />
                <actions>
                    <action function="set">tw_back=reboot</action>
                    <action function="set">tw_action=reboot</action>
                    <action function="set">tw_action_param=bootloader</action>
                    <action function="set">tw_has_action2=0</action>
                    <action function="set">tw_text1=No OS Installed! Are you</action>
                    <action function="set">tw_text2=sure you wish to reboot?</action>
                    <action function="set">tw_action_text1=Rebooting...</action>
                    <action function="set">tw_complete_text1=Rebooting...</action>
                    <action function="set">tw_slider_text=Swipe to Reboot</action>
                    <action function="page">rebootcheck</action>
                </actions>
            </object>

tw_actoin=reboot传入的是命令，tw_action_param=system 传入的是参数

在gui/actions.cpp 中有如下的函数定义 

int GUIAction::doAction(Action action, int isThreaded /* = 0 */)
{
    static string zip_queue[10];
    static int zip_queue_index;
    static pthread_t terminal_command;
    int simulate;

    std::string arg = gui_parse_text(action.mArg); //这里获取tw_action＝的参数即tw_action_param传入的参数

    std::string function = gui_parse_text(action.mFunction); //获取tw_action传入的函数名字

    DataManager::GetValue(TW_SIMULATE_ACTIONS, simulate);

    if (function == "reboot")    
    {
            //curtainClose(); this sometimes causes a crash

        sync();
        DataManager::SetValue("tw_gui_done", 1);
        DataManager::SetValue("tw_reboot_arg", arg);   //把参数传入到，其中tw_reboot_arg的类型是 map<string, string> 

        return 0;
    }
       ... 

好了，再看别外一个文件:

// reboot: Reboot the system. Return -1 on error, no return on success
int TWFunc::tw_reboot(RebootCommand command) //RebootCommand 中一个enum类型，定义在twrp-functions.hpp中
{
    // Always force a sync before we reboot
    sync();

    switch (command) {
        case rb_current:
        case rb_system:
            Update_Log_File();
            Update_Intent_File("s");
            sync();
            check_and_run_script("/sbin/rebootsystem.sh", "reboot system");
            return reboot(RB_AUTOBOOT);
        case rb_recovery:
            check_and_run_script("/sbin/rebootrecovery.sh", "reboot recovery");
            return __reboot(LINUX_REBOOT_MAGIC1, LINUX_REBOOT_MAGIC2, LINUX_REBOOT_CMD_RESTART2, (void*) "recovery");
        case rb_bootloader:
            check_and_run_script("/sbin/rebootbootloader.sh", "reboot bootloader");
            return __reboot(LINUX_REBOOT_MAGIC1, LINUX_REBOOT_MAGIC2, LINUX_REBOOT_CMD_RESTART2, (void*) "bootloader");
        case rb_poweroff:
            check_and_run_script("/sbin/poweroff.sh", "power off");
#ifdef ANDROID_RB_POWEROFF
            android_reboot(ANDROID_RB_POWEROFF, 0, 0);
#endif
            return reboot(RB_POWER_OFF);
        case rb_download:
            check_and_run_script("/sbin/rebootdownload.sh", "reboot download");
            return __reboot(LINUX_REBOOT_MAGIC1, LINUX_REBOOT_MAGIC2, LINUX_REBOOT_CMD_RESTART2, (void*) "download");
        default:
            return -1;
    }
    return -1;
}

RebootCommand类型定义如下：

typedef enum {
     rb_recovery,
     rb_poweroff,
     rb_bootloader,
     rb_download,
 } RebootCommand;

触发重启进入什么类型的调用在twrp.cpp::main()函数中

定义如下：

    ...
      // Reboot
    TWFunc::Update_Intent_File(Reboot_Value);
    TWFunc::Update_Log_File();
    gui_print("Rebooting...
");
    string Reboot_Arg;
    DataManager::GetValue("tw_reboot_arg", Reboot_Arg);  //这里获取tw_reboot_arg中的变量
    if (Reboot_Arg == "recovery")
        TWFunc::tw_reboot(rb_recovery);     //传入enum变量，触发重启进入recovery动作
    else if (Reboot_Arg == "poweroff")
        TWFunc::tw_reboot(rb_poweroff);
    else if (Reboot_Arg == "bootloader")
        TWFunc::tw_reboot(rb_bootloader);
    else if (Reboot_Arg == "download")
        TWFunc::tw_reboot(rb_download);
    else
        TWFunc::tw_reboot(rb_system);
    ...