Ghi chép Todorant

Cách ứng dụng Android gốc của Todorant lên Google Play trong bốn ngày và giảm 4.5 MB dung lượng

Bản Android Todorant lên Google Play sau 4 bản: lỗi đăng nhập Google, crash R8 khi quét QR và phông chữ không có giấy phép kéo APK từ 3.3 MB lên 7.7 MB.

cập nhật 7 phút đọc

Trong trang này
  1. Todorant trên Android trước tháng 10 năm 2026 là gì?
  2. Vì sao đăng nhập bằng Google bị lỗi ở bản 2.2.1?
  3. R8 đã làm hỏng điều gì ở bản 2.2.2?
  4. Vì sao APK giảm được 4.5 MB ở bản 2.2.3?
  5. Vì sao lại có riêng một bản dựng F-Droid?
  6. Chuyện gì đã xảy ra với 28 quyền truy cập?
  7. Những người dùng thật đầu tiên đã phát hiện ra điều gì?
  8. Những điều tôi sẽ làm giống như vậy ở lần sau

Ứng dụng Android gốc của Todorant đã đi từ bản thử nghiệm đến bản phát hành chính thức trên Google Play trong bốn ngày, từ ngày 13 đến ngày 16 tháng 10 năm 2026, và bản được phát hành nặng 3.26 MB thay vì 7.74 MB. Quá trình đó tốn bốn phiên bản (từ 2.2.0 đến 2.2.3), mỗi bản sửa một vấn đề chỉ lộ ra khi đã thành bản phát hành thật: một dự án Google Cloud bị xóa, một lỗi văng ứng dụng do R8 gây ra, và một bộ phông chữ nặng 4.5 MB mà tôi không được phép phân phối. Dưới đây là toàn bộ câu chuyện kèm các commit tương ứng.

Todorant trên Android trước tháng 10 năm 2026 là gì?

Todorant là ứng dụng quản lý việc cần làm chỉ hiển thị từng việc một và buộc bạn lên kế hoạch lại cho mọi việc quá hạn trước khi làm tiếp. Ứng dụng Android trước đây trên Google Play là bản React Native cũ. Sang tháng 10, tôi thay nó bằng ứng dụng gốc viết bằng Kotlin và Jetpack Compose, đồng bộ qua backend /v2 mới trên một kết nối WebSocket duy nhất. Bản phát hành 2.0.0 ngày 13 tháng 10 là bản dựng đầu tiên, và lúc đó mới chỉ là bản thử nghiệm: Android không cho cập nhật đè một ứng dụng ký bằng khóa khác, nên ai chuyển từ bản Play cũ phải mở bản cũ một lần để đồng bộ xong, gỡ cài đặt rồi cài tệp APK mới. Sau khi đăng nhập, mọi dữ liệu đều tải về lại từ máy chủ.

Vì sao đăng nhập bằng Google bị lỗi ở bản 2.2.1?

Phiên bản 2.1.0 phát hành kèm một lỗi đã biết trước: đăng nhập bằng Google không hoạt động. Lý do khá đơn giản. Dự án Google Cloud đứng sau client đăng nhập đã bị xóa, nên mọi lần thử đều kết thúc bằng lỗi deleted_client. Bản sửa ở 2.2.1 ngày 14 tháng 10 tạo một dự án Google Cloud mới với web client (địa chỉ chuyển hướng https://todorant.com/google_login_result) cùng các Android client cho cả khóa tải lên (upload key) lẫn khóa ký của Play (Play signing key). Chi tiết thứ hai này rất quan trọng: Play ký lại ứng dụng của bạn, nên cơ chế đăng nhập phải biết cả hai dấu vân tay, nếu không nó sẽ chạy ngon trên bản thử nghiệm nhưng hỏng với mọi người dùng cài từ cửa hàng.

Cũng chính bản phát hành đó đã gỡ bỏ tính năng đồng bộ Google Calendar. Nó đã ngừng hoạt động từ trước, và màn hình Tích hợp chứa nó cũng không còn nữa.

R8 đã làm hỏng điều gì ở bản 2.2.2?

Báo cáo trước khi phát hành của Google Play đã chạy thử bản 2.2.1 trên các thiết bị kiểm thử và phát hiện ứng dụng bị đóng ngay khi quét mã QR. Đăng nhập bằng QR là cách bạn đăng nhập trên thiết bị mới bằng việc quét mã hiển thị trên ứng dụng web, nên đây không phải một tính năng phụ ít người đụng tới.

Nguyên nhân là R8 chạy ở chế độ đầy đủ. Trình quét mã vạch của ML Kit tìm các thành phần nội bộ thông qua các lớp registrar mà nó khởi tạo bằng reflection, dùng hàm khởi tạo không tham số của chúng. R8 không thấy đoạn mã nào gọi trực tiếp các hàm khởi tạo đó nên đã cắt bỏ hết. Khi đó ComponentDiscovery không thể tạo các registrar, một thành phần shared-preferences không bao giờ được đăng ký, và GmsBarcodeScanning.getClient() ném ra NullPointerException. Bản sửa ở 2.2.2, được gộp vào ngày 15 tháng 10, chỉ thêm vài dòng trong proguard-rules.pro để giữ lại các hàm khởi tạo đó. Đây là kiểu lỗi mà bản debug không bao giờ để lộ, và đó là lý do nên chạy báo cáo trước khi phát hành cho mọi lần đẩy lên bản chính thức thay vì chỉ chạy một lần.

Vì sao APK giảm được 4.5 MB ở bản 2.2.3?

Ứng dụng Android trước đó dùng lại bộ chữ của bản iOS, tức phông SF Pro của Apple gồm sáu tệp phông chữ. SF Pro chỉ được cấp phép cho các nền tảng của Apple, nên đáng lẽ nó không bao giờ được nằm trong bản dựng Android. Nó cũng rất nặng: commit gỡ bỏ nó ghi nhận 4.5 MB trong gói cài đặt. Tôi chuyển sang phông chữ hệ thống của Android và giữ nguyên các họ phông cũng như độ đậm nhạt như cũ, nên không cần sửa bất kỳ chỗ gọi nào trong mã nguồn.

Dưới đây là các tệp phát hành trên Forgejo, đo vào ngày 2 tháng 11 năm 2026:

Phiên bảnNgàyDung lượng APK
2.2.014/107 739 907 byte
2.2.216/107 738 839 byte
2.2.316/103 256 419 byte
2.2.4 bản F-Droid16/102 754 408 byte

Mức giảm từ 2.2.2 xuống 2.2.3 là 4 482 420 byte. Phiên bản 2.2.3 chính là bản lên Google Play, và cũng ngay trong ngày hôm đó README ngừng hướng dẫn người dùng Android tải APK thủ công.

Vì sao lại có riêng một bản dựng F-Droid?

Bản phát hành 2.2.4 (ngày 16 tháng 10) tách ứng dụng thành hai biến thể. Biến thể play giữ lại đăng nhập bằng Google và trình quét mã của Google. Biến thể fdroid không chứa chút mã nào của Google: nó quét mã QR bằng thư viện mã nguồn mở ZXing, cần quyền camera, và không có nút đăng nhập bằng Google. Bạn vẫn có thể đăng nhập bằng email và mật khẩu, Apple, Telegram hoặc mã QR. F-Droid cũng từ chối khối thông tin phụ thuộc mà Gradle tự thêm vào APK, nên bản phát hành bỏ phần này đi, và CI giờ dựng cả hai biến thể bằng khóa tải lên mỗi khi có bản phát hành mới rồi đính kèm cả hai tệp để F-Droid có thể đối chiếu bản dựng của họ với bản của chúng tôi. Tệp APK cho F-Droid nhẹ hơn bản Play khoảng 490 KB.

Chuyện gì đã xảy ra với 28 quyền truy cập?

Ngày 17 tháng 10, bản phát hành 2.2.6 đã dọn sạch hàng loạt quyền mà Todorant chưa bao giờ dùng tới. Một thư viện hiển thị chấm thông báo trên biểu tượng ứng dụng là ShortcutBadger khai báo một quyền cho từng hãng launcher mà nó biết, còn Credential Manager thêm hai quyền sinh trắc học cho passkey. Trình hợp nhất manifest gộp toàn bộ chúng vào ứng dụng. Đọc phần diff của commit, tôi đếm được 22 dòng tools:node="remove" dành cho các quyền đó, và quyền VIBRATE cũng bị bỏ luôn, vì phản hồi rung khi vuốt giờ dùng Compose haptics vốn không cần quyền nào. Thông điệp commit ghi tổng số quyền của ứng dụng giảm từ 28 xuống còn 5: internet, trạng thái mạng, boot receiver và thông báo cho lời nhắc lên kế hoạch (chỉ hỏi khi bạn đặt giờ nhắc), cùng với quyền camera chỉ có ở bản F-Droid. Ghi chú phát hành nói thẳng: Todorant giờ chỉ xin đúng những quyền mà nó thực sự sử dụng.

Tôi không tự dựng lại ứng dụng để tự đọc manifest sau hợp nhất, nên hai con số 28 và 5 là lấy từ commit, còn con số 22 là tôi tự đếm số dòng đã gỡ.

Những người dùng thật đầu tiên đã phát hiện ra điều gì?

Hai vấn đề, và cả hai đều do tôi gây ra. Ngày 16 tháng 10, tôi sửa lỗi lần đăng nhập đầu tiên trên các tài khoản lớn. Một lần đăng nhập mới sẽ tải toàn bộ tài khoản về, và bốn chỗ trong ứng dụng cùng lúc tự khởi chạy quá trình tải đầy đủ, nên một tài khoản thử nghiệm có 40 000 việc cần làm bị tải song song hai hoặc ba lần rồi hết bộ nhớ. Phản hồi heartbeat từ máy chủ phải xếp hàng sau luồng tải đó, lệnh ping 15 giây của client đóng mất socket, còn mốc hết thời gian đồng bộ 30 giây lại tính luôn cả thời gian tải. Trong lúc đó, ứng dụng chỉ hiện đúng mỗi tab Cài đặt. Bản sửa gom mọi yêu cầu kéo dữ liệu có cùng con trỏ vào chung luồng đang chạy, cho đồng bộ 30 giây để kết nối và 120 giây để phản hồi, đồng thời nâng chu kỳ ping lên 60 giây. Đến ngày 23 tháng 10, bản 2.2.7 khôi phục những việc mà người dùng trước đây chỉ lưu cục bộ trên thiết bị ở ứng dụng cũ, vốn đã bị ẩn đi sau khi cập nhật.

Những điều tôi sẽ làm giống như vậy ở lần sau

  1. Chạy báo cáo trước khi phát hành của Play trên mọi bản dựng chuẩn bị đẩy ra bản chính thức. Nó đã bắt được đúng lỗi văng ứng dụng quan trọng nhất.
  2. Kiểm tra giấy phép của mọi tài nguyên mang từ nền tảng khác sang. Một tệp APK nặng gấp đôi bình thường là lý do rất rõ ràng để mở ra xem.
  3. Tạo sẵn Google sign-in client thứ hai cho khóa ký của Play ngay từ ngày đầu.
  4. Xem mọi quyền xuất hiện trong manifest sau hợp nhất là thứ mà bạn phải giải thích được lý do tồn tại.

Todorant hiện có mặt trên Google Play, trên App Store, trên F-Droid và tại todorant.com. Nếu bạn muốn tự vận hành máy chủ của riêng mình, hướng dẫn tự dựng máy chủ chỉ cần một tệp compose. Mã nguồn được công khai trên GitHub.

Viết ngày 2 tháng 11 năm 2026 từ kho mã nguồn backmeupplz/todorant (các tag v2.2.12 trở về trước), các tệp phát hành trên Forgejo và những commit được dẫn ở trên.

Đọc tiếp