/* hello.c — MeowOS SDK 版示例应用(链 meow_ui.a,B1)。 * * 契约(MEOW_APP_SDK.md §1/§3/§6):应用只调 meow_ui API —— 屏幕(back_buf + * flush 上屏)与输入(meow_ui_run 事件循环)由框架接管;不再 open/mmap/ioctl * /dev/fb0、不再读 /dev/input/event*。本应用验证「清屏 + 画文本 + 画按钮 + * 响应触摸」这一最小工作闭环,并集成了通知触发按钮(meow_notify_send,§9.1) * 用于端到端测试通知链路(SDK → IPC → launcher 中央存储 → 10s TTL 落盘)。 * * 交互: * - 点按钮 → tap 计数 +1(按钮标签实时更新); * - 通知触发行(6 个按钮):每个点击 meow_notify_send() 发一条不同参数的通知, * 覆盖 普通INFO / 媒体(单例) / HIGH紧急度 / 进度(40%) / 常驻 / 跳转Activity; * - CANCEL LAST 按钮:meow_notify_cancel(最近一次 send 的 id); * - 左缘左滑(抬手触发)→ 请求退出(回应用列表);滑动过程顶部出现随位移增长的进度条; * - 空闲时 on_tick 每秒刷新一行状态(含运行秒数)。 * * 宿主/qemu 离屏:设 MEOW_UI_DUMP= 时,首帧 flush 即把 back_buf 写成 * PPM 截图供检查;设备上无副作用。 * * Build(见 build_hello.sh): * zig-mipsel-cc -Os -static hello.c meow_ui.a libz.a -lpthread -o hello */ #include "meow_ui.h" #include #include #include #include #include #include /* §6.1 ①:Activity 归属。主界面(根,stack 空时 active()=0)绑定全部按钮控件; * 全屏沉浸页为独立 Activity(无控件)——触摸它绝不命中主界面按钮(根治跨页残留)。 * 进全屏 meow_ui_activity_push(ACT_FULL),退出 pop 回根(主界面按钮恢复可点,对象复用)。 */ #define ACT_HOME 0 #define ACT_FULL 1 static meow_widget *g_btn; static meow_widget *g_nbtn[6]; /* 通知触发按钮行 */ static meow_widget *g_cancel; /* 取消最近一条通知 */ static meow_widget *g_fs_btn; /* FULLSCREEN 进入按钮(主界面) */ static int g_fullscreen = 0; /* 1=处于全屏视图(点任意处退出回主界面) */ static const char *g_notif_labels[6] = { "INFO", "MEDIA", "HIGH", "PROG", "ONGO", "TGT" }; static uint32_t g_last_notif = 0; /* 最近一次 send 返回的 id,供 cancel */ static int g_taps = 0; static int g_secs = 0; static char g_btn_label[32] = "TAP ME"; /* M2.51:统一日志改用 SDK meow_log()(按 app 分离 + 级别过滤 + 降级), * 删除自造轮子的 hellolog()(自读 MEOW_LOG_DIR + snprintf + fopen/fprintf)。 */ static void on_sigterm(int s) { (void)s; meow_ui_request_exit(); } /* 通知触发:对应第 which 个按钮(0..5)。SDK 端 meow_notify_send() 自动注册未声明 * 类型(本应用用到 4 种:GENERAL / MEDIA / PROGRESS / MESSAGE,均在 4 种上限内), * 超时语义见 meow_ui.h §9.1;媒体类型为单例(重发替换)。 */ static void notif_send(int which) { meow_notify n; memset(&n, 0, sizeof n); n.progress = -1; /* 缺省不显示进度条 */ n.timeout_ms = MEOW_NOTIFY_TIMEOUT_NEVER; n.urgency = MEOW_NOTIFY_URG_NORMAL; const char *label = "?"; switch (which) { case 0: /* 普通 INFO */ label = "INFO"; n.cat = MEOW_NOTIFY_CAT_GENERAL; n.title = "测试-普通通知"; n.body = "普通 INFO 通知,timeout=5000ms"; n.timeout_ms = 5000; break; case 1: /* 媒体单例(ongoing,不自动过期) */ label = "MEDIA"; n.cat = MEOW_NOTIFY_CAT_MEDIA; n.urgency = MEOW_NOTIFY_URG_LOW; n.title = "测试-媒体通知"; n.body = "媒体单例,正在播放,timeout=-1 常驻"; n.timeout_ms = MEOW_NOTIFY_TIMEOUT_ONGOING; break; case 2: /* HIGH 紧急度 */ label = "HIGH"; n.cat = MEOW_NOTIFY_CAT_GENERAL; n.urgency = MEOW_NOTIFY_URG_HIGH; n.title = "测试-紧急度HIGH"; n.body = "高紧急度:顶部横幅+提示音"; n.timeout_ms = 3000; break; case 3: /* 进度通知 */ label = "PROG"; n.cat = MEOW_NOTIFY_CAT_PROGRESS; n.title = "测试-进度通知"; n.body = "下载进度 40%"; n.timeout_ms = 8000; n.progress = 40; break; case 4: /* 常驻(timeout=-1,不自动过期,需手动取消) */ label = "ONGO"; n.cat = MEOW_NOTIFY_CAT_GENERAL; n.title = "测试-常驻通知"; n.body = "常驻不自动过期(timeout=-1),需手动取消"; n.timeout_ms = MEOW_NOTIFY_TIMEOUT_ONGOING; break; case 5: /* 带 target_activity + icon(SDK 结构含 icon 字段;NULL/空=用 app 默认图标) */ label = "TGT"; n.cat = MEOW_NOTIFY_CAT_MESSAGE; n.title = "测试-跳转Activity"; n.body = "点击跳转 target_activity=main"; n.timeout_ms = 6000; n.target_activity = "main"; n.icon = NULL; /* 空 → launcher 用 app 默认图标(app.json icon) */ break; default: return; } uint32_t id = meow_notify_send(&n); g_last_notif = id; meow_log(MEOW_LOG_INFO, "notify btn=%s id=%u cat=%s urg=%s tmo=%d prog=%d target=%s title=%s", label, (unsigned)id, meow_notify_category_str(n.cat), meow_notify_urgency_str(n.urgency), n.timeout_ms, n.progress, n.target_activity ? n.target_activity : "-", n.title ? n.title : "-"); } static void notif_cancel(void) { int r = meow_notify_cancel(g_last_notif); meow_log(MEOW_LOG_INFO, "notify cancel id=%u result=%d", (unsigned)g_last_notif, r); g_last_notif = 0; } /* 进入/退出全屏视图(MeowOS 全屏机制,§3.1): * - fullscreen(1) + collapsed(1):状态栏「上收出屏只留提示线」(不完全沉浸,inset=4px), * 顶部提示线热区仍可下拉,左缘返回手势(app 已注册 on_swipe)仍生效——SDK 自动处理,非 app 拦截; * - fullscreen(0) + collapsed(0):恢复整条状态栏主界面。 * SDK 基座默认瞬切(g_sbar_collapse_anim_ms=0);如需过渡动画可先 meow_ui_statusbar_animate(ms)。 * §6.1 ①:全屏 = 独立 Activity——进时压栈 ACT_FULL(主界面控件因 owner=ACT_HOME 不再参与命中, * 根治「全屏页触摸到主页按钮区域闪现」);退时弹栈回根,主界面按钮恢复可点(对象复用零重建)。 */ static void set_fullscreen(int on) { g_fullscreen = on ? 1 : 0; meow_ui_set_fullscreen(g_fullscreen); meow_ui_statusbar_set_collapsed(g_fullscreen); if (on) meow_ui_activity_push(ACT_FULL); else meow_ui_activity_pop(); meow_log(MEOW_LOG_INFO, g_fullscreen ? "fullscreen ON (collapsed), activity->%d" : "fullscreen OFF (restore), activity->%d", meow_ui_activity_active()); } static void redraw(void) { const meow_theme *th = meow_theme_get(); int sb = meow_ui_statusbar_height(); /* A-0 全局状态栏 inset:内容下移避免被盖 */ if (g_fullscreen) { /* 全屏页:纯色占满 + 居中提示;点任意处 / 左缘左滑(SDK on_swipe)返回 */ meow_ui_clear(th->accent); meow_ui_text_center(240, 330, "FULLSCREEN ACTIVE", 28, 0xFFFFFF); meow_ui_text_center(240, 366, "tap anywhere = back to home", 20, 0xFFFFFF); meow_ui_text_center(240, 394, "(left-edge swipe also returns)", 20, 0xFFFFFF); meow_ui_flush(); return; } meow_ui_clear(th->bg); meow_ui_text_center(240, sb + 8, "MEOWOS HELLO", 28, th->fg); meow_ui_text_center(240, sb + 38, "SDK: meow_ui.a", 20, th->dim); meow_widget_draw(g_btn); meow_ui_text_center(240, 372, "tap = send notification (see log)", 20, th->dim); for (int i = 0; i < 6; i++) meow_widget_draw(g_nbtn[i]); meow_widget_draw(g_cancel); meow_widget_draw(g_fs_btn); char line[64]; snprintf(line, sizeof line, "taps=%d uptime=%ds", g_taps, g_secs); meow_ui_text_center(240, 516, line, 20, th->dim); meow_ui_text(20, 660, "left-swipe = exit", 20, th->dim); meow_ui_flush(); } static void on_tap(int x, int y) { if (g_fullscreen) { /* 全屏页:点任意处退出回主界面(左缘左滑由 SDK on_swipe 处理,见下) */ set_fullscreen(0); redraw(); return; } for (int i = 0; i < 6; i++) { if (meow_widget_hit(g_nbtn[i], x, y)) { notif_send(i); redraw(); return; } } if (meow_widget_hit(g_cancel, x, y)) { notif_cancel(); redraw(); return; } if (meow_widget_hit(g_fs_btn, x, y)) { set_fullscreen(1); redraw(); return; } if (meow_widget_hit(g_btn, x, y)) { g_taps++; snprintf(g_btn_label, sizeof g_btn_label, "TAPPED x%d", g_taps); /* 重建按钮标签(release 旧控件,重新 create 保持几何) */ meow_widget_free(g_btn); g_btn = meow_btn_create(120, 300, 240, 64, g_btn_label); redraw(); } } static void on_key(int keycode, int is_down) { /* §3.4.1:物理键语义由系统统一管理,APP 禁映射(电源=息屏/亮屏、音量=调音量、播放=媒体)。 * 这里仅记录日志,不做任何 exit/confirm 行为。 */ (void)keycode; (void)is_down; meow_log(MEOW_LOG_DEBUG, "key"); /* 不处理:SDK 内部消化系统键语义 */ } static void on_swipe_progress(int x_start, int dx) { /* 左滑过程实时回调:SDK 已自动画顶部进度条;这里演示 app 侧接入(画同长度条,幂等—— * 长度=当前 X=x_start+dx,与 SDK 自动画一致,不会误清条)。 * 抬手达标时 SDK 清条 + 触发 on_swipe(LEFT)→退出。 */ meow_ui_swipe_hint(x_start + dx); } static void on_swipe(int dir, int dx, int dy) { (void)dx; (void)dy; if (dir == MEOW_SWIPE_LEFT) { /* §6.1 导航栈语义:非根(全屏)→ 左滑返回主页(pop),不退出;根 → 退出回应用列表。 * 保证 on_swipe(LEFT) 在沉浸页=退出全屏回主页,而非直接退出整个 app。 */ if (g_fullscreen) { set_fullscreen(0); redraw(); } else { meow_log(MEOW_LOG_INFO, "exit:swipe"); meow_ui_request_exit(); } } } static void on_tick(void) { /* 每秒刷新一次状态行(避免 16ms 高频重绘) */ static uint64_t last = 0; uint64_t now = meow_ui_time_ms(); if (now - last >= 1000) { last = now; g_secs++; redraw(); } } int main(void) { meow_log(MEOW_LOG_INFO, "start"); meow_ui_opts o = { 480, 720 }; if (meow_ui_init(&o) != 0) { meow_log(MEOW_LOG_ERROR, "init failed"); return 1; } /* M2.46 不再强制 set_mode 深色——主题跟随系统 display.theme/theme_mode(manual/auto+时段), * 与 launcher s_ui_theme() 判定对齐(meow_theme_get() 已读 settings.conf)。 */ meow_theme_add_listener(NULL); /* noop: 预留主题变化重绘 */ signal(SIGTERM, on_sigterm); /* 看门狗返回键 → 干净退出 */ g_btn = meow_btn_create(120, 300, 240, 64, g_btn_label); for (int i = 0; i < 6; i++) g_nbtn[i] = meow_btn_create(3 + i * 80, 400, 74, 56, g_notif_labels[i]); g_cancel = meow_btn_create(36, 464, 200, 42, "CANCEL LAST"); g_fs_btn = meow_btn_create(244, 464, 200, 42, "FULLSCREEN"); redraw(); meow_ui_events ev = { on_key, on_tap, on_swipe, on_tick, on_swipe_progress }; meow_ui_run(&ev); for (int i = 0; i < 6; i++) meow_widget_free(g_nbtn[i]); meow_widget_free(g_cancel); meow_widget_free(g_fs_btn); meow_widget_free(g_btn); meow_ui_shutdown(); meow_log(MEOW_LOG_INFO, "exit"); return 0; }