OneUI Pro Max

Tinh chỉnh Samsung One UI dành cho người dùng Việt Nam

Giới thiệu

OneUI Pro Max là module tinh chỉnh độc lập cho Samsung One UI, tập trung vào trải nghiệm tiếng Việt, giao diện ứng dụng gần với One UI và các tính năng systemless có thể khôi phục an toàn.

Phiên bản hiện tại: 2.0.0-pro-max

Application ID: io.github.hongducdev.oneuipromax

Điểm nổi bật

• Hiển thị lịch âm trên màn hình khóa và AOD theo cách trình bày của firmware Samsung Việt Nam, ví dụ (13 Th 11 ÂL).
• Giao diện ứng dụng được thiết kế lại theo phong cách One UI, hỗ trợ tiếng Việt và tiếng Anh.
• Cho phép nhập trực tiếp các tệp TTF/OTF do người dùng chọn rồi tạo font hệ thống systemless; không đóng gói font của người dùng trong APK hoặc mã nguồn.
• Tự kiểm tra ký tự tiếng Việt và ánh xạ các độ đậm Light, Regular, Medium và Bold.
• Hỗ trợ các tinh chỉnh System UI, màn hình khóa, AOD, Cài đặt, Điện thoại, Máy ảnh và ứng dụng Samsung.
• Có sao lưu và khôi phục cấu hình trong ứng dụng.

Font hệ thống

Trong Cài đặt → Font hệ thống:

1. Chọn một hoặc nhiều tệp TTF/OTF. Nhấn giữ tệp đầu tiên nếu muốn chọn nhiều tệp.
2. Kiểm tra ánh xạ Light 300, Regular 400, Medium 500 và Bold 700.
3. Cấp quyền Superuser cho OneUI Pro Max trong KernelSU, KernelSU Next, Magisk hoặc APatch.
4. Nhấn Áp dụng font, sau đó khởi động lại thiết bị.

Module font được tạo tại thời điểm người dùng áp dụng, có ID oneuipromax_font. Nếu lần boot thử đầu tiên không hoàn tất, module sẽ tự vô hiệu hóa ở lần boot kế tiếp. Ứng dụng dùng font đóng gói riêng có thể không chịu ảnh hưởng của font hệ thống.

Yêu cầu

• Thiết bị Samsung chạy One UI 5.0 trở lên.
• Android 13 / API 33 trở lên.
• LSPosed hoặc framework tương thích để chạy các hook của OneUI Pro Max.
• Quyền root và trình quản lý module tương thích khi sử dụng font hệ thống hoặc các thao tác yêu cầu root.

Các hook cần được bật đúng phạm vi ứng dụng được OneUI Pro Max đề xuất. Sau khi thay đổi hook, hãy khởi động lại System UI hoặc điện thoại nếu ứng dụng yêu cầu.

Khôi phục khi gặp lỗi boot

Không flash ZIP font của OneUI Pro Max trực tiếp trong recovery. Nếu thiết bị không boot được:

1. Vào TWRP.
2. Tạo tệp disable trong /data/adb/modules/oneuipromax_font/, hoặc xóa thư mục chờ /data/adb/modules_update/oneuipromax_font/ nếu module chưa được áp dụng.
3. Khởi động lại hệ thống.

Biên dịch

Yêu cầu Android SDK 37 và JDK 25. Dùng Gradle Wrapper đi kèm repo:

./gradlew.bat :app:assembleDebug

APK debug được tạo tại app/build/outputs/apk/debug/app-debug.apk.

Nguồn gốc và giấy phép

OneUI Pro Max được phát triển từ mã nguồn OneUIX của SoClear, với điểm bắt đầu upstream tại commit 7b9f8ac. Dự án hiện được đổi tên, phát triển và phát hành độc lập; không phải bản phát hành chính thức của OneUIX hoặc Samsung.

Mã nguồn tiếp tục được phát hành theo giấy phép GNU Affero General Public License v3.0. Lịch sử và danh sách người đóng góp của dự án nguồn có thể được xem tại repo OneUIX nêu trên.

---

English summary

OneUI Pro Max is an independently maintained Samsung One UI customization module focused on Vietnamese localization, an OEM-style lunar date on the lock screen/AOD, a One UI-inspired app interface, and runtime-imported system fonts. User font files are never bundled in this repository or APK.

This project originated from SoClear/OneUIX and remains licensed under the GNU AGPL-3.0.