设置默认APP

1. 功能概述

系统支持自定义2类关键APP的默认配置,包括开机启动APP、Home键切换APP。

2. 开机默认启动APP设置

开机默认启动APP为开机后自动启动的第一个APP。

2.1 获取当前开机默认启动APP

通过以下函数获取系统当前设置的开机默认启动APP名称。如果获取这个APP为空,开机进入默认是主菜单"Main":

/**
 * @brief 获取开机后默认启动的第一个APP名称
 * @return APP名称字符串,若未设置则返回默认APP"Main"
 */
const char *app_get_reg_power_on_app(void);

2.2 如何重新设置开机后默认启动APP

通过以下函数修改开机默认启动APP,设置后下次开机将自动启动指定APP:

/**
 * @brief 设置开机后默认启动的第一个APP
 * @param power_on_app 目标APP名称(需为系统已注册的APP,如"Clock"或"activity")
 */
void app_set_reg_power_on_app(const char *power_on_app);

3. Home 键切换APP设置

Home键切换APP实现按Home键时的APP切换功能(按一次home键到tlvAPP、再按一次切换到mainAPP,循环切换)。

3.1 Home键mainAPP

  • 获取获取当前 Home 键mainAPP的函数:app_get_reg_main_app

通过以下函数获取当前设置的 Home 键mainAPP名称:

/**
 * @brief 获取Home键对应的mainAPP名称
 * @return APP名称字符串(如"Main"),若未设置则返回默认值
 */
const char *app_get_reg_main_app(void);
  • 设置Home 键mainAPP的函数:app_set_reg_main_app

/**
 * @brief 设置Home键对应的主APP
 * @param main_app 目标APP名称(需为系统已注册的APP,如"Main")
 * @note 若传入NULL或无效APP名,将恢复系统默认Home主APP
 */
void app_set_reg_main_app(const char *main_app);

3.2 Home 键tlvAPP

  • 获取home键tlvAPP的函数:app_get_reg_tlv_app

通过以下函数获取当前设置的 Home 键tlvAPP名称:

/**
 * @brief 获取Home键对应的次APP名称
 * @return APP名称字符串(如"setting"),若未设置则返回默认值
 */
const char *app_get_reg_tlv_app(void);
  • 设置home键tlvAPP的函数:app_set_reg_tlv_app

通过以下函数修改 Home 键tlvAPP,用于与主APP配合实现 Home 键的双APP切换:

/**
 * @brief 设置Home键对应的次APP
 * @param tlv_app 目标APP名称(需为系统已注册的APP,如"music")
 * @note 若传入NULL或无效APP名,将恢复系统默认Home次APP
 */
void app_set_reg_tlv_app(const char *tlv_app);

4. UI界面设置默认APP

4.1 默认启动APP

主菜单->设置->默认APP->开机APP :点击选择默认启动APP,固件重启时就会使用选择的APP。

4.2 默认平铺APP

主菜单->设置->默认APP->平铺APP :点击选择默认平铺APP,按键会在主菜单和选择的平铺APP间切换。

注意
mainAPP默认是菜单APP,为了避免修改主APP后无法切换选择其他APP,UI不支持修改选择mainAPP