cmake可见性和AppArmor示例

cmake/visibility/README.md

@@ -0,0 +1,64 @@
+# CMake target 可见性 Demo（visibility）
+
+> 来自博客 `docs/编程/20-接口可见性.md` §5.2「完整 Demo」。
+> 演示 `target_include_directories` / `target_link_libraries` /
+> `target_compile_definitions` 上 PUBLIC / PRIVATE / INTERFACE 的传播语义。
+
+## 运行
+
+```bash
+cd cmake/visibility
+cmake -B build && cmake --build build
+./build/app
+```
+
+预期输出（终端里是彩色的）：
+
+```
+10:37:06 hello        （绿色）
+bright red            （高亮红 —— PUBLIC 宏 COLOR_ENABLE_BRIGHT 传播到 app 的证据）
+（没有 "leaked!"      —— printer 的 PRIVATE 宏 PRINTER_TIME_FORMAT 被隔离的证据）
+```
+
+## 目录结构
+
+```
+visibility/
+├── CMakeLists.txt
+├── app/
+│   └── main.cpp                  # 最终用户，只认识 printer
+├── color/
+│   ├── public/color/color.h     # 对外 API 头（含 PUBLIC 宏开关 COLOR_ENABLE_BRIGHT）
+│   ├── include/rgb_convert.h    # 内部中间件头，仅库内 .cpp 共享（PRIVATE 目录）
+│   └── src/{color,rgb_convert}.cpp
+├── timeutil/
+│   └── {timeutil.h,timeutil.cpp}           # printer 的私有依赖
+└── printer/
+    ├── public/printer/printer.h # 对外 API 头（引用了 color → color 是 PUBLIC 依赖）
+    └── src/printer.cpp
+```
+
+依赖与可见性一图流：
+
+```
+app ──PRIVATE──> printer ──PUBLIC──> color        ✓ app 能 include color.h、感知 COLOR_ENABLE_BRIGHT
+                    │                  └─(内部) rgb_convert.h   ✗ 外部看不见（include/ 是 PRIVATE 目录）
+                    └────PRIVATE──> timeutil      ✗ app 看不见 timeutil.h
+                    └────PRIVATE 宏 PRINTER_TIME_FORMAT         ✗ 不泄漏给 app
+```
+
+## 验证实验（§5.3）
+
+| # | 操作 | 实测结果 |
+|---|------|---------|
+| 1 | 直接编译运行 | ✅ 输出 bright red，不输出 leaked! |
+| 2 | main.cpp 加 `#include "rgb_convert.h"` | ✅ `fatal error: rgb_convert.h: No such file or directory` |
+| 3 | main.cpp 加 `#include "timeutil.h"` | ✅ `fatal error: timeutil.h: No such file or directory` |
+| 4 | printer 的 `PUBLIC color` 改 `PRIVATE color` | （未跑）printer 自身编译过，app 找不到 color/color.h 报错 |
+
+## 判断口诀
+
+打开自己的公开头文件看一眼：
+- 头文件里 `#include` 了谁 → 那个库 **PUBLIC**
+- 头文件里 `#ifdef` 了哪个宏（宏影响 API 形状）→ 那个宏 **PUBLIC**
+- 只在 .cpp 里出现的库/宏/路径 → **PRIVATE**