Kế hoạch đưa ứng dụng lên Google Play Store
- Ứng dụng: Cao Su Lai Châu 2
- Package name:
com.appmkt.caosulaichau2 - Loại ứng dụng: Public App (Ứng dụng công khai trên Google Play Store, không phải Private / Managed Enterprise App)
- Stack: Expo SDK 54 (managed) / React Native 0.81.5 / React 19.1
- Backend: Directus REST API tại
https://rubberapi.appmkt.vn - EAS Project ID:
25ed37a0-8c42-4cd4-b9dc-c50aa3fc5b7b(Owner:appmkt) - Ngày cập nhật: 18/08/2026
1. Các URL Quản trị & Phát hành Hệ thống
Để quản lý quá trình đóng gói, kiểm thử, duyệt ứng dụng và vận hành backend, các đường dẫn sau đây là bắt buộc cho đội ngũ phát triển và quản trị:
| Hệ thống quản lý | URL truy cập | Mục đích sử dụng |
|---|---|---|
| Google Play Console | play.google.com/console | Quản lý phát hành, cấu hình Store Listing, quản lý testers, theo dõi kiểm duyệt và Android Vitals |
| Google Play Developers | play.google.com/console/developers | Quản lý tài khoản nhà phát triển, thanh toán và thông tin pháp lý tổ chức |
| Expo EAS Dashboard | expo.dev/accounts/appmkt/projects/rubber-app | Quản lý build AAB/APK, Keystore ký số, biến môi trường (EXPO_PUBLIC_API_URL) và submit tự động |
| Directus Admin Portal | rubberapi.appmkt.vn/admin | Quản trị cơ sở dữ liệu, quản lý tài khoản công nhân/tổ trưởng, tạo tài khoản Demo cho Google Reviewer |
| Chính sách quyền riêng tư | https://caosulaichau2.vn/privacy-policy | URL chính sách bảo mật bắt buộc khai báo trên Google Play Console và màn hình thông tin app |
2. Rà soát hiện trạng (Audit) Android
| Hạng mục | Hiện trạng | Ghi chú & Đánh giá |
|---|---|---|
| Hình thức phát hành | Public App (Công khai) | Phân phối công khai trên Google Play Store cho mọi người dùng tại Việt Nam tải về |
| Package name | com.appmkt.caosulaichau2 | Đã cấu hình chuẩn trong app.json |
| Phiên bản | 1.0.1 | eas.json dùng appVersionSource: "remote" → versionCode tự tăng tự động |
| Keystore Ký số | Quản lý qua EAS Credentials | EAS CLI tự động sinh và lưu trữ Keystore bảo mật trên Expo server |
| Play App Signing | Chưa thiết lập | Bắt buộc kích hoạt trên Google Play Console khi tải bản AAB đầu tiên |
| Bản build hiện tại | APK debug/preview | Cần chuyển sang Android App Bundle (.aab) có ký số cho bản Production |
| minSdk / targetSdk | minSdk 24; targetSdk 35 (Android 15) | Đạt chuẩn Google Play (yêu cầu targetSdk ≥ 35 từ tháng 08/2025) |
| Adaptive Icon | assets/images/app-icon.png, nền #10b981 | Đạt chuẩn icon adaptive (foreground 432×432 px, nền xanh lá) |
| Quyền truy cập | CAMERA, READ_MEDIA_IMAGES | Cần khai báo mục đích trong phần Quyền & Data safety |
| Tài khoản Reviewer (Demo) | Bắt buộc 100% | App yêu cầu đăng nhập nên phải cung cấp tài khoản demo có dữ liệu cho Google Reviewer |
3. Quy định Bắt buộc về Số lượng Tester (Testing Requirements)
Google Play áp dụng chính sách kiểm thử nghiêm ngặt trước khi một ứng dụng được phép phát hành công khai (Production). Tùy thuộc vào loại tài khoản Google Play Developer, yêu cầu về số lượng tester như sau:
3.1. Trường hợp 1: Tài khoản Nhà phát triển Cá nhân (Personal Developer Account)
[!WARNING] Nếu sử dụng tài khoản cá nhân tạo sau ngày 13/11/2023, Google bắt buộc 100% quy trình Closed Testing:
- Số lượng tester tối thiểu: Ít nhất 20 testers.
- Thời gian kiểm thử liên tục: Tối thiểu 14 ngày liên tiếp (14 consecutive days).
- Quy trình thực hiện:
- Tạo track Thử nghiệm kín (Closed Testing) trên Google Play Console.
- Mời danh sách tối thiểu 20 email tài khoản Google Play của tester (cán bộ, công nhân, kỹ sư).
- Cả 20 tester phải bấm vào link web hoặc Google Play để chấp nhận tham gia (Opt-in) và cài đặt app trên máy thật.
- Duy trì trạng thái 20 tester opt-in liên tục trong suốt 14 ngày.
- Sau 14 ngày, nút Đăng ký quyền phát hành chính thức (Apply for Production Access) sẽ mở ra trên Play Console.
- Điền câu trả lời chi tiết cho bảng câu hỏi của Google (Mục tiêu ứng dụng, phản hồi nhận được từ tester, các lỗi đã khắc phục trong 14 ngày).
3.2. Trường hợp 2: Tài khoản Doanh nghiệp / Tổ chức (Organization Account - KHUYẾN NGHỊ)
[!TIP] Ứng dụng Cao Su Lai Châu 2 thuộc Công ty CP Cao Su Lai Châu II:
- Tài khoản Doanh nghiệp KHÔNG BỊ BẮT BUỘC điều kiện 20 testers / 14 ngày để mở quyền phát hành Production.
- Sau khi cấu hình Store Listing và hoàn tất biểu mẫu, có thể nộp thẳng bản phát hành chính thức (Production).
- Tuy nhiên, quy trình khuyến nghị chuẩn:
- Vẫn nên tạo track Thử nghiệm nội bộ (Internal Testing) cho nhóm 5–10 tester (Ban lãnh đạo, Tổ trưởng tiêu biểu, Kỹ sư IT).
- Thời gian test nội bộ: 2–3 ngày để kiểm tra tính ổn định, thao tác đồng bộ dữ liệu với Directus và kiểm tra báo cáo Pre-launch Report (Firebase Test Lab) để phát hiện crash/ANR trước khi bấm Submit Production.
4. Bản chất Public App & Khai báo App Access cho Google Reviewer
4.1. Bản chất ứng dụng Public (Công khai)
- Ứng dụng Cao Su Lai Châu 2 được xuất bản dưới dạng Public App: Mọi công nhân, tổ trưởng, kỹ thuật viên hoặc đối tác đều có thể tìm kiếm và cài đặt trực tiếp từ Google Play Store trên mọi thiết bị Android.
- Ứng dụng không sử dụng hình thức Managed Google Play (Private Enterprise App) để đảm bảo công nhân dùng máy cá nhân dễ dàng cài đặt và nhận bản cập nhật tự động.
4.2. Khai báo Quyền truy cập ứng dụng (App Access) cho Google Review Team
Do ứng dụng là Public App nhưng yêu cầu đăng nhập bằng tài khoản nội bộ (màn hình khóa), Google Review Team bắt buộc phải có tài khoản đăng nhập để kiểm tra toàn bộ tính năng bên trong. Nếu thiếu, ứng dụng sẽ bị Từ chối (Rejected) ngay lập tức với lỗi "Guideline / Policy: App Access & Credentials".
Tại mục Google Play Console -> Chính sách -> Nội dung ứng dụng -> Quyền truy cập ứng dụng (App access):
- Chọn: Một số hoặc tất cả chức năng bị hạn chế (Restricted access).
- Thêm thông tin đăng nhập kiểm duyệt mẫu:
- Tên tài khoản (Account Name):
Google Reviewer Demo - Tên đăng nhập (Username/Email):
reviewer_demo - Mật khẩu (Password):
Password@123 - Số điện thoại xác thực (2FA/OTP): Không áp dụng (hoặc cung cấp mã cố định nếu có).
- Hướng dẫn bằng tiếng Anh & tiếng Việt (Instructions for Reviewers):
"Demo account credentials for Google Play Review: - Username:
reviewer_demo- Password:Password@123- Navigation Guide: 1. Log in with the credentials above. 2. The app opens the main Dashboard showing plantation summary. 3. Tap 'Điểm danh' (Attendance) to view and test worker roll call. 4. Tap 'Nhập sản lượng' (Daily Latex Entry) to record latex production by plot. 5. Tap 'Kho mủ' (Warehouse) to inspect warehouse delivery receipts. Backend API server:https://rubberapi.appmkt.vnwith full sample data preloaded."
- Tên tài khoản (Account Name):
- Chuẩn bị trên Directus:
- Tạo user
reviewer_demotrên Directus tạihttps://rubberapi.appmkt.vn/admin. - Gán quyền tương đương Tổ trưởng (Team Leader).
- Đảm bảo tài khoản được liên kết với một Tổ sản xuất có sẵn danh sách công nhân mẫu, lô cạo mẫu để màn hình không bị trống.
- Tạo user
5. Chuẩn bị Tài sản Cửa hàng & Ảnh chụp màn hình (Screenshots)
5.1. Yêu cầu kỹ thuật bộ Screenshots trên Google Play Store
| Tiêu chí | Quy định Google Play | Khuyến nghị thực tế |
|---|---|---|
| Số lượng ảnh | Tối thiểu 2 ảnh, tối đa 8 ảnh / mỗi loại thiết bị | 6 ảnh điện thoại + 4 ảnh Tablet (nếu hỗ trợ) |
| Định dạng | PNG 24-bit hoặc JPEG (không alpha channel) | PNG chất lượng cao |
| Tỷ lệ khung hình | 16:9 (ngang) hoặc 9:16 (dọc) | 9:16 (dọc) chuẩn điện thoại Android |
| Kích thước khuyến nghị | Tối thiểu mỗi cạnh 320 px, tối đa 3840 px | 1080 × 1920 px hoặc 1080 × 2400 px |
| Yêu cầu nội dung | Ảnh chụp màn hình thật của ứng dụng, không méo hình, có banner chú thích ngắn gọn phía trên | Kèm text giới thiệu tính năng rõ nét, dễ đọc |
5.2. Danh sách 6 Màn hình chụp thực tế (Store Screenshots)
- Màn hình 1 - Đăng nhập an toàn:
- Giao diện đăng nhập với Logo Cao Su Lai Châu 2, form nhập tài khoản và mã đơn vị sản xuất.
- Caption:
Đăng nhập an toàn & Đồng bộ dữ liệu nông trường
- Màn hình 2 - Tổng quan Điều hành (Dashboard):
- Biểu đồ sản lượng mủ ngày/tháng, chỉ số DRC/TSC, tỷ lệ hoàn thành kế hoạch khai thác.
- Caption:
Theo dõi tổng quan sản lượng & tiến độ sản xuất
- Màn hình 3 - Điểm danh Công nhân (Attendance):
- Danh sách công nhân theo tổ, trạng thái đi cạo mủ, chụp ảnh minh chứng tại vườn cây.
- Caption:
Điểm danh công nhân & Chấm công trực quan
- Màn hình 4 - Nhập Sản lượng Mủ (Daily Latex Entry):
- Form ghi nhận khối lượng mủ nước, mủ đông theo từng lô cạo và từng công nhân.
- Caption:
Ghi nhận sản lượng mủ nhanh chóng theo từng lô
- Màn hình 5 - Quản lý Kho & Giao nhận Mủ (Warehouse):
- Phiếu giao nhận mủ tại trạm cân, xuất nhập tồn kho và chữ ký điện tử/ảnh chụp phiếu.
- Caption:
Quản lý phiếu giao nhận mủ & Xuất nhập kho
- Màn hình 6 - Tra cứu Phiếu lương & Dịch bệnh:
- Màn hình tra cứu bảng lương công nhân và bản tin thời tiết, cảnh báo bệnh phấn trắng/botryo.
- Caption:
Tra cứu thu nhập công nhân & Cảnh báo nông nghiệp
5.3. Bảng tổng hợp Tài sản Cửa hàng (Store Listing Assets)
| Tài sản | Yêu cầu kỹ thuật | Nội dung chuẩn bị |
|---|---|---|
| Tên ứng dụng | Tối đa 30 ký tự | Cao Su Lai Châu 2 |
| Mô tả ngắn | Tối đa 80 ký tự | Quản lý khai thác mủ, điểm danh và điều hành sản xuất cao su Lai Châu. |
| Mô tả đầy đủ | Tối đa 4000 ký tự | Giới thiệu đầy đủ phân hệ nghiệp vụ: - Ghi nhận sản lượng mủ tươi theo lô/tổ cạo - Điểm danh và theo dõi ngày công công nhân hàng ngày - Quản lý xuất/nhập kho và phiếu giao nhận mủ - Tra cứu phiếu lương, dự báo thời tiết & cảnh báo dịch bệnh cao su |
| Icon ứng dụng | 512×512 PNG 32-bit, tối đa 1MB | Logo Cao Su Lai Châu 2 trên nền xanh lá #10b981 |
| Đồ họa tính năng (Feature Graphic) | 1024×500 PNG hoặc JPEG (tỷ lệ 2:1) | Banner đồ họa giới thiệu ứng dụng với logo và slogan |
| Ảnh chụp màn hình điện thoại | 1080×1920 hoặc 1080×2400 (6 ảnh) | Bộ 6 ảnh chụp màn hình theo danh sách mục 5.2 |
| Chính sách quyền riêng tư | URL công khai trực tuyến | https://caosulaichau2.vn/privacy-policy |
6. Giao diện & Các khu vực Cấu hình trên Google Play Console
Dưới đây là sơ đồ các khu vực cần thao tác trên Google Play Console (play.google.com/console):
Google Play Console
│
├── 1. Trang tổng quan ứng dụng (Dashboard)
│ ├── Hướng dẫn thiết lập ứng dụng (Set up your app)
│ └── Trạng thái bản phát hành (Release status)
│
├── 2. Hiện diện trên Cửa hàng (Store presence)
│ ├── Trang thông tin chính trên Cửa hàng (Main Store Listing)
│ │ ├── Tên app, Mô tả ngắn, Mô tả chi tiết
│ │ ├── Icon 512×512 & Feature Graphic 1024×500
│ │ └── Bộ Screenshots điện thoại (1080×1920)
│ └── Cài đặt trên Cửa hàng (Store settings) -> Danh mục: Năng suất (Productivity) / Doanh nghiệp
│
├── 3. Chính sách & Nội dung ứng dụng (Policy & App Content)
│ ├── Quyền truy cập ứng dụng (App Access) -> Điền Username `reviewer_demo` / `Password@123`
│ ├── An toàn dữ liệu (Data Safety) -> Không chia sẻ bên thứ 3, mã hóa HTTPS
│ ├── Xếp hạng nội dung (Content Rating - IARC) -> PEGI 3 / Mọi lứa tuổi
│ ├── Đối tượng mục tiêu (Target Audience) -> 18 tuổi trở lên (Người lao động)
│ └── Chính sách quyền riêng tư (Privacy Policy) -> https://caosulaichau2.vn/privacy-policy
│
└── 4. Phát hành & Kiểm thử (Release & Testing)
├── Thử nghiệm nội bộ (Internal Testing) -> Dành cho 5–10 tester nội bộ + Pre-launch report
├── Thử nghiệm kín (Closed Testing) -> Bắt buộc 20 tester / 14 ngày (nếu tài khoản cá nhân)
└── Bản phát hành chính thức (Production) -> Nộp file .aab để Google xét duyệt
7. Các việc cần làm trong repo trước khi build
7.1. Cấu hình eas.json cho Android Production
Profile production cần xuất bản Android App Bundle (.aab) có ký số:
{
"cli": {
"version": ">= 16.26.0",
"appVersionSource": "remote"
},
"build": {
"development": {
"developmentClient": true,
"distribution": "internal"
},
"preview": {
"distribution": "internal"
},
"preview_apk": {
"distribution": "internal",
"android": {
"buildType": "apk"
}
},
"production": {
"autoIncrement": true,
"android": {
"buildType": "app-bundle"
},
"env": {
"NODE_ENV": "production"
}
}
},
"submit": {
"production": {
"android": {
"serviceAccountKeyPath": "./google-services-key.json",
"track": "internal"
}
}
}
}
7.2. Thiết lập Keystore & Google Play App Signing
- Chạy lệnh build production lần đầu:
npx eas loginnpx eas build --platform android --profile production
- EAS sẽ hỏi tạo Keystore mới → Chọn Yes. EAS sẽ tự động lưu Keystore trên máy chủ bảo mật của Expo.
- Tải Keystore về lưu trữ dự phòng an toàn:
(Lưu file Keystore và mật khẩu vào nơi lưu trữ bảo mật của công ty — mất Keystore sẽ không thể cập nhật app).npx eas credentials
- Bật Play App Signing trên Google Play Console và nộp chứng chỉ upload key (
.pem).
7.3. Cấu hình biến môi trường Production
- Đảm bảo biến
EXPO_PUBLIC_API_URLtrỏ chính xác về máy chủ Directus:npx eas env:create --name EXPO_PUBLIC_API_URL --value "https://rubberapi.appmkt.vn" --environment production
7.4. Kiểm tra Typecheck & Dọn dẹp code
- Chạy kiểm tra kiểu dữ liệu:
npx tsc --noEmit(đảm bảo không còn lỗi TypeScript). - Rà soát gỡ bỏ các dòng log debug không cần thiết (
console.log('DEBUG: ...')).
8. Khai báo Data Safety, Phân loại nội dung & Quyền truy cập
- Biểu mẫu An toàn dữ liệu (Data Safety Form):
- Thông tin cá nhân: Tên công nhân, số điện thoại, mã nhân viên (phục vụ vận hành nội bộ).
- Ảnh & Tệp tin: Ảnh chụp minh chứng điểm danh, ảnh phiếu giao nhận mủ.
- Bảo mật: Dữ liệu truyền tải qua kết nối mã hóa HTTPS.
- Chia sẻ bên thứ ba: Chọn Không chia sẻ cho bất kỳ bên thứ ba nào.
- Quyền truy cập thiết bị (Device Permissions):
- Khai báo quyền
CAMERAvàREAD_MEDIA_IMAGESphục vụ thao tác chụp phiếu và chứng từ mủ.
- Khai báo quyền
- Phân loại nội dung (Content Rating):
- Trả lời bảng câu hỏi IARC trên Play Console.
- Đánh giá phân loại: Mọi lứa tuổi / PEGI 3 (do là ứng dụng quản trị công việc).
- Đối tượng mục tiêu & Nội dung:
- Đối tượng: Người trưởng thành (18 tuổi trở lên / Người lao động).
9. Quy trình Build, Thử nghiệm & Phát hành
9.1. Build bản phát hành AAB
npx eas login
npx eas build --platform android --profile production
Sau khi build xong, tải file .aab từ dashboard Expo (expo.dev/accounts/appmkt/projects/rubber-app) hoặc link do EAS CLI trả về.
9.2. Thử nghiệm nội bộ (Internal Testing)
- Truy cập Google Play Console -> Thử nghiệm -> Thử nghiệm nội bộ (Internal testing).
- Tạo bản phát hành mới và tải file
.aablên. - Đặt tên bản phát hành (VD:
1.0.1 (1)). - Tạo danh sách người thử nghiệm (Email của Ban lãnh đạo, Tổ trưởng, Kỹ thuật viên).
- Gửi link tham gia thử nghiệm cho người dùng nội bộ để cài đặt app từ Google Play.
- Kiểm tra Pre-launch Report: Theo dõi báo cáo tự động của Google (Firebase Test Lab) để phát hiện màn hình trắng, lỗi giao diện hay crash trên các dòng máy Android phổ biến.
9.3. Nộp bản phát hành chính thức (Production Release)
- Sau khi thử nghiệm nội bộ hoạt động ổn định:
- Vào mục Bản phát hành chính thức (Production) trên Play Console.
- Tạo bản phát hành mới (chọn bản build AAB đã qua thử nghiệm).
- Kiểm tra lại toàn bộ mục cảnh báo (nếu có).
- Nhấn Gửi để xem xét (Submit for review).
- Thời gian xét duyệt thông thường: từ 1 đến 7 ngày làm việc.
10. Quy trình Cập nhật & Bảo trì sau phát hành
- Cập nhật phiên bản mới:
- Khi có thay đổi code, chỉ cần chạy lại lệnh:
npx eas build --platform android --profile production
- Nhờ cấu hình
autoIncrement: true,versionCodesẽ tự động tăng lên để Google Play chấp nhận bản cập nhật mới. - Khi nâng cấp phiên bản lớn (VD từ
1.0.1lên1.1.0), thay đổi"version": "1.1.0"trongapp.json.
- Khi có thay đổi code, chỉ cần chạy lại lệnh:
- Nộp bản cập nhật tự động bằng EAS Submit:
npx eas submit --platform android
- Giám sát sức khỏe ứng dụng:
- Theo dõi mục Chỉ số chất lượng Android Vitals trên Google Play Console (tỷ lệ ANR, tỷ lệ crash).
- Tích hợp Sentry (
@sentry/react-native) để ghi nhận lỗi runtime chi tiết khi công nhân thao tác tại nông trường.
11. Checklist Tổng hợp Google Play Store
- Xác định loại tài khoản Google Play Developer:
- Nếu là Tài khoản Doanh nghiệp/Tổ chức: Đã hoàn tất xác minh danh tính tổ chức (25 USD, DKKD).
- Nếu là Tài khoản Cá nhân: Đã hoàn thành thử nghiệm kín với tối thiểu 20 testers liên tục trong 14 ngày và được Google cấp quyền phát hành Production.
- Xác nhận hình thức phát hành: Public App trên Google Play Store.
- Khai báo App Access (Tài khoản Reviewer): Tạo user
reviewer_demo/Password@123trên Directus và khai báo vào mục App Access trên Play Console. - Chuẩn bị URL Quản lý & Chính sách:
- Google Play Console: play.google.com/console
- Expo EAS Dashboard: expo.dev/accounts/appmkt/projects/rubber-app
- Directus Admin: rubberapi.appmkt.vn/admin
- Privacy Policy:
https://caosulaichau2.vn/privacy-policy
- Chuẩn bị Tài sản đồ họa & Screenshots:
- Icon ứng dụng: 512×512 PNG 32-bit (nền xanh lá
#10b981). - Feature Graphic: 1024×500 PNG/JPEG.
- Bộ 6 ảnh chụp màn hình điện thoại (1080×1920 hoặc 1080×2400): Đăng nhập, Dashboard, Điểm danh, Sản lượng, Kho mủ, Phiếu lương/Dịch bệnh.
- Icon ứng dụng: 512×512 PNG 32-bit (nền xanh lá
- Khai báo Nội dung & Thông tin Store Listing:
- Tên app:
Cao Su Lai Châu 2(≤30 ký tự). - Mô tả ngắn:
Quản lý khai thác mủ, điểm danh và điều hành sản xuất cao su Lai Châu.(≤80 ký tự). - Mô tả đầy đủ (≤4000 ký tự).
- Hoàn thành biểu mẫu An toàn dữ liệu (Data Safety Form).
- Hoàn thành biểu mẫu phân loại độ tuổi IARC (PEGI 3 / Mọi lứa tuổi).
- Tên app:
- Kỹ thuật & Mã nguồn:
- Cấu hình
eas.jsoncó profileproductionxuất bản AAB. - Kích hoạt Google Play App Signing & lưu trữ an toàn Keystore.
- Cấu hình biến môi trường production
EXPO_PUBLIC_API_URL. - Chạy
npx tsc --noEmitsạch lỗi 100%.
- Cấu hình
- Build, Thử nghiệm & Phát hành:
- Build file AAB bằng lệnh
npx eas build --platform android --profile production. - Tải lên kênh Thử nghiệm nội bộ (Internal Testing) cho nhóm 5–10 người test.
- Kiểm tra Pre-launch Report (Firebase Test Lab) không có lỗi crash/màn hình trắng.
- Nộp bản phát hành chính thức (Production Release) và gửi duyệt.
- Build file AAB bằng lệnh