2022年第24周周报喵。
🚀 版本更新/计划
本周中，核心库 发布了
v3.0.0.preview.14.0 ，
并预计很快会再发布 v3.0.0.preview.15.0。
不出意外的话，**v3.0.0.preview.15.0**将会是倒数的 preview 版本了。
🚩 v3.0.0.preview.14.0
这次的更新也是一如既往的 ⚠️不兼容更新。在这次更新中，有一些值得注意的内容。
👉 #319 移除 Bot.friend(...)
移除了 Bot 中默认实现的 Bot.friends 和 Bot.friend(...) api, 取而代之的是 Bot.contacts() 和 Bot.contact(...)。
- Kotlin
- Java
val bot: Bot = ...
- val friends: Item<Friend> = bot.friends
- val friend: Friend = bot.friend(...)
+ val contacts: Item<Contact> = bot.contacts
+ val contact: Contact = bot.contact(...)
Bot bot = ...;
- Item<Friend> friends = bot.getFriends();
- Friend friend = bot.getFriend(...);
+ Item<Contact> contacts = bot.getContacts();
+ Contact contact = bot.getContact(...);
当然，这并不意味着 friends api就此消失了。与**"好友"**相关的api存在于容器接口 FriendsContainer 中，
并可以由组件进行额外实现。
- Kotlin
- Java
val bot: Bot = ...
if (bot is FriendsContainer) {
val friends: Item<Friend> = bot.friends
val friend: Friend = bot.friend(...)
}
Bot bot = ...;
if (bot instanceof FriendsContainer) {
FriendsContainer container = (FriendsContainer) bot;
Item<Friend> friends = container.getFriends();
Friend friend = container.getFriend(...);
}
👉 #320 Objectives 重命名为 Objective
字面意思。
更多变更内容可以前往 v3.0.0.preview.14.0 release 查看。
🎏 v3.0.0.preview.15.0
在 v3.0.0.preview.15.0 中，也有一些需要特别注意的更新内容。
⛔️ 移除 UserStatus
在 v3.0.0.preview.14.0 中的 #328，
我们将 UserStatus 标记过时并准备删除。而在**v3.0.0.preview.15.0** 中，我们将会完成删除工作。
⛔️ 移除 @Filter.or 和 @Filter.and
最终，@Filter 注解中的 or 和 and 最终还是无法打破规则。它们破坏了注解的约定，而Kotlin将会在1.9版本将这种行为标记为错误 。
因此，我们决定删除这两个参数 ———— 实际上，这两个参数也的确没有非常有用的应用场景。
相关原因参考：
更多内容还请关注后续的详细更新日志。