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[];
     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", );
         DataManager::SetValue("tw_reboot_arg", arg);   //把参数传入到，其中tw_reboot_arg的类型是 map<string, string> 

         return ;
     }
       ... 

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

 // 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, , );
 #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 -;
     }
     return -;
 }

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...\n");
    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);
    ...