工作区

English

本仓库包含技能（Skills）与参考文档，用于 iOS 开发、百度地图 SDK 集成等场景。

技能索引

技能	路径	说明
百度地图 iOS SDK	skills/baidu-map-ios-sdk/	BaiduMapKit、BMKLocationKit、BaiduWalkNaviKit 集成与开发规范；地图、定位、步骑行导航、检索、路线、标注与覆盖物。详见下方「百度地图 SDK」与 SKILL.md。
iOS 编译	skills/ios-build/	通过 xcodebuild 编译 iOS 工程，适用于本地构建、脚本、CI/CD。关键词：iOS 编译、构建、build。详见 SKILL.md。
iOS 空工程	skills/ios-empty-project/	从零创建最小化 iOS 项目结构，直接生成 .xcodeproj，支持 Swift（SwiftUI/UIKit）与 Objective-C（UIKit）。关键词：iOS 空工程、新建 App、脚手架。详见 SKILL.md。

---

百度地图 SDK（baidu-map-ios-sdk）

提供百度地图 iOS SDK、定位、步骑行导航的集成与开发规范。

使用时机

• 地图展示、定位（单次/连续/后台）、步骑行实时导航
• 检索（Sug、POI、地理编码）、路线算路与画线、标注与覆盖物
• CocoaPods 集成、Info.plist、隐私、Launch Screen、BD09 坐标系

文档索引（references）

文档位于 skills/baidu-map-ios-sdk/references/：

主题	文档
选文档与边界	reference.md
CocoaPods 与 Podfile	cocoapods.md
工程配置、隐私、Launch Screen	project-config.md
定位与鉴权	location.md
地图视图	mapview.md
标注与点聚合	annotations.md
覆盖物、Marker、轨迹	overlays.md
UI 规范（Logo、padding、路线视野）	ui-standards.md
检索（建议词、POI、地理编码）	search.md
路线检索与画线（BMKRouteSearch）	route.md
步骑行导航	navi.md
工具（坐标转换、几何）	utils.md
资源（图标、纹理）	assets.md
类速查	class-index.md

快速开始

1. 按需在 reference.md 中选择文档。
2. CocoaPods：地图 pod 'BaiduMapKit'，定位 pod 'BMKLocationKit'，步骑行 pod 'BaiduWalkNaviKit'。见 cocoapods.md。
3. 在百度 LBS 控制台申请 iOS AK，Bundle Identifier 与工程一致；Info.plist 配置 CFBundleDisplayName、定位权限、Launch Screen。见 project-config.md。
4. 首次使用前需用户同意隐私政策，再调用 [BMKMapManager setAgreePrivacy:YES] 并初始化 SDK。

---

iOS 编译（ios-build）

• 何时用：需要编译 iOS 工程、跑 xcodebuild、做 CI/CD 或提到「iOS 编译 / 构建 / build」时。
• 要点：CocoaPods 工程必须用 .xcworkspace；纯工程用 .xcodeproj。常用命令示例见 skills/ios-build/SKILL.md。

---

iOS 空工程（ios-empty-project）

• 何时用：需要从零创建 iOS 工程、新建 App、搭脚手架或提到「iOS 空工程」时。
• 要点：直接生成 .xcodeproj/project.pbxproj，无需 XcodeGen；支持 SwiftUI、UIKit（Swift/OC）；UIKit 工程必须含 LaunchScreen.storyboard。模板与目录约定见 skills/ios-empty-project/SKILL.md.

---

目录结构

ios-sdk-skills/
├── README.md                 # 本文件（中文）
├── README_EN.md              # English README（待生成）
├── CHANGELOG.md              # 变更日志（待生成）
└── skills/
    ├── baidu-map-ios-sdk/
    │   ├── SKILL.md          # Skill 定义文件
    │   └── references/       # API 文档、开发指南、资源文件
    ├── ios-build/
    │   ├── SKILL.md          # Skill 定义文件
    │   └── reference.md      # 参考文档
    └── ios-empty-project/
        ├── SKILL.md          # Skill 定义文件
        └── reference.md      # 参考文档

使用方式

1. 克隆本仓库

git clone <本仓库地址>
cd ios-sdk-skills

2. 从 Release 下载（可选）

你也可以直接从 Release 下载附件 ios-sdk-skills.zip，然后解压使用：

unzip ios-sdk-skills.zip
cd skills

3. 将 Skill 注册到你的 AI 助手

把 skills/ 目录下的 baidu-map-ios-sdk、ios-build、ios-empty-project 链接或复制到当前环境对应的 skills 目录，这样 AI 在对话时会自动读取这些文档。

Claude Code（本地）

• Skills 目录一般为：~/.claude/skills/
• 注册（软链，推荐）：

  ln -sfn "$(pwd)/skills/baidu-map-ios-sdk" ~/.claude/skills/baidu-map-ios-sdk
  ln -sfn "$(pwd)/skills/ios-build" ~/.claude/skills/ios-build
  ln -sfn "$(pwd)/skills/ios-empty-project" ~/.claude/skills/ios-empty-project

• 或直接把 skills/ 下的文件夹复制到 ~/.claude/skills/ 下。

Cursor

• Skills 目录一般为：~/.cursor/skills-cursor/
• 注册（软链，推荐）：

  ln -sfn "$(pwd)/skills/baidu-map-ios-sdk" ~/.cursor/skills-cursor/baidu-map-ios-sdk
  ln -sfn "$(pwd)/skills/ios-build" ~/.cursor/skills-cursor/ios-build
  ln -sfn "$(pwd)/skills/ios-empty-project" ~/.cursor/skills-cursor/ios-empty-project

• 或直接把 skills/ 下的文件夹复制到 ~/.cursor/skills-cursor/ 下。

4. 在对话中使用

在支持 Skills 的客户端里，当你的问题涉及「百度地图」「ios 地图 SDK」「MapView」「BaiduMap」「ios 编译」「Gradle 构建」「ios 空工程」等关键词时，助手会优先参考本仓库中对应 Skill 的文档来回答，从而给出更贴合百度地图 ios SDK 的代码与用法。

变更日志

详见 CHANGELOG.md。

许可证

本项目为百度内部项目，仅供授权使用。