# AMPSTest **Repository Path**: adscope_admin/AMPSTest ## Basic Information - **Project Name**: AMPSTest - **Description**: No description available - **Primary Language**: Objective-C - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-06-04 - **Last Updated**: 2026-11-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # AMPSTest (iOS) AMPS 聚合 SDK 调试测试工具(二进制分发)。 本仓库同时提供两种分发方式:**CocoaPods**(podspec)与 **Swift Package Manager**(Package.swift)。 > AMPSTest 须直接依赖在最终 App Target(非仅静态库 Target)。宿主须 Debug 编译。 --- ## 一、Swift Package Manager ### Xcode 接入 1. File → Add Package Dependencies… → **Add Package…** 2. 填入仓库地址: ``` https://gitee.com/adscope_admin/AMPSTest.git ``` 3. Version 选择 `1.0.12` 4. **⚠️ 对话框底部的「Add to target(s)」必须勾选你的 App target** —— 不勾只是「引用」了包,没有「使用」,target 里不会有它的头搜索路径, `#import ` 会报 file not found。 5. 业务代码中引用: ```objc #import AMPSTestAPI *api = [AMPSTestAPI shared]; NSLog(@"%@", [api ampsTestVersion]); ``` > 自查包是否真的挂上了: > ```bash > grep -c "XCSwiftPackageProductDependency" <工程>.xcodeproj/project.pbxproj # 应 ≥ 1 > ``` ### Package.swift 接入 ```swift dependencies: [ .package(url: "https://gitee.com/adscope_admin/AMPSTest.git", from: "1.0.12") ], targets: [ .target(name: "MyApp", dependencies: [ .product(name: "AMPSTest", package: "AMPSTest") ]) ] ``` ### 注意事项 - 消费端 App target 的 Other Linker Flags 建议加 `-ObjC`(静态库链接时 Category 可能被裁剪)。 - 本包最低支持 iOS 12。 - AMPSTest 对聚合 SDK 是**运行时依赖**(二进制内无 AMPSAdSDK 编译期符号),因此 SPM 接入时无需声明依赖; 但要真正跑通广告调试功能,宿主 App 仍需集成 AMPSAdSDK 及其渠道适配器。 - 换了版本号后若仍解析到旧版本,清一下缓存: ```bash rm -f <你打开的 workspace>/xcshareddata/swiftpm/Package.resolved rm -rf ~/.swiftpm/cache ~/Library/Caches/org.swift.swiftpm \ ~/Library/Developer/Xcode/DerivedData/*/SourcePackages ``` --- ## 二、CocoaPods ```ruby pod 'AMPSTest', :git => 'https://gitee.com/adscope_admin/AMPSTest.git', :tag => '1.0.12' ``` > 该 podspec 依赖 `AMPSAdSDK`,请确保宿主工程能解析到该依赖。 --- ## 三、版本对照 | SPM 版本 | CocoaPods 版本 | |----------|----------------| | 1.0.12 | 1.0.12 | > SPM 版本号要求三段 semver;本仓库当前 pod 版本本身就是三段,两个通道共用同一个 tag。 --- ## 四、产物说明 ``` AMPSTest.xcframework/ # CocoaPods 通道(目录形态) spm-artifacts/AMPSTest.xcframework.zip # SPM 通道(zip 形态) Package.swift # SPM 清单 Sources/AMPSTest/include/Placeholder.h ``` zip 必须是干净的(不含 `__MACOSX` 冗余条目),生成方式: ```bash zip -r -X AMPSTest.xcframework.zip AMPSTest.xcframework swift package compute-checksum AMPSTest.xcframework.zip # 结果要同步写进 Package.swift ``` 产物变更后必须更新 `Package.swift` 里的 `checksum`,否则 SPM 会校验失败。 > `Package.swift` 里 binaryTarget 的 url 指向**本版本 tag**(`raw/1.0.12/...`)而不是 `master/`, > 这样产物与 checksum 才是不可变的一对。 --- ## 五、相关文档 | 文档 | 内容 | |------|------| | `Docs/SPM接入指南-客户端.md` | 接入方完整指南:Xcode 接入 + 5 类「加上了却用不了」的原因与自查 | | `Docs/AMPS-SDK分发方案-pod与SPM.md` | pod 私有源与 SPM 两种通道的对比与选型 |