# 文档导航

本目录承载客户向的核心文档,与代码并行交付。

## 接入方式选择

| 你的场景 | 入口文档 | 难度 |
|----------|----------|:----:|
| **从零开始，想要最快集成** | [usage-guide.md §1 容器模式](./usage-guide.md#1-新用户容器模式推荐最快接入) | ⭐ |
| **想嵌入自有布局（tab 页签 / BottomSheet 等），顶栏 / 进度条 / 错误页自绘** | [usage-guide.md §1.5 组件模式](./usage-guide.md#15-组件模式嵌入自定义布局) | ⭐⭐ |
| **已有自有 WebView，想叠加 SDK 能力** | [usage-guide.md §2 配置模式](./usage-guide.md#2-老用户配置模式在自有-webview-上叠加能力) | ⭐⭐ |
| **不能使用 SDK，自己实现所有配置** | [usage-guide.md §3 自行适配](./usage-guide.md#3-自行适配不依赖-sdk自己完成-webview-配置) | ⭐⭐⭐⭐ |
| **UniApp web-view** | [qianuni-uniapp-guide.md](./qianuni-uniapp-guide.md) | ⭐ |

> 上述入口均覆盖 **Android（Kotlin / Java）/ iOS（Swift / Objective-C）/ HarmonyOS（ArkTS）** 三端，按需查阅对应小节。

## 文档总览

| 文件 | 用途 |
|---|---|
| [usage-guide.md](./usage-guide.md) | **新用户 / 组件嵌入 / 老用户 / 自行适配** 四合一使用指南（三端） |
| [qianapp-protocol.md](./qianapp-protocol.md) | `qianapp://` 协议规范(跨端唯一权威规范) |
| [integration-checklist.md](./integration-checklist.md) | 三端接入自检清单(Android / iOS / HarmonyOS 必备权限、配置、Demo 跑通) |
| [troubleshooting.md](./troubleshooting.md) | 排错决策树 + 已踩坑速查 + FAQ |
| [qianuni-uniapp-guide.md](./qianuni-uniapp-guide.md) | UniApp web-view 接入(纯文档,无需 SDK) |

> **首次接入客户**:建议先走 [usage-guide.md](./usage-guide.md) 确定集成方式 → 对照 [integration-checklist.md](./integration-checklist.md) 配置权限 → 打开自检页验证 → 正式接入。
