Linear SDK v38.0.0 发布：重大变更与功能增强

Linear 是一个现代的项目管理和问题跟踪平台，其 SDK 为开发者提供了与 Linear API 交互的能力。最新发布的 Linear SDK v38.0.0 版本带来了一系列重大变更和功能增强，本文将深入解析这些变化。

重大变更解析

移除的类型和字段

此版本移除了多个不再使用的类型和字段，包括：

• AttachmentArchivePayload 类型被移除
• 与项目链接相关的多个类型被移除，包括 ProjectLink、ProjectLinkConnection 等
• 文档和项目搜索结果中的 contentData 和 links 字段被移除
• 用户设置中的 notificationPreferences 和 subscribedToUnreadNotificationsReminder 字段被移除

这些移除反映了平台功能的演进和优化，开发者需要检查自己的应用是否依赖了这些已被移除的功能。

输入类型变更

UserSettingsUpdateInput.notificationChannelPreferences 输入字段的类型从 NotificationChannelPreferencesInput 变更为 PartialNotificationChannelPreferencesInput。这一变更提供了更灵活的偏好设置更新方式。

新增功能与增强

新增类型

SDK 新增了多个类型以支持新功能：

• Meeting 及相关连接类型，支持会议功能
• PostNotification 类型，支持发布通知
• CustomerImport 类型，增强客户数据导入功能

功能增强

1. 继承映射增强：

   • 新增 issueLabels 输入字段到 InheritanceEntityMapping，支持问题标签的继承映射

2. 计划和项目更新提醒：

   • 为 InitiativeUpdateInput 和 ProjectUpdateInput 新增了更新提醒相关字段，包括频率、日期和小时设置

3. 字符串比较增强：

   • 在多个比较器类型中新增了 containsIgnoreCaseAndAccent 字段，支持更灵活的字符串匹配

4. 附件链接功能增强：

   • attachmentLinkIntercom 新增 partId 参数
   • attachmentLinkZendesk 新增 url 参数

其他改进

1. 文档关联：

   • 文档与计划的关联描述从"[Internal]"变为正式功能
   • 文档内容新增 meeting 字段

2. 项目状态统计：

   • ProjectStatusCountPayload 新增 archivedTeamCount 和 privateCount 字段
   • 原有 count 字段描述更改为"总数"

3. 团队结构：

   • 团队新增 children 和 parent 字段，支持层级团队结构

4. 客户需求管理：

   • CustomerNeed.url 字段被标记为弃用，建议使用 attachment.url 替代

迁移建议

对于使用 Linear SDK 的开发者，升级到 v38.0.0 时需要注意：

1. 检查应用中是否使用了已被移除的类型和字段，并进行相应调整
2. 考虑采用新的字符串比较功能来增强搜索体验
3. 对于客户需求管理，迁移到新的附件 URL 方式
4. 利用新增的团队层级功能优化组织结构管理

这个版本的变化反映了 Linear 平台向更结构化、更灵活的方向发展，同时也清理了一些不再推荐使用的功能。开发者可以根据这些变化优化自己的应用集成。