吴让宇
c5905a5b1e
方向反转：此前 SKILL.md 是「模板渲染产物」、sap-cli 是源；现 sap-cli 归档， sap-cli-skill 承接开发与分发，SKILL.md 回归手工维护的正本。 迁移（来自 sap-cli，共 104 文件）： - tests/ 692 例测试（15 个文件的内联 sys.path 改指 assets/） - openspec/ SDD 规格与归档变更（42 文件） - docs/ 开发文档与 ADT 原理（含 dev/CLAUDE.md、AGENTS.md） - .claude/ rules 副本 + settings.json（供 Claude Code） - .github/ .hermes/ .pre-commit-config.yaml .editorconfig CLAUDE.md - scripts/ 保持仅 setup.py（pack_skill.py 已随旧仓归档，不迁） 修复（迁移暴露的真实缺陷）： - assets/pyproject.toml 的 build-backend 写作 `setuptools.backends._legacy:_Backend`， 该模块在 setuptools 中不存在 → `pip install -e` 从来装不上。改为 build_meta。 实测：临时 venv 安装成功，sap-cli --help 正常列出 31 个命令 - pyproject readme 指向不存在的 assets/README.md（editable 安装会失败）→ 改内联文本 - pyproject urls 改指 sap-cli-skill 机制调整： - .github/workflows/ci.yml 适配 assets/ 布局；顶部注明该工作流仅 GitHub 执行， 本仓在 Gitee 不会自动跑 - pre-commit 增本地测试门禁（Gitee 上真正生效的那道） - .gitignore 合并旧仓完整规则（保留 log/ 下 md 知识库入库，只忽略运行日志） - 大文件上限 100KB→1MB（架构图 512KB） 守卫测试 tests/unit/test_repo_guards.py（10 → 18 例）： - SKILL.md 须记录 parser 全部 CLI 命令 / 铁律 1-5 须为真实小节标题 / 示例不得违反铁律 5 - references/ 规则齐备；.claude/rules 与 references 必须一致（实测抓到一次真实漂移） - VERSION == sapcli.__version__ == README 版本 - 仓内不得再出现 pack_skill.py / skill-src（防废弃流程回潮） 698 tests OK；editable 安装与 CLI 入口经临时 venv 实测通过。 docs/RELEASING.md 重写为单源开发流程。
6.0 KiB
6.0 KiB
title, created, tags
| title | created | tags | ||||
|---|---|---|---|---|---|---|
| SAP ADT 学习笔记总览 | 2026-05-18 |
|
SAP ADT (ABAP Development Tools) 学习笔记
[!info] 关于本系列 本系列笔记深入探讨 SAP ADT 的技术原理，覆盖从底层架构到各项开发功能的实现机制。 参考来源：SAP Help Portal - ADT User Guide
📌 什么是 SAP ADT？
ABAP Development Tools (ADT) 是 SAP 提供的现代化 ABAP 开发工具集，基于 Eclipse 平台构建，使开发者能够在 Eclipse IDE 中进行 ABAP 开发，替代传统的 SAP GUI + SE80 开发模式。
核心特点：
- 客户端/服务器架构 — IDE 作为客户端，SAP 后端作为服务器
- REST API 驱动 — 所有操作通过
/sap/bc/adt/*REST 端点与后端通信 - 多 IDE 支持 — Eclipse（当前） → VS Code（2026年） → 更多 IDE
- 平台无关 — 基于 HTTP(S) 协议，任何平台均可访问
📂 笔记结构
架构与原理
| 笔记 | 说明 |
|---|---|
| sap-cli/01.ADT架构与通信原理 | ADT 的三层架构、REST 通信层、服务发现机制 |
核心功能原理
| 笔记 | 说明 |
|---|---|
| sap-cli/02.查询代码-原理 | 仓库对象搜索、源代码全文搜索、Where-Used 导航 |
| sap-cli/03.修改代码-原理 | 锁定-编辑-解锁-激活工作流、源代码读写 |
| sap-cli/04.检查代码-原理 | 语法检查、ATC 代码质量检查、静态分析 |
| sap-cli/05.提交与传输-原理 | 传输请求管理、传输发布、版本管理 |
实践
| 笔记 | 说明 |
|---|---|
| sap-cli/06.ADT测试代码 | Python 测试脚本：连接验证、服务发现、读取程序源代码 |
| sap-cli/07.ADT代码同步工具 | 完整使用指南：拉取代码、传输请求、推送代码、激活代码 |
测试服务器
ADT url=http://support.learningleader.com.cn:55955/sap/bc/adt?sap-client=100 user=admin2 password=654321 PROGRAM=ZIDTR_IMPORT_ACCOUNTING_ORDER
🔗 关键外部资源
- SAP Help Portal - ADT User Guide
- Behind the Design: How We Transformed the ABAP Development Tools
- End-to-End SAP Automation with ADT REST Services and AI
- Creating an ABAP in Eclipse Plug-in Using the ADT SDK
- abap-adt-api (GitHub) — 开源 ADT REST 客户端
- erpl-adt (GitHub) — ADT REST CLI 和 MCP 服务器
🗺️ 技术栈一览
┌─────────────────────────────────────────────────────┐
│ 开发者 IDE 层 │
│ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │
│ │ Eclipse │ │ VS Code │ │ 自定义 HTTP 客户端│ │
│ │ (ADT插件) │ │ (2026+) │ │ (Python/JS/AI) │ │
│ └─────┬─────┘ └────┬─────┘ └───────┬──────────┘ │
│ │ │ │ │
│ └──────────────┼────────────────┘ │
│ ▼ │
│ ┌─────────────────────┐ │
│ │ REST over HTTP(S) │ │
│ │ /sap/bc/adt/* │ │
│ └─────────┬───────────┘ │
│ ▼ │
│ ┌──────────────────────────────────────────────┐ │
│ │ SAP ABAP 后端服务器 │ │
│ │ ┌─────────┐ ┌─────────┐ ┌───────────────┐ │ │
│ │ │ICF Handler│ │ADT REST │ │ ABAP Runtime │ │ │
│ │ │ (SICF) │ │Framework│ │ (Syntax/ATC) │ │ │
│ │ └─────────┘ └─────────┘ └───────────────┘ │ │
│ │ ┌─────────┐ ┌─────────┐ ┌───────────────┐ │ │
│ │ │Repository│ │Transport│ │ Activation │ │ │
│ │ │ (搜索) │ │ (CTS) │ │ Framework │ │ │
│ │ └─────────┘ └─────────┘ └───────────────┘ │ │
│ └──────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────┘