Chuyển tới nội dung chính

Tương thích và chính sách phiên bản

Trang này liệt kê mọi SDK của Hạ Tầng với phiên bản hiện tại, khoảng phiên bản còn được sửa lỗi, phiên bản giao thức chat mà SDK nói và nền tảng chạy được. Bảng sinh từ sdks/compat.json trong kho mã Hạ Tầng, nguồn duy nhất cho các con số này; cột "Hiện tại" đọc từ manifest của từng gói lúc build tài liệu.

Ma trận hỗ trợ​

Mọi SDK dưới đây nói giao thức chat phiên bản 1. Gateway phát hành theo tháng (YYYY.MM); "Gateway tối thiểu" là bản gateway cũ nhất mà các phiên bản SDK được liệt kê đã được kiểm thử.

SDKGóiTrạng tháiHiện tạiHỗ trợGiao thứcGateway tối thiểuNền tảng
widget.jschat.hatang.dev/widget.jsỔn định—always current (served by the gateway)12026.10Browsers with ES2020 (Chrome 80+, Safari 14+, Firefox 78+, Edge 80+)
@hatang/chat-reactnpm: @hatang/chat-reactỔn định0.1.20.1.x12026.10React 18+; Next.js 14+ (App Router and Pages)
@hatang/sdknpm: @hatang/sdkỔn định0.6.20.6.x12026.10Node 20+; Bun 1.1+; Edge runtimes with fetch (User-Agent reports node/unknown)
hatang (Python)PyPI: hatangỔn định0.1.10.1.x12026.10Python 3.9+ (sync and asyncio, httpx)
hatang_chat (Flutter)pub.dev: hatang_chatỔn định0.6.10.6.x12026.10Flutter 3.32+; Dart 3.8+; iOS 15+; Android 6.0 (API 23)+; macOS 11+; Web; Windows 10+; Linux (secure storage falls back to preferences)
@hatang/chat-react-nativenpm: @hatang/chat-react-nativeỔn định0.4.20.4.x12026.10React Native 0.76+; Expo SDK 52+
iOS (Swift)GitHub: sota-labs/hatang-chat-iosỔn định0.4.10.4.x12026.10iOS 17+; Swift 6 / Xcode 16+; SwiftUI and UIKit (HatangChatViewController)
Android (Kotlin)Maven Central: dev.hatang:chatỔn định0.4.10.4.x12026.10Android 8+ (API 26); Kotlin 1.9+ / 2.x; Jetpack Compose (BOM 2024.12+); View-based apps open the chat through HatangChat.open
WordPress pluginWordPress.org: hatang-chatỔn định0.2.30.2.x12026.10WordPress 6.0+; PHP 7.4+

Đánh số phiên bản​

  • Mỗi gói có phiên bản riêng. Mọi SDK theo semantic versioning và có changelog riêng. Bản phát hành được gắn tag <gói>-v<phiên bản>: sdk-v*, chat-react-v*, chat-react-native-v*, flutter-v*, ios-v*, android-v* và wp-plugin-v*.
  • Trước 1.0, bản minor có thể đổi API. Hiện mọi SDK đều ở 0.x. Một bản minor mới (ví dụ 0.4 lên 0.5) có thể có thay đổi không tương thích, và changelog ghi rõ thay đổi gì, chuyển đổi thế nào. Cột "Hỗ trợ" chuyển sang bản minor mới khi bản đó ra mắt.
  • Kiểm thử tuân thủ trước khi phát hành. Mọi SDK chat chạy cùng bộ kịch bản (C01–C12: bootstrap bằng khoá ứng dụng, xác thực, gửi tin và dedupe, resume và lịch sử, nhận diện và gộp phiên, đang gõ và đã đọc, tải tệp, trạng thái và đánh giá, kết nối lại, giao thức cũ, thẻ, thiết bị và trạng thái ứng dụng) với gateway thật. Muốn phát hành phải chạy qua hết; bộ kịch bản cũng chạy hằng đêm.
  • Bảo mật. Báo lỗ hổng tới [email protected]. Không SDK client nào chứa secret: identity secret chỉ xuất hiện trong đoạn mã HMAC phía server.

Phiên bản giao thức​

Giao thứcRa mắtGatewayGhi chú
12026-102026.10+Giao thức ổn định đầu tiên: auth → ready, send → ack, resume theo seq, nhận diện và gộp phiên, đang gõ, biên nhận đã đọc, tải tệp, thẻ, đăng ký thiết bị

Client nên bỏ qua những gì nó không biết: loại sự kiện hội thoại lạ thì bỏ qua, thẻ có metadata.kind lạ thì hiện như tin thường. Khi gateway không còn phục vụ giao thức của một client, nó đóng socket với mã 4004 và mọi SDK báo lỗi "cần cập nhật ứng dụng" (kịch bản tuân thủ C10). Chi tiết các khung ở Giao thức realtime.

Nền tảng​

SDKTối thiểu
@hatang/sdkNode 20, Bun 1.1, hoặc edge runtime có fetch
@hatang/chat-reactReact 18, Next.js 14
hatang_chat (Flutter)Flutter 3.32 / Dart 3.8; ứng dụng chạy iOS 15 và Android 6.0 (API 23)
@hatang/chat-react-nativeReact Native 0.76, Expo SDK 52
iOS (Swift)iOS 17, Swift 6 / Xcode 16
Android (Kotlin)Android 8.0 (API 26), Kotlin 1.9, Compose BOM 2024.12
Plugin WordPressWordPress 6.0, PHP 7.4

Bước tiếp theo​

Cập nhật lần cuối vào

Xem trang này dạng Markdown