FunBox ProSEStudio

Một mã nguồn cho Android và iOS với Compose Multiplatform

WIIC, Cờ Tướng AIỨng dụng
Android, iOSNền tảng
Kotlin Multiplatform, Compose MultiplatformCông nghệ

Với một nhóm nhỏ, duy trì hai mã nguồn riêng cho Android và iOS nghĩa là làm mỗi tính năng hai lần và sửa mỗi lỗi hai lần. Với các ứng dụng cần sức mạnh của điện thoại, chúng tôi chọn Kotlin Multiplatform và Compose Multiplatform để viết một lần, chạy trên cả hai nền tảng.

Kiến trúc

Mã nguồn được chia lớp rõ ràng, phần lớn nằm trong mã dùng chung:

LớpNội dungDùng chung?
Giao diệnMàn hình viết bằng Compose MultiplatformCó
Trạng thái và logicViewModel; Cờ Tướng AI theo mô hình MVI: mỗi màn hình có một trạng thái duy nhất, sự kiện người dùng đi một chiềuCó
Dữ liệuLưu trữ cục bộ (Room), cài đặt, tiến độCó
Nền tảngCamera, xử lý video, thanh toán, engine C++Mỗi nền tảng một phần nhỏ, nối qua giao diện chung

Vì logic và trạng thái nằm trong mã dùng chung, cùng một luồng xử lý chạy giống nhau trên Android và iOS, nên khi sửa một lỗi logic, cả hai bản được sửa cùng lúc.

WIIC: xử lý video ngay trên điện thoại

Chế độ Dual của WIIC quay camera trước song song với màn chơi, áp bộ lọc 2D rồi ghép thành video. Vòng chơi (hiện ảnh, đọc câu hỏi, đếm ngược, đọc đáp án) là logic dùng chung; phần camera và ghép video nằm ở lớp riêng của từng nền tảng vì phải dùng API của từng hệ điều hành. Toàn bộ video được xử lý trên máy, không gửi lên máy chủ.

Cờ Tướng AI: engine C++ trong ứng dụng Kotlin

Engine Pikafish (mạng nơ-ron NNUE) và Pikafish-Jieqi được viết bằng C++. Thay vì chạy engine trên máy chủ, chúng tôi nhúng thẳng vào ứng dụng: trên Android qua JNI, trên iOS qua Kotlin/Native cinterop. Phần còn lại, gồm luật chơi, bàn cờ, chế độ chơi và phân tích ván, là mã Kotlin dùng chung. Kết quả là ứng dụng chơi được hoàn toàn ngoại tuyến trên cả hai nền tảng.

Bài học

  • Chia sẻ logic trước, giao diện sau. Logic dùng chung mang lại lợi ích lớn nhất; giao diện dùng chung là phần thưởng thêm khi Compose Multiplatform đủ ổn định.
  • Giữ phần riêng của từng nền tảng thật mỏng. Camera, video, thanh toán và engine C++ nằm sau một giao diện chung nhỏ, phần còn lại không cần biết đang chạy trên hệ điều hành nào.
  • Hiệu năng native vẫn quan trọng. Engine cờ tính hàng trăm nghìn thế cờ mỗi giây, nên chúng tôi giữ nó ở C++ và chỉ viết lớp nối.

Xem thêm cách chúng tôi làm việc