openim_sdk

2.7.0 (2026-09-03)

Features

• update dependencies in pubspec.yaml to latest versions (06cb5c2)

2.6.0 (2026-08-28)

Features

• migrate to worker_manager for L2 CPU helpers, enhancing performance and removing web worker dependency. Update changelog and documentation accordingly. (04ce10d)

Bug Fixes

• 修复 pub.dev 平台得分（支持 Android、iOS、Web、Windows、macOS、Linux 全部 6 大平台）
• 隔离 Web 与 Native 平台的条件导入，解决 dart:io 与 dart:js_interop 的静态检测冲突
• 在 pubspec.yaml 中添加显式 platforms 声明并修复依赖约束

2.5.1 (2026-06-04)

Bug Fixes

• remove unused synchronized dependency from pubspec.yaml (cf23214)

2.5.0 (2026-05-04)

Features

• 升级tostore 的版本到 3.1.2，以修复在 Linux 中闪退的问题 (ae11d25)

2.4.2 (2026-05-01)

Bug Fixes

• 优化未读消息计数逻辑并统一触发未读总数变更 (0dd3fab)

2.4.1 (2026-05-01)

Bug Fixes

• 优化未读消息计数逻辑并统一触发未读总数变更 (4269f9a)
• 移除未使用的 getAtAllTag 方法并更新依赖版本 (83f13af)

2.4.0 (2026-04-26)

Features

• 添加举报和处理 (3b94496)
• 添加账号注销 (e9cebbf)

Bug Fixes

• 优化线程问题 (de012a9)

2.3.0 (2026-04-26)

Features

• 修复搜索不准确问题 (8d96fc5)

2.2.1 (2026-04-20)

Bug Fixes

• the problem that the token field in the CallSession class is missed during serialization (147b445)

2.2.0 (2026-04-20)

Features

• 🚀 Cross-platform multithreading via isolate_manager (be079fc)

2.1.0 (2026-04-19)

Features

• 添加 runInDatabase 方法，可以在数据库实例中运行自定义的查询修改。 (a247276)

2.0.2 (2026-04-17)

Bug Fixes

• fix video message bugs (f42f980)

Bug Fixes

• 修复文档发布 2.0.0版本 (8536303)

• add updateNote method in FavoriteManager to update note content and refresh favorite item.

🚀 Background Isolate Architecture

All SDK Future methods (~160 methods across 10 managers) now run in a dedicated background Isolate, keeping the UI thread completely free from database I/O, network serialization, and protobuf parsing.

• New Isolate infrastructure — Added 4 core files:
  • SdkIsolateManager — Singleton lifecycle manager, gates Isolate vs local execution via isActive
  • SdkIsolateEntry — Background Isolate entry point, receives (RootIsolateToken, SendPort) tuple
  • SdkMethodDispatcher — 1400+ line switch-based dispatcher routing all 10 managers' methods
  • SdkIsolateProtocol — Request/response envelope types for cross-Isolate communication
• All 10 managers proxied — IMManager, ConversationManager, MessageManager, GroupManager, UserManager, FriendshipManager, MomentsManager, FavoriteManager, CallManager, RedPacketManager
• Listener event forwarding — All listener callbacks (connect, message, conversation, group, friendship, user, moments, favorite, call, red packet, custom business, upload progress) are serialized across the Isolate boundary and re-dispatched on the main Isolate
• Transparent activation — Call SdkIsolateManager.initialize() before initSDK to enable; omit it to run entirely on the main thread as before

🐛 Bug Fixes

• Fixed isInitialized always returning false in Isolate mode — Added _initialized field to track state across Isolate boundary
• Fixed .toJson() serialization crashes — Manually fixed 55 nested .toJson() calls across 4 .g.dart files where generated code produced incorrect output
• Fixed _currentUserID LateInitializationError — All 5 login paths (login, loginByEmail, loginByPhone, loginByAccount, loadLoginConfig) now properly initialize _currentUserID on every manager via _setManagersUserID()
• Fixed infinite Isolate recursion — Background Isolate no longer recursively spawns itself when SdkIsolateManager.isActive is true inside the Isolate
• Fixed BackgroundIsolateBinaryMessenger crash — Platform channel calls (path_provider) are resolved on the main Isolate before entering the background Isolate
• Fixed duplicate ToStore registration — Removed getDatabaseInstance() as public API, added KV proxy methods (getValue/setValue/removeValue/getSpaceInfo) through the Isolate boundary
• Fixed video message display issues — Video messages now show thumbnails and play correctly:
  • Changed enableHardwareAcceleration to true on non-Linux platforms (fixes mpv software renderer crash)
  • Fixed createSnapshot to reliably capture first frame by playing with volume 0 and waiting for stream dimensions
  • Added try-catch to video upload branch in _handleMediaUploadIfNeeded
• Fixed build.yaml — Changed from wildcard generate_for to explicit file list to work with analyzer 10.0.0

📦 New Models

• CallSession — Call session model with toJson()/fromJson() support
• MomentCreateReq — Moment creation request model with toJson()/fromJson() support
• Added fromJson factories to SendRedPacketRequest, RedPacketDetail, and PointsTransaction

• add changePassword and resetPassword method.
• update tostore version

• Red packet grab notification refactored: BusinessNotification → real IM custom message: Grab notifications are no longer pushed as BusinessNotification "phantom messages". The backend now sends a real IM custom message (contentType=110, description="redPacketGrabNotify") into the conversation after a successful grab, appearing as a visible grab-notification bar in chat history.
• Added RedPacketGrabNotifyMessageData model: Parses the server-sent grab notification message, containing packetID, grabberID, grabberName, grabberFaceURL, senderID, senderName, amount fields.
• Removed RedPacketGrabbedNotify model: Previously used for BusinessNotification-based grab events, now replaced by RedPacketGrabNotifyMessageData.
• Simplified OnRedPacketListener: Removed onRedPacketGrabbed callback; only onRedPacketExpired and onPointsBalanceChanged remain.
• Simplified RedPacketManager.dispatchBusinessNotification: Removed red_packet_grabbed branch; only red_packet_expired and points_adjusted handling remains.
• Red packet & points system: Added RedPacketManager, encapsulating send/grab/detail APIs and points balance queries.
• Model expansion: RedPacketGrabInfo / RedPacketDetail / RedPacketGrabbedNotify gained nickname and faceURL fields, including user avatar info in grab records.
• IMManager integration: redPacketManager added as a standard field in IMManager, consistent with other managers; onPointsBalanceChanged callback fires automatically on balance changes.
• Refactor: Removed OpenIM.redPacketManager shortcut, unified to OpenIM.iMManager.redPacketManager.
• Offline message pull: N per-message callbacks → 1 batch callback (msg_syncer.dart, message_manager.dart, advanced_msg_listener.dart): Aligned with Go SDK batchNewMessages design: _processPulledMsgs no longer triggers onRecvOfflineNewMessage for each message in the same conversation one by one, now fires the new onRecvOfflineNewMessages(List<Message>) batch callback in a single call.
• Empty senderNickname in search results (notification_dispatcher.dart, msg_syncer.dart, user_manager.dart, database_service.dart): Aligned with Go SDK UpdateMsgSenderFaceURLAndSenderNickname: when the user's own info (nickname/avatar) changes, retroactively updates senderNickname/senderFaceUrl for all messages in the local database.
• WebSocket push messages not storing senderFaceUrl (_msgDataToMap in msg_syncer.dart): Map key used 'senderFaceURL' (uppercase L) which mismatched the DB column senderFaceUrl (lowercase l), preventing avatar URLs from being written to the database. Fix: changed key to 'senderFaceUrl' to align with DB schema.
• Incorrect searchLocalMessages results (_searchFilterWorker in sdk_isolate.dart): Original implementation performed fuzzy keyword matching on the entire content JSON string, causing number searches to hit image dimensions, file path sequences, and server URL IDs. Fixed to search specific fields by contentType, aligned with Go SDK filterMsg logic:
  • Text (101): search textElem.content only
  • @message (106): search atTextElem.text only
  • File (105): search fileElem.fileName only
  • Merge (107): search mergeElem.title only
  • Card (108): search cardElem.nickname only
  • Location (109) / Custom (110): search description only
  • Quote (114): search quoteElem.text only
  • Image (102) / Voice (103) / Video (104): excluded when keyword is present