Hot update & live-update: manifest, tải chênh lệch, khôi phục và chính sách store
Thứ gì cập nhật nóng được và thứ gì không, chính sách store, cơ chế AssetsManager của Cocos (manifest, so sánh phiên bản, tải file khác md5, search path, khởi động lại), sinh manifest trong pipeline, bẫy cache cũ khi cài bản store mới, khôi phục khi bản cập nhật lỗi, phát hành theo nhóm, và các phương án live-ops an toàn hơn (remote config, bundle từ xa).
- “Build game patches, hot updates, and live-update flows”
- “Nice to have: Experience with hot update and live-update pipelines”
Hot update là năng lực “đặc sản” của Cocos (nhờ script JS/ Lua) và là lý do nhiều studio chọn Cocos cho game live-ops. Nhưng làm sai thì có thể làm hỏng game của toàn bộ người chơi trong một lần đẩy, không có cách sửa trừ khi người chơi gỡ cài đặt. Người phỏng vấn sẽ hỏi thiết kế hệ thống hot update như một câu system design.
🎯 Mục tiêu học tập
- Phân biệt nội dung cập nhật nóng được/ không được và giới hạn chính sách
- Giải thích cơ chế manifest, so sánh phiên bản, search path
- Cài luồng hot update trong Creator 3.x
- Thiết kế pipeline sinh manifest, CDN, phát hành theo nhóm
- Xử lý cache cũ khi nâng cấp store và khôi phục khi lỗi
🟢 Cập nhật được gì, không được gì
| Loại | Hot update? | Ghi chú |
|---|---|---|
| Script game (JS biên dịch từ TS; Lua/JS ở 2d-x có binding) | Được (về kỹ thuật) | Chịu ràng buộc chính sách store |
| Ảnh, âm thanh, Spine, prefab, scene, cấu hình JSON | Được | Phổ biến và ít rủi ro chính sách nhất |
| Code C++/ Java/ Objective-C, engine, SDK, quyền, icon, tên app | Không | Phải phát hành bản store |
| Logic C++ thuần của game Cocos2d-x | Không | Game 2d-x thuần C++ chỉ cập nhật được asset/ cấu hình |
App Store Review Guidelines (mục 2.5.2 và các mục liên quan) hạn chế việc app tải code làm thay đổi tính năng/ bản chất app sau khi duyệt; Google Play cũng có chính sách về tải code thực thi. Thực hành an toàn: dùng hot update cho nội dung, cấu hình, sửa lỗi nhỏ trong phạm vi tính năng đã được duyệt; tính năng mới đi qua bản store. Luôn đọc chính sách hiện hành và để quản lý sản phẩm/ pháp chế quyết định phạm vi.
🟡 Cơ chế: manifest và search path
{
"packageUrl": "https://cdn.example.com/fruitmerge/hotupdate/1.4.3/",
"remoteManifestUrl": "https://cdn.example.com/fruitmerge/hotupdate/project.manifest",
"remoteVersionUrl": "https://cdn.example.com/fruitmerge/hotupdate/version.manifest",
"version": "1.4.3",
"assets": {
"assets/main/index.js": { "size": 415500, "md5": "c90b7e0f..." },
"assets/resources/spine/hero.skel": { "size": 98200, "md5": "5af2a113..." },
"assets/resources/event/tet.png": { "size": 260000, "md5": "e0219c4d..." }
},
"searchPaths": []
}Search path: khi engine tìm một file, nó thử lần lượt các thư mục trong danh sách. Đặt thư mục chứa bản cập nhật (trong vùng ghi được của app) lên đầu, file mới sẽ “đè” file trong gói cài mà không cần sửa gói.
🟡 Cài đặt trong Creator 3.x
import { _decorator, Component, native, sys, game, Asset } from 'cc';
const { ccclass, property } = _decorator;
@ccclass('HotUpdate')
export class HotUpdate extends Component {
@property(Asset) localManifest: Asset | null = null; // project.manifest đóng trong gói cài
private am: native.AssetsManager | null = null;
private storagePath = '';
start() {
if (!sys.isNative) return; // web không dùng cơ chế này
this.storagePath = native.fileUtils.getWritablePath() + 'hotupdate/';
this.am = new native.AssetsManager('', this.storagePath, compareVersion);
this.am.setVerifyCallback((path: string, asset: any) => {
// Kiểm tra md5 file đã tải (tính md5 qua module native hoặc thư viện); trả false để tải lại
return true;
});
this.am.loadLocalManifest(this.localManifest!.nativeUrl);
if (!this.am.getLocalManifest() || !this.am.getLocalManifest().isLoaded()) { this.enterGame(); return; }
this.am.setEventCallback(this.onCheck.bind(this));
this.am.checkUpdate();
}
private onCheck(e: native.EventAssetsManager) {
switch (e.getEventCode()) {
case native.EventAssetsManager.NEW_VERSION_FOUND:
this.am!.setEventCallback(this.onUpdate.bind(this));
this.am!.update();
break;
case native.EventAssetsManager.ALREADY_UP_TO_DATE:
case native.EventAssetsManager.ERROR_NO_LOCAL_MANIFEST:
case native.EventAssetsManager.ERROR_DOWNLOAD_MANIFEST:
case native.EventAssetsManager.ERROR_PARSE_MANIFEST:
this.enterGame(); // lỗi mạng/ server: vẫn cho chơi bằng bản hiện có
break;
}
}
private onUpdate(e: native.EventAssetsManager) {
switch (e.getEventCode()) {
case native.EventAssetsManager.UPDATE_PROGRESSION:
this.showProgress(e.getPercentByFile());
break;
case native.EventAssetsManager.UPDATE_FINISHED: {
const paths = native.fileUtils.getSearchPaths();
const newPaths = this.am!.getLocalManifest().getSearchPaths();
const merged = [...newPaths, ...paths.filter(p => newPaths.indexOf(p) < 0)];
localStorage.setItem('HotUpdateSearchPaths', JSON.stringify(merged)); // main.js đọc khi khởi động
native.fileUtils.setSearchPaths(merged);
game.restart();
break;
}
case native.EventAssetsManager.UPDATE_FAILED:
this.am!.downloadFailedAssets(); // thử lại file lỗi (giới hạn số lần)
break;
case native.EventAssetsManager.ERROR_UPDATING:
case native.EventAssetsManager.ERROR_DECOMPRESS:
this.enterGame();
break;
}
}
private showProgress(p: number) {} private enterGame() {}
}
export function compareVersion(a: string, b: string): number { // > 0 nếu a mới hơn b
const x = a.split('.'), y = b.split('.');
for (let i = 0; i < Math.max(x.length, y.length); i++) {
const d = (parseInt(x[i] || '0', 10)) - (parseInt(y[i] || '0', 10));
if (d !== 0) return d;
}
return 0;
}Search path phải được nạp trước khi engine tải script: đoạn đọc HotUpdateSearchPaths và gọi setSearchPaths được chèn vào đầu main.js của bản build native (qua build template/ hook sau build). Xem mẫu trong tài liệu “Hot Update” của phiên bản Creator bạn dùng; Cocos2d-x có lớp tương đương AssetsManagerEx.
🔴 Bẫy chết người: cache cũ sau khi cập nhật store
Người chơi đang ở bản hot update 1.4.3 (lưu trong thư mục ghi được). Studio phát hành bản store 1.5.0 có native mới và script mới. Sau khi cập nhật từ store, search path vẫn trỏ vào thư mục hot update cũ → game chạy script 1.4.3 trên native 1.5.0 → crash hoặc lỗi lạ, chỉ hết khi gỡ cài đặt.
// Chạy sớm nhất có thể khi khởi động (main.js hoặc màn boot)
const STORE_VERSION = '1.5.0'; // phiên bản gói cài (lấy từ native/ cấu hình build)
const saved = localStorage.getItem('StoreVersion');
if (saved !== STORE_VERSION) {
native.fileUtils.removeDirectory(native.fileUtils.getWritablePath() + 'hotupdate/'); // xoá bản cập nhật cũ
localStorage.removeItem('HotUpdateSearchPaths');
localStorage.setItem('StoreVersion', STORE_VERSION);
// khởi động lại search path về mặc định của gói cài
}| Rủi ro | Biện pháp |
|---|---|
| Bản hot update lỗi làm crash khi khởi động | Cờ “đang khởi động” ghi trước khi nạp bản mới, xoá khi vào menu thành công; lần sau thấy cờ còn → quay về bản trước/ gói gốc |
| Tải dở, mất mạng | Tải vào thư mục tạm, chỉ đổi sang khi đủ và đúng md5; tiếp tục tải được |
| Manifest bị giả mạo/ CDN bị tấn công | HTTPS, ký manifest (chữ ký số kiểm tra bằng khoá công khai trong app), kiểm tra md5 từng file |
| Đẩy lỗi cho toàn bộ người chơi | Phát hành theo nhóm: remoteVersionUrl khác nhau theo % người chơi/ cohort, theo dõi crash rồi mở rộng |
| Bản hot update không tương thích native | Manifest ghi yêu cầu phiên bản native tối thiểu; app native cũ thì không áp dụng/ yêu cầu cập nhật store |
| CDN cache file cũ | Đường dẫn có version (thư mục 1.4.3/), cache-control hợp lý cho version.manifest |
🟢 Pipeline và phương án live-ops khác
| Nhu cầu live-ops | Công cụ phù hợp hơn hot update script |
|---|---|
| Đổi giá, phần thưởng, tần suất quảng cáo, bật/tắt tính năng | Remote config (Firebase Remote Config hoặc server riêng) |
| Thêm màn chơi, skin sự kiện | Asset Bundle từ xa (tải theo nhu cầu) + cấu hình |
| Thử nghiệm A/B | Remote config + analytics |
| Sửa lỗi logic nghiêm trọng | Hot update script (trong phạm vi chính sách) hoặc bản store khẩn |
🎤 Câu hỏi phỏng vấn thường gặp (trả lời to trước khi mở)
🎤 Thiết kế hệ thống hot update cho game Cocos Creator có 1 triệu người chơi.
🎤 Sau khi người chơi cập nhật từ store, game crash. Bạn nghi gì đầu tiên?
🎤 Thứ gì không thể hot update?
🎤 Làm sao rollback nếu bản hot update làm crash khi khởi động?
🎤 Hot update có vi phạm chính sách App Store không?
⚠️ Sai lầm thường mắc
Vì sao nguy hiểm: Crash hàng loạt sau cập nhật store.
Cách làm đúng: So phiên bản store, xoá thư mục cập nhật.
Vì sao nguy hiểm: Hỏng khi mất mạng giữa chừng.
Cách làm đúng: Tải tạm, kiểm tra, rồi mới đổi.
Vì sao nguy hiểm: Một lần đẩy lỗi làm hỏng game toàn bộ người chơi.
Cách làm đúng: Cờ khởi động + bản dự phòng.
Vì sao nguy hiểm: Lỗi lan toàn bộ.
Cách làm đúng: Phát hành theo nhóm, theo dõi crash.
Vì sao nguy hiểm: Bị chèn nội dung độc hại.
Cách làm đúng: HTTPS + chữ ký + md5.
Vì sao nguy hiểm: Rủi ro chính sách store.
Cách làm đúng: Bản store cho tính năng mới; remote config cho tham số.
- Script/ asset/ cấu hình cập nhật được; native, SDK, quyền thì không.
- version.manifest nhỏ → project.manifest → tải file khác md5 → search path → restart.
- Search path phải nạp trong main.js trước khi tải script.
- Xoá cache cập nhật khi đổi bản store; có rollback, ký manifest, phát hành theo nhóm.
- Remote config và bundle từ xa cho live-ops an toàn hơn.
🧩 Tự kiểm tra (bấm để xem đáp án)
1. Vì sao tách version.manifest nhỏ khỏi project.manifest?
A. Cho đẹp
B. Kiểm tra nhanh có bản mới mà không tải danh sách lớn
C. Bắt buộc của iOS
2. Search path trỏ thư mục cập nhật lên đầu nhằm:
A. File mới được ưu tiên đè file trong gói
B. Xoá gói cài
C. Tăng FPS
3. compareVersion('1.10.0','1.9.9'):
A. Âm
B. Dương
C. 0
4. Có thể hot update thư viện SDK quảng cáo native không?
A. Có
B. Không, cần bản store
C. Chỉ trên Android
5. Cờ “đang khởi động” chưa được xoá ở lần mở trước nghĩa là:
A. Bình thường
B. Bản cập nhật có thể làm crash, cần rollback
C. Mạng chậm
🏋️ Bài tập thực hành
Dựng hot update cho project Creator: script Node.js sinh manifest (duyệt thư mục build, tính md5/size), server tĩnh cục bộ làm CDN, màn boot có tiến độ, đổi một màu nút + một file cấu hình ở bản 1.0.1, kiểm tra cập nhật thành công; mô phỏng mất mạng giữa chừng; mô phỏng cài “bản store” mới và chứng minh cache cũ bị xoá; thêm rollback bằng cờ khởi động.
💡 Gợi ý lời giải
npx http-server ./remote -p 8080, điện thoại cùng mạng Wi-Fi truy cập IP máy tính (Android cần cho phép cleartext cho bản debug hoặc dùng HTTPS). Dùng công cụ so sánh manifest ở trên để kiểm tra danh sách file cần tải.📚 Tài nguyên học tập
- Cocos Creator 3.8 Manual: Hot UpdateMục Advanced Topics → Hot Update Tutorial/ AssetManagerTài liệu
- App Store Review Guidelines (2.5.2)Giới hạn tải codeChính sách
- Firebase Remote ConfigLive-ops bằng tham sốTài liệu
✅ Tự đánh giá hoàn thành
- Phân loại cập nhật được/ không được
- Vẽ luồng manifest
- Cài HotUpdate component
- Xử lý cache khi đổi bản store
- Thiết kế rollback + phát hành theo nhóm