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.
- “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”
“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ống | Mạ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 |
| SVN | Tập trung, đơn giản, khoá file | Cò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:
mainluôn build được; nhánh tính năng ngắn ngày + PR; nhánh/ tag phát hànhrelease/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 ý |
|---|---|
| AAB | Google 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 Signing | Google 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-bit | Bắt buộc có arm64-v8a |
| Target API | Google 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ấp | Phiê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)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ạn | Google Play | App Store |
|---|---|---|
| Thử nội bộ | Internal testing track | TestFlight (nội bộ) |
| Thử mở rộng | Closed/ open testing | TestFlight bên ngoài (cần duyệt beta) |
| Phát hành | Production, 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õi | Android vitals (crash, ANR) | Xcode Organizer, App Store Connect |
| Lý do bị từ chối/ cảnh báo hay gặp | Phò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ếu | Info.plist rõ ràng (module 14) |
| Data safety/ privacy label không khớp SDK | Rà soát dữ liệu mọi SDK thu thập |
| Tải code thay đổi chức năng app | Hot update chỉ trong phạm vi chính sách cho phép (module 17) |
| Crash khi reviewer mở app | Smoke test bản release trên thiết bị và phiên bản OS mới nhất |
| Target API thấp | Theo 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.
🎤 Bản release Android crash ngay khi mở nhưng debug thì không. Bạn kiểm tra gì?
🎤 Làm sao để mọi người trong đội đều build được, không phụ thuộc máy bạn?
🎤 Hai người cùng sửa một scene, xung đột merge. Phòng tránh thế nào?
🎤 Bạn đã dùng Perforce/ SVN chưa? Khác Git thế nào?
⚠️ Sai lầm thường mắc
Vì sao nguy hiểm: Lộ khoá ký.
Cách làm đúng: Biến môi trường/ kho bí mật CI.
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.
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.
Vì sao nguy hiểm: Repo phình, xung đột.
Cách làm đúng: .gitignore chuẩn.
Vì sao nguy hiểm: Store từ chối upload.
Cách làm đúng: Tự động tăng trong CI.
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.
- 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
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
3. Lệnh tạo gói phát hành Android từ Gradle:
A. ./gradlew bundleRelease
B. cmake --build
C. xcodebuild archive
4. App iOS bán non-consumable cần:
A. Nút Restore Purchases
B. Không gì thêm
C. Tắt IAP
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
🏋️ Bài tập thực hà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
📚 Tài nguyên học tập
- Android Developers: Build your appGradle, ký app, AABTài liệu
- Google Play: Target API level requirementsLịch yêu cầu target APIChính sách
- CMake DocumentationLệnh, generator, toolchainTài liệu
- FastlaneTự động hoá build và phát hànhCông cụ
- Pro GitGit đầy đủSách miễn phí
✅ 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