Retion Mini App cho React Native

Package chạy mini app web trong app React Native: tải bundle, lưu cục bộ, quản lý WebView và cung cấp API native qua bridge chung. Từ 0.8.0, Face ID / Touch ID và nhận dạng giọng nói (từ 0.9.0 thêm vị trí hiện tại, từ 0.10.0 thêm upload file) được xử lý trong package; app chủ không cần gắn handler riêng cho các API này.

Đọc theo thứ tự

1. Cài đặt, cấu hình và mở mini app.
2. Tích hợp API native: Face ID / Touch ID, speech-to-text, vị trí hiện tại và upload file.
3. Nhận dạng giọng nói: quyền, hoạt động, API và quản lý phiên.
4. Face ID / Touch ID: quyền, API và kết quả native.

Ai làm phần nào?

| Thành phần | Trách nhiệm | | --- | --- | | App chủ | Cài package, cấu hình quyền và liên kết native, build ứng dụng, cấu hình dữ liệu mini app và mount MiniAppHost | | Mini App React Native | Tải/chạy mini app; thực hiện xác thực sinh trắc học, lấy vị trí, chọn và upload file, xin quyền speech/vị trí, quản lý micro và chuyển kết quả/event về đúng WebView | | Web SDK @retion-miniapp/sdk | Cung cấp API Promise và đăng ký event cho mini app web | | Mini app web | Gọi API khi người dùng thao tác, kiểm tra kết quả/lỗi và cập nhật giao diện |

Cài package không sửa được binary đã cài trên thiết bị. Nếu binary thiếu module native hoặc khai báo quyền, phải build và cài lại app; OTA hoặc reload JavaScript không bổ sung được các phần này. Expo Go không dùng để thử hai tính năng native trên.

Phiên bản và điều kiện tích hợp

Tài liệu hiện tại mô tả Mini App React Native 0.10.1 + Web SDK 0.10.0. Package khai báo React ≥18, React Native ≥0.72, Expo ≥52 và WebView ≥13; đây là giới hạn khai báo, không phải cam kết mọi tổ hợp phiên bản native đã được kiểm tra. App React Native thuần cần tích hợp Expo Modules để dùng thư viện speech.

Package tự cài [email protected], [email protected], @react-native-community/[email protected], [email protected], @react-native-documents/[email protected] và [email protected]. Nếu app cũng dùng các thư viện này cho chức năng khác, đồng bộ phiên bản để tránh trùng module native. Với Expo 57, xem lưu ý bản vá của thư viện speech trong hướng dẫn speech.

Trong lúc bản mới chưa phát hành lên npm, có thể dùng package local để thử. Trước khi phát hành app từ CI hoặc chia sẻ dự án độc lập, chuyển dependency file:../... về phiên bản npm đã publish và cập nhật lockfile.