Skip to content

升级 SDK ​

模板只负责首次创建,后续更新通过 npm 完成:

bash
npm outdated aduoer-wow-sdk
npm install aduoer-wow-sdk@latest
npm test
npm run build

SDK 遵循 SemVer:patch 修复兼容问题,minor 增加兼容能力,major 可能需要迁移。每次升级都应查看 SDK Release/CHANGELOG,并运行本项目测试与文档构建。

0.3.2 能力与方法迁移 ​

歌曲漫游与每日推荐 dailyTracks 使用一致的命名规范

项目旧名称新名称
capabilitytrackRoamroamTracks
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 边界完成。

Released under the MIT License.