Cocos Game Developer: từ JD đến offer 🏠
🏠 Trang chủ / Cocos Game Developer: từ JD đến offer / Phần 3 · Native, SDK, build & phát hành / Module 16
🏭 Module 16 / 21 · 1 tuần Trung cấp

Build pipeline & phát hành: Git/SVN/Perforce, CMake, Gradle, Xcode, CI và lên store

Quản lý mã nguồn cho dự án game (Git + LFS, quy ước nhánh, .gitignore Creator; SVN/ Perforce và khoá file nhị phân), build Cocos2d-x bằng CMake, Gradle (ký, AAB, ABI, R8, target API), Xcode (ký, archive, export), build Creator bằng dòng lệnh, tự động hoá CI/ Fastlane, quy trình phát hành và các lý do store từ chối hay gặp.

Git/LFSPerforce/SVNCMakeGradle/AABxcodebuildCI/ FastlaneStore release
🎯 Dòng JD mà module này giúp bạn đáp ứng
  • “Familiarity with Git and build tools (CMake, Gradle, Xcode)”
  • “Full-cycle experience shipping games to the App Store and Google Play”
  • “Nice to have: Experience with SVN or Perforce”
📌 Vì sao nhà tuyển dụng hỏi phần này

“Full-cycle shipping” nghĩa là bạn tự đưa được game từ máy mình lên tay người chơi, nhiều lần, không phụ thuộc một người duy nhất biết build. Senior được kỳ vọng tự động hoá việc đó và gỡ được lỗi build khó (ký, ABI, phiên bản Gradle, Xcode mới).

🎯 Mục tiêu học tập

  • Thiết lập Git/LFS và quy ước nhánh cho dự án game; biết cơ bản SVN/ Perforce
  • Build Cocos2d-x bằng CMake cho Android/iOS
  • Cấu hình Gradle: ký, AAB, ABI, R8, target API
  • Archive/ export bằng xcodebuild; build Creator bằng CLI
  • Tự động hoá CI và quy trình phát hành, tránh lý do bị từ chối

🟢 Quản lý mã nguồn cho game

# .gitignore cho Cocos Creator 3.x
library/
temp/
local/
build/
profiles/           # tuỳ đội: nhiều đội commit profiles/v2/packages nếu dùng chung cấu hình plugin
node_modules/
*.log
.DS_Store
# KHÔNG bỏ qua: assets/**/*.meta, settings/, native/ (phần native tuỳ biến), extensions/ dùng chung
Hệ thốngMạnh ởGhi chú cho dự án game
Git (+ LFS)Nhánh nhẹ, PR/ review, CIĐưa PSD, video, file âm thanh gốc lớn vào LFS; ảnh xuất trong assets cân nhắc theo dung lượng
Perforce (Helix Core)Repo rất lớn, file nhị phân, khoá file (exclusive checkout)Phổ biến ở studio lớn; artist làm việc với file không merge được
SVNTập trung, đơn giản, khoá fileCòn trong nhiều studio lâu năm
  • File không merge được (scene, prefab lớn, ảnh): tránh hai người sửa cùng lúc — chia nhỏ prefab, quy ước người sở hữu, hoặc khoá file (Git LFS locking, Perforce checkout).
  • Quy ước nhánh gọn: main luôn build được; nhánh tính năng ngắn ngày + PR; nhánh/ tag phát hành release/1.4 để sửa nóng.

🟡 Cocos2d-x 4.0 với CMake

# Tạo project và sinh project Xcode/ Android bằng CMake (Cocos2d-x 4.0)
cocos new FruitMerge -p com.studio.fruitmerge -l cpp -d ~/projects
cd ~/projects/FruitMerge
mkdir -p build/ios && cd build/ios
cmake ../.. -GXcode -DCMAKE_SYSTEM_NAME=iOS -DCMAKE_OSX_SYSROOT=iphoneos
# Android: proj.android dùng Gradle gọi CMake (externalNativeBuild) — build bằng ./gradlew
# CMakeLists.txt (trích): thêm file nguồn và phần riêng từng nền tảng
list(APPEND GAME_SOURCE
     Classes/AppDelegate.cpp
     Classes/scenes/GameScene.cpp
     Classes/core/Economy.cpp)
if(ANDROID)
    list(APPEND GAME_SOURCE Classes/platform/NativeBridge-android.cpp)
elseif(APPLE AND IOS)
    list(APPEND GAME_SOURCE Classes/platform/NativeBridge-ios.mm)     # Objective-C++ (module 14)
endif()

🟡 Gradle: ký, AAB, ABI, R8

// app/build.gradle (trích, Groovy DSL)
android {
    namespace "com.studio.fruitmerge"
    compileSdk 35
    defaultConfig {
        applicationId "com.studio.fruitmerge"
        minSdk 21
        targetSdk 35                          // theo yêu cầu target API hằng năm của Google Play
        versionCode 10402                     // tăng mỗi lần lên store (số nguyên)
        versionName "1.4.2"
        ndk { abiFilters 'armeabi-v7a', 'arm64-v8a' }
    }
    signingConfigs {
        release {
            storeFile file(System.getenv("KEYSTORE_PATH") ?: "release.keystore")
            storePassword System.getenv("KEYSTORE_PASSWORD")       // KHÔNG ghi mật khẩu vào file trong Git
            keyAlias System.getenv("KEY_ALIAS")
            keyPassword System.getenv("KEY_PASSWORD")
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}
// Build gói phát hành Google Play:  ./gradlew bundleRelease   → app/build/outputs/bundle/release/*.aab
Chủ đềLưu ý
AABGoogle Play yêu cầu AAB cho app mới; Play tự tách APK theo ABI/ mật độ màn hình → giảm dung lượng tải
Play App SigningGoogle giữ khoá ký app; bạn giữ upload key. Mất upload key có quy trình đặt lại, mất keystore tự ký kiểu cũ là thảm hoạ: sao lưu an toàn
64-bitBắt buộc có arm64-v8a
Target APIGoogle Play yêu cầu nâng target API theo lịch hằng năm; kiểm tra trang yêu cầu trước mỗi đợt phát hành
Lỗi hay gặp khi nâng cấpPhiên bản Android Gradle Plugin/ Gradle/ JDK không tương thích; SDK bên thứ ba yêu cầu minSdk cao hơn; trùng thư viện (duplicate class)

🟡 Xcode, Creator CLI và CI

# iOS: archive và export IPA từ dòng lệnh (dùng cho CI)
xcodebuild -workspace FruitMerge.xcworkspace -scheme FruitMerge-mobile -configuration Release \
  -archivePath build/FruitMerge.xcarchive archive
xcodebuild -exportArchive -archivePath build/FruitMerge.xcarchive \
  -exportOptionsPlist ExportOptions.plist -exportPath build/ipa

# Cocos Creator: build bằng CLI với file cấu hình đã xuất từ panel Build
/Applications/Cocos/Creator/3.8.x/CocosCreator.app/Contents/MacOS/CocosCreator \
  --project . --build "platform=android;debug=false;configPath=./buildConfig_android.json"
# (đường dẫn và tham số đúng theo phiên bản Creator đã cài — xem mục "Command-line publishing" trong tài liệu)
Pipeline phát hành tự động
Push/ tagrelease/1.4.2
CIlint + unit test (M12)
BuildCreator CLI → Gradle bundleRelease / xcodebuild
Ký & upload symboldSYM, NDK symbols (M12)
Phân phốiPlay internal track, TestFlight (Fastlane)
Smoke testCài trên thiết bị, mở màn đầu

Fastlane là công cụ phổ biến để tự động hoá upload: pilot (TestFlight), supply (Google Play), quản lý chứng chỉ bằng match. Máy build iOS cần macOS (máy riêng hoặc dịch vụ CI có runner Mac).

🟢 Phát hành và tránh bị từ chối

Giai đoạnGoogle PlayApp Store
Thử nội bộInternal testing trackTestFlight (nội bộ)
Thử mở rộngClosed/ open testingTestFlight bên ngoài (cần duyệt beta)
Phát hànhProduction, phát hành dần (staged rollout %)Phát hành thủ công/ tự động sau duyệt, phát hành theo giai đoạn (phased release)
Theo dõiAndroid vitals (crash, ANR)Xcode Organizer, App Store Connect
Lý do bị từ chối/ cảnh báo hay gặpPhòng tránh
Thiếu “Restore Purchases” (iOS)Nút khôi phục ở màn shop/ cài đặt
Cho tạo tài khoản nhưng không cho xoáChức năng xoá tài khoản trong app
Mô tả quyền mơ hồ, thiếuInfo.plist rõ ràng (module 14)
Data safety/ privacy label không khớp SDKRà soát dữ liệu mọi SDK thu thập
Tải code thay đổi chức năng appHot update chỉ trong phạm vi chính sách cho phép (module 17)
Crash khi reviewer mở appSmoke test bản release trên thiết bị và phiên bản OS mới nhất
Target API thấpTheo lịch yêu cầu của Google Play

🎤 Câu hỏi phỏng vấn thường gặp (trả lời to trước khi mở)

🎤 Mô tả quy trình bạn đưa một bản cập nhật lên cả hai store.
Nhánh release, tăng versionName/ versionCode và build number, CI chạy test, build AAB (Gradle) và IPA (xcodebuild/ Fastlane), upload symbol, internal track + TestFlight, smoke test, ghi chú phát hành, gửi duyệt, phát hành dần, theo dõi crash/ ANR/ đánh giá, sẵn sàng tạm dừng rollout.
🎤 Bản release Android crash ngay khi mở nhưng debug thì không. Bạn kiểm tra gì?
R8 xoá class gọi qua JNI/ reflection (keep rule), thiếu ABI (.so), khác cấu hình (log tắt, tối ưu), ký khác dẫn tới SDK cấu hình sai (SHA-1 cho Google Sign-In), xem logcat + mapping, đọc stack native với symbol.
🎤 Làm sao để mọi người trong đội đều build được, không phụ thuộc máy bạn?
Ghi phiên bản công cụ (Creator, NDK, JDK, Xcode) trong README, build bằng CLI trong CI, bí mật (keystore, mật khẩu) trong kho bí mật của CI, commit phần native tuỳ biến, script một lệnh.
🎤 Hai người cùng sửa một scene, xung đột merge. Phòng tránh thế nào?
Chia scene thành nhiều prefab nhỏ có chủ sở hữu, giao tiếp qua code/ sự kiện; khoá file (LFS lock/ Perforce checkout) với file không merge được; quy ước báo trước khi sửa scene chung.
🎤 Bạn đã dùng Perforce/ SVN chưa? Khác Git thế nào?
Nếu chưa: nói thật và nêu hiểu biết: tập trung, checkout/ khoá file nhị phân, changelist, phù hợp repo lớn nhiều asset; Git phân tán, nhánh nhẹ. Nhấn mạnh khả năng học nhanh (JD ghi là “nice to have”).

⚠️ Sai lầm thường mắc

❌ Mật khẩu keystore trong Git

Vì sao nguy hiểm: Lộ khoá ký.

Cách làm đúng: Biến môi trường/ kho bí mật CI.

❌ Không sao lưu keystore/ upload key

Vì sao nguy hiểm: Không cập nhật được app.

Cách làm đúng: Sao lưu an toàn nhiều nơi, Play App Signing.

❌ Chỉ một người biết build

Vì sao nguy hiểm: Rủi ro vận hành.

Cách làm đúng: CI + tài liệu + script một lệnh.

❌ Commit library/ temp/ build/

Vì sao nguy hiểm: Repo phình, xung đột.

Cách làm đúng: .gitignore chuẩn.

❌ Quên tăng versionCode/ build number

Vì sao nguy hiểm: Store từ chối upload.

Cách làm đúng: Tự động tăng trong CI.

❌ Phát hành 100% ngay

Vì sao nguy hiểm: Lỗi ảnh hưởng toàn bộ người chơi.

Cách làm đúng: Staged/ phased rollout, theo dõi vitals.

📌 Cần nhớ
  • Git + LFS, .gitignore chuẩn, khoá file nhị phân; Perforce/ SVN hiểu cơ bản.
  • Cocos2d-x 4.0 sinh project bằng CMake; nguồn riêng nền tảng qua điều kiện.
  • Gradle: ký bằng biến môi trường, AAB, arm64, R8 + keep rule, target API theo yêu cầu.
  • xcodebuild archive/ export; Creator CLI; CI + Fastlane.
  • Internal/ TestFlight → duyệt → phát hành dần; tránh lý do từ chối phổ biến.

🧩 Tự kiểm tra (bấm để xem đáp án)

1. Google Play yêu cầu định dạng gì cho app mới?
A. APK
B. AAB
C. IPA
Đáp án: B. Android App Bundle.
2. Mật khẩu keystore nên lưu ở:
A. build.gradle trong Git
B. Biến môi trường/ kho bí mật CI
C. README
Đáp án: B. Bảo mật.
3. Lệnh tạo gói phát hành Android từ Gradle:
A. ./gradlew bundleRelease
B. cmake --build
C. xcodebuild archive
Đáp án: A. Sinh AAB.
4. App iOS bán non-consumable cần:
A. Nút Restore Purchases
B. Không gì thêm
C. Tắt IAP
Đáp án: A. Yêu cầu App Store.
5. Giảm rủi ro khi phát hành bản lỗi:
A. Phát hành 100%
B. Phát hành dần và theo dõi vitals
C. Tắt crash report
Đáp án: B. Staged rollout.

🏋️ Bài tập thực hành

Pipeline build một lệnh

Thiết lập cho project của bạn: .gitignore chuẩn, script build_android.sh (Creator CLI → bundleRelease, ký bằng biến môi trường), build_ios.sh (xcodebuild archive/ export), GitHub Actions chạy test + build Android cho mỗi tag. Viết README “build từ máy sạch trong 30 phút”.

💡 Gợi ý lời giải
Bắt đầu bằng build tay một lần, ghi lại mọi bước và phiên bản công cụ. Tách bí mật: keystore mã hoá base64 trong secret của CI, giải mã ra file lúc build. iOS cần runner macOS; nếu chưa có, ít nhất có script chạy được trên máy Mac của đội.

📚 Tài nguyên học tập

✅ Tự đánh giá hoàn thành

  • Thiết lập .gitignore + LFS
  • Build 2d-x bằng CMake (hoặc hiểu quy trình)
  • Cấu hình Gradle ký bằng biến môi trường
  • Archive/ export bằng xcodebuild
  • CI build theo tag
Lưu ý: Cocos Creator, Cocos2d-x, Spine, SDK của Google/ Apple/ các mạng quảng cáo thay đổi API theo phiên bản. Code mẫu viết cho Cocos Creator 3.8.x và Cocos2d-x 3.17/4.0; luôn đối chiếu tài liệu chính thức của phiên bản dự án bạn đang dùng. Chính sách App Store/ Google Play (đăng nhập, quyền riêng tư, tải code, target API) được tóm tắt ở mức tham khảo, hãy đọc bản mới nhất trước khi phát hành. Khoá học độc lập, không liên kết với Cocos, Esoteric Software hay nhà tuyển dụng nào.