升级 SDK
模板只负责首次创建,后续更新通过 npm 完成:
npm outdated aduoer-wow-sdk
npm install aduoer-wow-sdk@latest
npm test
npm run buildSDK 遵循 SemVer:patch 修复兼容问题,minor 增加兼容能力,major 可能需要迁移。每次升级都应查看 SDK Release/CHANGELOG,并运行本项目测试与文档构建。
0.3.2 能力与方法迁移
歌曲漫游与每日推荐 dailyTracks 使用一致的命名规范
| 项目 | 旧名称 | 新名称 |
|---|---|---|
| capability | trackRoam | roamTracks |
| SDK Adapter 方法 | getTrackRoam() | getRoamTracks() |
| App Adapter 方法 | trackRoam(trackID:) | roamTracks(trackID:) |
源项目升级 SDK 后需要将实现改为 getRoamTracks(),SDK 才会在 /v1/status.data.capabilities 声明 roamTracks。旧能力名和旧 Adapter 方法不再提供
HTTP 路径仍为 GET /v1/track/roam,请求参数和返回的 Track[] 保持不变;GET /v1/track/fm 继续由 SDK 返回 308 永久重定向
搜索能力也在本版本拆分为 searchTracks、searchArtists、searchAlbums、searchPlaylists 和 searchSuggest,SDK 根据各方法独立声明,不再返回聚合的 search。完整能力列表见实现 Adapter
0.2.0 歌曲漫游迁移
SDK 0.2.0 将漫游能力统一为 trackRoam。源项目需要将 Adapter 方法改为 getTrackRoam(),并使用新接口 GET /v1/track/roam。GET /v1/track/fm 由 SDK 保留为 308 永久重定向,源项目无需自行实现兼容路由。
模板自带 .github/dependabot.yml,GitHub 每周检查 aduoer-wow-sdk,并为新版本创建升级 PR。合并前确认 CI 中的测试和构建通过即可。
不要通过覆盖 SDK 路由来保留旧行为;如果平台需要特殊处理,应在 Adapter 或 resolveContext 边界完成。