Skip to main content

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ậpMục đích sử dụng
Google Play Consoleplay.google.com/consoleQuả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 Developersplay.google.com/console/developersQuả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 Dashboardexpo.dev/accounts/appmkt/projects/rubber-appQuản lý build AAB/APK, Keystore ký số, biến môi trường (EXPO_PUBLIC_API_URL) và submit tự động
Directus Admin Portalrubberapi.appmkt.vn/adminQuả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-policyURL 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ụcHiện trạngGhi chú & Đánh giá
Hình thức phát hànhPublic 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 namecom.appmkt.caosulaichau2Đã cấu hình chuẩn trong app.json
Phiên bản1.0.1eas.json dùng appVersionSource: "remote" → versionCode tự tăng tự động
Keystore Ký sốQuản lý qua EAS CredentialsEAS CLI tự động sinh và lưu trữ Keystore bảo mật trên Expo server
Play App SigningChưa thiết lậpBắ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ạiAPK debug/previewCần chuyển sang Android App Bundle (.aab) có ký số cho bản Production
minSdk / targetSdkminSdk 24; targetSdk 35 (Android 15)Đạt chuẩn Google Play (yêu cầu targetSdk ≥ 35 từ tháng 08/2025)
Adaptive Iconassets/images/app-icon.png, nền #10b981Đạt chuẩn icon adaptive (foreground 432×432 px, nền xanh lá)
Quyền truy cậpCAMERA, READ_MEDIA_IMAGESCầ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:
    1. Tạo track Thử nghiệm kín (Closed Testing) trên Google Play Console.
    2. 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ư).
    3. 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.
    4. Duy trì trạng thái 20 tester opt-in liên tục trong suốt 14 ngày.
    5. 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.
    6. Đ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):

  1. Chọn: Một số hoặc tất cả chức năng bị hạn chế (Restricted access).
  2. 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.vn with full sample data preloaded."

  3. Chuẩn bị trên Directus:
    • Tạo user reviewer_demo trên Directus tại https://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.

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 PlayKhuyến nghị thực tế
Số lượng ảnhTố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ạngPNG 24-bit hoặc JPEG (không alpha channel)PNG chất lượng cao
Tỷ lệ khung hình16: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 px1080 × 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ênKè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)​

  1. 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
  2. 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
  3. 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
  4. 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ô
  5. 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
  6. 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ảnYêu cầu kỹ thuậtNội dung chuẩn bị
Tên ứng dụngTối đa 30 ký tựCao Su Lai Châu 2
Mô tả ngắnTố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ụng512×512 PNG 32-bit, tối đa 1MBLogo 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ại1080×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ếnhttps://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​

  1. Chạy lệnh build production lần đầu:
    npx eas login
    npx eas build --platform android --profile production
  2. 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.
  3. Tải Keystore về lưu trữ dự phòng an toàn:
    npx eas credentials
    (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).
  4. 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_URL trỏ 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​

  1. 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.
  2. Quyền truy cập thiết bị (Device Permissions):
    • Khai báo quyền CAMERA và READ_MEDIA_IMAGES phục vụ thao tác chụp phiếu và chứng từ mủ.
  3. 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).
  4. Đố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)​

  1. Truy cập Google Play Console -> Thử nghiệm -> Thử nghiệm nội bộ (Internal testing).
  2. Tạo bản phát hành mới và tải file .aab lên.
  3. Đặt tên bản phát hành (VD: 1.0.1 (1)).
  4. 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).
  5. Gửi link tham gia thử nghiệm cho người dùng nội bộ để cài đặt app từ Google Play.
  6. 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)​

  1. 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).
  2. Kiểm tra lại toàn bộ mục cảnh báo (nếu có).
  3. Nhấn Gửi để xem xét (Submit for review).
  4. 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​

  1. 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, versionCode sẽ 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.1 lên 1.1.0), thay đổi "version": "1.1.0" trong app.json.
  2. Nộp bản cập nhật tự động bằng EAS Submit:
    npx eas submit --platform android
  3. 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@123 trê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:
  • 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.
  • 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).
  • Kỹ thuật & Mã nguồn:
    • Cấu hình eas.json có profile production xuấ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 --noEmit sạch lỗi 100%.
  • 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.