MeowOS
4534b840c2
- meow_ui.h（922 行）改为伞头：只做 #include 聚合 + 模块索引，不定义新 API。 - 新增 patch_v2/sdk/include/ 16 个子头（types/draw/image/theme/ime/widgets/input/ activity/zorder/statusbar/dialog/log/notify/config/font/audio），各自自洽可单独 include， 依赖最小化（不透明句柄前向声明 + 必要模块互引）。 - 验证：meow_ui.a md5 与主树完全一致（4786158d…，头重组 .o 逐字节等价）； SDK .c 用 mipsel -Wall -Wextra 0 warning；hello/files 全量重编链接通过 （-Wall -Wextra 0 warning）；宿主 test_p1p2p3_repro(P1c/P2/P3 ALL PASS) + 15 个 SDK/宿主测试 PASS；16 子头自洽编译 0 warning；伞头完整性回归 test_umbrella.c 0 warning；ncm 5 个含 meow_ui.h TÜ mipsel 交叉编译到 .o 0 warning。 - meow_ui_internal.h 及 view/nav/media/sys/vol 子头未动；build_sdk.sh 无需改。 - MEOW_APP_SDK.md 头部新增「公共头模块索引」。分支 sdk-header-split。
54 lines
3.5 KiB
C
54 lines
3.5 KiB
C
/*
|
||
* meow_ui_config.h — SDK 应用配置读写（§9.2，meow_config_*，M2.x 最小可用版）。
|
||
*
|
||
* 原 meow_ui.h 拆分的一部分（config 模块）。App 自有配置读写：与系统设置 meow_settings_*
|
||
* （板载 settings.conf、系统级、带 schema）明确区分——这是单个 App 自己的键值偏好，
|
||
* 落 TF 数据目录，不占板载、无 schema。返回码 MEOW_CFG_* 见下。
|
||
*/
|
||
#ifndef MEOW_UI_CONFIG_H
|
||
#define MEOW_UI_CONFIG_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/* meow_config_*（§9.2）专用返回码。数值与 MEOWOS_API.md §1 的同名错误码一致，
|
||
* 但用 meow_cfg 前缀——因为 MEOW_OK/MEOW_ERR_* 这个命名空间已被共享协议头
|
||
* meow_ipc.h（枚举）与 launcher meow_settings.h（宏）占用，SDK 的 meow_notify_ipc.c
|
||
* 同 TU include meow_ui.h + meow_ipc.h，若在此定义同名宏会导致「宏展开枚举标识符」冲突。 */
|
||
#define MEOW_CFG_OK 0 /* 成功 */
|
||
#define MEOW_CFG_ERR_INVAL -1 /* 参数/取值非法（空 key、NULL out、outsz<=0 等） */
|
||
#define MEOW_CFG_ERR_NOENT -2 /* 键未设/文件不存在 */
|
||
#define MEOW_CFG_ERR_IO -5 /* 读写（存储/文件）失败 */
|
||
#define MEOW_CFG_ERR_NOMEM -6 /* 路径超长 */
|
||
#define MEOW_CFG_ERR_NODEV -10 /* 无数据目录（卡不在/只读/不可建） */
|
||
|
||
/* ============================================================ */
|
||
/* §9.2 应用配置读写（meow_config_*，M2.x 最小可用版） */
|
||
/* ============================================================ */
|
||
/* App 自有配置读写：与系统设置 meow_settings_*（板载 settings.conf、系统级、带 schema）
|
||
* 明确区分——这是单个 App 自己的键值偏好，落 TF 数据目录，不占板载、无 schema。
|
||
*
|
||
* - 数据目录：优先 env MEOW_DATA_DIR（launcher 注入 /usr/data/mnt/sd_0/MeowData/<pkg>/data，
|
||
* 见 app_launcher.c launch_app）；无 env（手动跑/宿主测/无卡）回退 /tmp/meowcfg_<pid>
|
||
* （非持久但仍可写）。meow_config_dir() 返回最终目录；空/不可建返回 NULL。
|
||
* - 文件布局：每键一小文件 <data>/<sanitized_key>.cfg，内容=值字符串（空串=0 字节文件）。
|
||
* key 只允许 [A-Za-z0-9._-]，其余字符替换为 '_'（杜绝路径穿越）；key 上限 64。
|
||
* - 轻量：每次 get 读文件（App 配置小），不做大内存缓存；pthread_once 惰性初始化目录。
|
||
* - 失败降级：无数据目录/写失败 → 返回负错误码（见上 MEOW_CFG_ERR_*），不崩不阻塞。
|
||
*
|
||
* 返回码：MEOW_CFG_OK(0) 成功；(set) 负=失败；(get) MEOW_CFG_ERR_NOENT(-2)=键未设/文件不存在；
|
||
* meow_config_int/bool 对任何非 MEOW_CFG_OK 一律返回 def。
|
||
* 错误码数值同 MEOWOS_API.md §1 / meow_settings_*（MEOW_ERR_*）一致，便于 App 习惯。 */
|
||
const char *meow_config_dir(void); /* 当前 App 数据目录(data)；空/不可建 NULL */
|
||
int meow_config_set(const char *key, const char *val);/* 写 <data>/<key>.cfg；成功 MEOW_CFG_OK(0) */
|
||
int meow_config_get(const char *key, char *out, int outsz); /* 读；未设/不存在返回 MEOW_CFG_ERR_NOENT */
|
||
int meow_config_int(const char *key, int def); /* 便捷 int；未设/非法返回 def */
|
||
int meow_config_bool(const char *key, int def); /* 便捷 bool；未设/非法返回 def */
|
||
void meow_config_remove(const char *key); /* 删键（无该键/无目录则静默） */
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif /* MEOW_UI_CONFIG_H */
|